def get_form(fid):
""" Get specific information about a form.
:param fid: A form id or uuid
:returns: uuid, name, works.
"""
return conn._dunya_query_json("api/makam/form/%s" % str(fid))
def get_collection(slug):
"""Get the documents (recordings) in a collection.
Arguments:
slug: the name of the collection
"""
path = "document/%s" % slug
return conn._dunya_query_json(path)
def get_work(wmbid):
""" Get specific information about a work.
Arguments:
wmbid: A work mbid
Returns: mbid, title, composer, raagas, taalas, recordings
"""
return conn._dunya_query_json("api/carnatic/work/%s" % wmbid)
def get_form(fid):
""" Get specific information about a form.
:param fid: A form id or uuid
:returns: uuid, name, works.
"""
return conn._dunya_query_json("api/makam/form/%s" % str(fid))
def get_work(wmbid):
""" Get specific information about a work.
:param wmbid: A work mbid
:returns: mbid, title, composer, raagas, taalas, recordings
"""
return conn._dunya_query_json("api/makam/work/%s" % wmbid)
def get_laya(lid):
""" Get specific information about a laya.
:param lid: A laya id or uuid
:returns: id, name, recordings
"""
return conn._dunya_query_json("api/hindustani/laya/%s" % str(lid))
def get_work(wmbid):
""" Get specific information about a work.
:param wmbid: A work mbid
:returns: mbid, title, composers, makams, forms, usuls, recordings
"""
return conn._dunya_query_json("api/makam/work/%s" % wmbid)
def get_laya(lid):
""" Get specific information about a laya.
:param lid: A laya id or uuid
:returns: id, name, recordings
"""
return conn._dunya_query_json("api/hindustani/laya/%s" % str(lid))
def get_taal(tid):
""" Get specific information about a taal.
:param tid: A taal id or uuid
:returns: uuid, name, recordings, composers
"""
return conn._dunya_query_json("api/hindustani/taal/%s" % str(tid))
def get_collection(slug):
"""Get the documents (recordings) in a collection.
:param slug: the name of the collection
"""
path = "document/%s" % slug
return conn._dunya_query_json(path)
def get_taal(tid):
""" Get specific information about a taal.
:param tid: A taal id or uuid
:returns: uuid, name, recordings, composers
"""
return conn._dunya_query_json("api/hindustani/taal/%s" % str(tid))
def get_makam(mid):
""" Get specific information about a makam.
:param mid: A makam id or uuid
:returns: uuid, name, works, taksims, gazels.
the ``taksims`` and ``gazels`` lists are of recordings.
"""
return conn._dunya_query_json("api/makam/makam/%s" % str(mid))
def get_work(wmbid):
""" Get specific information about a work.
:param wmbid: A work mbid
:returns: mbid, title, composers, raagas, taalas, recordings
"""
return conn._dunya_query_json("api/carnatic/work/%s" % (wmbid))
extra_headers = _get_collections()
def get_work(wmbid):
""" Get specific information about a work.
:param wmbid: A work mbid
:returns: mbid, title, recordings
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/work/%s" % wmbid, extra_headers=extra_headers)
def get_makam(mid):
""" Get specific information about a makam.
:param mid: A makam id or uuid
:returns: uuid, name, works, taksims, gazels.
the ``taksims`` and ``gazels`` lists are of recordings.
"""
return conn._dunya_query_json("api/makam/makam/%s" % str(mid))
def get_recording(rmbid):
""" Get specific information about a recording.
Arguments:
rmbid: A recording mbid
Returns: mbid, title, artists, raaga, taala, work
artists includes performance relationships attached
to the recording, the release, and the release artists.
"""
return conn._dunya_query_json("api/carnatic/recording/%s" % rmbid)
def document(recordingid):
"""Get the available source filetypes for a Musicbrainz recording
Arguments:
recordingid: Musicbrainz recording ID
Returns:
a list of filetypes in the database for this recording"""
path = "document/by-id/%s" % recordingid
recording = conn._dunya_query_json(path)
return recording
def get_instrument(iid):
""" Get specific information about an instrument.
Arguments:
iid: An instrument id
Returns: id, name, artists
artists includes artists with recording- and release-
level performance relationships of this instrument.
"""
return conn._dunya_query_json("api/carnatic/instrument/%s" % str(iid))
def get_concert(cmbid):
""" Get specific information about a concert.
Arguments:
cmbid: A concert mbid
Returns: mbid, title, artists, tracks
artists includes performance relationships attached
to the recordings, the release, and the release artists.
"""
return conn._dunya_query_json("api/carnatic/concert/%s" % cmbid)
def get_taala(tid):
""" Get specific information about a taala.
Arguments:
tid: A taala id
Returns: id, name, artists, works, composers
artists includes artists with recording- and release-
level relationships to a recording with this raaga
"""
return conn._dunya_query_json("api/carnatic/taala/%s" % str(tid))
def get_artist(ambid):
""" Get specific information about an artist.
Arguments:
ambid: An artist mbid
Returns: mbid, name, concerts, instruments, recordings
concerts, instruments and recordings include information
from recording- and release-level relationships, as
well as release artists
"""
return conn._dunya_query_json("api/carnatic/artist/%s" % ambid)
def get_symbtr(uuid):
""" Get a symbtr file info from id
This function will automatically page through API results.
:param uuid: A symbtr id
returns: name and id of the symbtr file
"""
return conn._dunya_query_json("api/makam/symbtr/%s" % uuid)
def get_work(wmbid):
""" Get specific information about a work.
:param wmbid: A work mbid
:returns: mbid, title, recordings
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/work/%s" % wmbid,
extra_headers=extra_headers)
def get_usul(uid):
""" Get specific information about a usul.
:param uid: An usul id or uuid
:returns: uuid, name, works, taksims, gazels.
the ``taksims`` and ``gazels`` lists are of recordings. They are
only valid for the usul ``serbest``
"""
return conn._dunya_query_json("api/makam/usul/%s" % str(uid))
def get_usul(uid):
""" Get specific information about a usul.
:param uid: An usul id or uuid
:returns: uuid, name, works, taksims, gazels.
the ``taksims`` and ``gazels`` lists are of recordings. They are
only valid for the usul ``serbest``
"""
return conn._dunya_query_json("api/makam/usul/%s" % str(uid))
def document(recordingid):
"""Get the available source filetypes for a Musicbrainz recording.
:param recordingid: Musicbrainz recording ID
:returns: a list of filetypes in the database for this recording
"""
path = "document/by-id/%s" % recordingid
recording = conn._dunya_query_json(path)
return recording
def get_symbtr(uuid):
""" Get a symbtr file info from id
This function will automatically page through API results.
:param uuid: A symbtr id
returns: name and id of the symbtr file
"""
return conn._dunya_query_json("api/makam/symbtr/%s" % uuid)
def get_form(fid):
""" Get specific information about a form.
:param fid: A form id or uuid
:returns: uuid, name, artists, recordings.
``artists`` includes artists with recording- and release-
level relationships to a recording with this form
"""
return conn._dunya_query_json("api/hindustani/form/%s" % str(fid))
def get_instrument(iid):
""" Get specific information about an instrument.
:param iid: An instrument id
:returns: id, name, artists.
``artists`` includes artists with recording- and release-
level performance relationships of this instrument.
"""
return conn._dunya_query_json("api/makam/instrument/%s" % str(iid))
def get_composer(cmbid):
""" Get specific information about an composer.
:param cmbid: A composer mbid
:returns: mbid, name, works, lyric_works
``works`` contains a list of works that the composer has written.
``lyric_works`` are works where they were lyricist.
"""
return conn._dunya_query_json("api/makam/composer/%s" % cmbid)
def get_release(cmbid):
""" Get specific information about a release.
:param cmbid: A release mbid
:returns: mbid, title, artists, tracks.
``artists`` includes performance relationships attached
to the recordings, the release, and the release artists.
"""
return conn._dunya_query_json("api/makam/release/%s" % cmbid)
def get_raag(rid):
""" Get specific information about a raag.
Arguments:
:param rid: A raag id or uuid
:returns: uuid, name, artists, recordings, composers
``artists`` includes artists with recording-level
relationships to a recording with this raag
"""
return conn._dunya_query_json("api/hindustani/raag/%s" % str(rid))
def get_form(fid):
""" Get specific information about a form.
:param fid: A form id or uuid
:returns: uuid, name, artists, recordings.
``artists`` includes artists with recording- and release-
level relationships to a recording with this form
"""
return conn._dunya_query_json("api/hindustani/form/%s" % str(fid))
def get_raag(rid):
""" Get specific information about a raag.
Arguments:
:param rid: A raag id or uuid
:returns: uuid, name, artists, recordings, composers
``artists`` includes artists with recording-level
relationships to a recording with this raag
"""
return conn._dunya_query_json("api/hindustani/raag/%s" % str(rid))
def get_instrument(iid):
""" Get specific information about an instrument.
:param iid: An instrument id
:returns: id, name, artists.
``artists`` includes artists with recording- and release-
level performance relationships of this instrument.
"""
return conn._dunya_query_json("api/makam/instrument/%s" % str(iid))
def get_release(cmbid):
""" Get specific information about a release.
:param cmbid: A release mbid
:returns: mbid, title, artists, tracks.
``artists`` includes performance relationships attached
to the recordings, the release, and the release artists.
"""
return conn._dunya_query_json("api/makam/release/%s" % cmbid)
def get_taala(tid):
""" Get specific information about a taala.
:param tid: A taala id or uuid
:returns: uuid, name, artists, works, composers.
``artists`` includes artists with recording- and release-
level relationships to a recording with this raaga
"""
return conn._dunya_query_json("api/carnatic/taala/%s" % str(tid))
def get_composer(cmbid):
""" Get specific information about an composer.
:param cmbid: A composer mbid
:returns: mbid, name, works, lyric_works
``works`` contains a list of works that the composer has written.
``lyric_works`` are works where they were lyricist.
"""
return conn._dunya_query_json("api/makam/composer/%s" % cmbid)
def get_recording(rmbid):
""" Get specific information about a recording.
:param rmbid: A recording mbid
:returns: mbid, title, artists, raaga, taala, work.
``artists`` includes performance relationships
attached to the recording, the release, and the release artists.
"""
return conn._dunya_query_json("api/makam/recording/%s" % rmbid)
def get_release(cmbid):
""" Get specific information about a release.
:param cmbid: A release mbid
:returns: mbid, title, artists, tracks, release artists
``artists`` includes performance relationships attached
to the recordings, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/release/%s" % cmbid, extra_headers=extra_headers)
def get_artist(ambid):
""" Get specific information about an artist.
:param ambid: An artist mbid
:returns: mbid, name, releases, instruments.
``releases``, ``instruments`` and ``recordings`` include
information from recording- and release-level
relationships, as well as release artists
"""
return conn._dunya_query_json("api/makam/artist/%s" % ambid)
def get_recording(rmbid):
""" Get specific information about a recording.
:param rmbid: A recording mbid
:returns: mbid, title, releases, performers, work.
``artists`` includes performance relationships
attached to the recording, the release, and the release artists.
"""
return conn._dunya_query_json("api/makam/recording/%s" % rmbid)
def get_raaga(rid):
""" Get specific information about a raaga.
:param rid: A raaga id or uuid
:returns: uuid, name, artists, works, composers.
``artists`` includes artists with recording- and release-
level relationships to a recording with this raaga
"""
return conn._dunya_query_json("api/carnatic/raaga/%s" % str(rid))
def get_artist(ambid):
""" Get specific information about an artist.
:param ambid: An artist mbid
:returns: mbid, name, releases, instruments, recordings.
``releases``, ``instruments`` and ``recordings`` include
information from recording- and release-level
relationships, as well as release artists
"""
return conn._dunya_query_json("api/makam/artist/%s" % ambid)
def get_concert(cmbid):
""" Get specific information about a concert.
:param cmbid: A concert mbid
:returns: mbid, title, artists, tracks.
``artists`` includes performance relationships attached
to the recordings, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/carnatic/concert/%s" % cmbid,
extra_headers=extra_headers)
def get_release(cmbid):
""" Get specific information about a release.
:param cmbid: A release mbid
:returns: mbid, title, artists, tracks, release artists
``artists`` includes performance relationships attached
to the recordings, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/release/%s" % cmbid,
extra_headers=extra_headers)
def get_work(wmbid, with_bootlegs=False):
""" Get specific information about a work.
:param wmbid: A work mbid
:param with_bootlegs: If True and you are authenticated as a staff user
include bootleg recordings in the returned data
:returns: mbid, title, composers, raagas, taalas, recordings
"""
if with_bootlegs:
bootleg = "?with_bootlegs=True"
else:
bootleg = ""
return conn._dunya_query_json("api/carnatic/work/%s%s" % (wmbid, bootleg))
def get_recording(rmbid):
""" Get specific information about a recording.
Arguments:
:param rmbid: A recording mbid
:returns: mbid, title, artists, raags, taals, layas, forms and works.
``artists`` include performance relationships attached
to the recording, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/recording/%s" % rmbid, extra_headers=extra_headers)
def get_recording(rmbid):
""" Get specific information about a recording.
:param rmbid: A recording mbid
:returns: mbid, title, artists, raaga, taala, work.
``artists`` includes performance relationships
attached to the recording, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/carnatic/recording/%s" % rmbid,
extra_headers=extra_headers)
def get_artist(ambid):
""" Get specific information about an artist.
Arguments:
:param ambid: An artist mbid
:returns: mbid, name, releases, instruments, recordings
``releases``, ``instruments`` and ``recordings`` include
information from recording- and release-level
relationships, as well as release artists
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/artist/%s" % ambid, extra_headers=extra_headers)
def get_artist(ambid):
""" Get specific information about an artist.
:param ambid: An artist mbid
:returns: mbid, name, concerts, instruments, recordings.
``concerts``, ``instruments`` and ``recordings`` include
information from recording- and release-level
relationships, as well as release artists
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/carnatic/artist/%s" % (ambid),
extra_headers=extra_headers)
def get_recording(rmbid):
""" Get specific information about a recording.
Arguments:
:param rmbid: A recording mbid
:returns: mbid, title, artists, raags, taals, layas, forms and works.
``artists`` include performance relationships attached
to the recording, the release, and the release artists.
"""
extra_headers = _get_collections()
return conn._dunya_query_json("api/hindustani/recording/%s" % rmbid,
extra_headers=extra_headers)
def get_artist(ambid, with_bootlegs=False):
""" Get specific information about an artist.
:param ambid: An artist mbid
:param with_bootlegs: If True and you are authenticated as a staff user
include bootleg concerts and recordings in the returned data
:returns: mbid, name, concerts, instruments, recordings.
``concerts``, ``instruments`` and ``recordings`` include
information from recording- and release-level
relationships, as well as release artists
"""
if with_bootlegs:
bootleg = "?with_bootlegs=True"
else:
bootleg = ""
return conn._dunya_query_json("api/carnatic/artist/%s%s" % (ambid, bootleg))