def get_works():
""" Get a list of Carnatic works in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing work information::
{"mbid": MusicBrainz work ID, "name": work name}
For additional information about each work use :func:`get_work`.
"""
return conn._get_paged_json("api/carnatic/work")
def get_instruments():
""" Get a list of Carnatic instruments in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing instrument information::
{"id": instrument id, "name": Name of the instrument}
For additional information about each instrument use :func:`get_instrument`
"""
return conn._get_paged_json("api/carnatic/instrument")
def get_taalas():
""" Get a list of Carnatic taalas in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing taala information::
{"uuid": taala UUID, "name": name of the taala}
For additional information about each taala use :func:`get_taala`.
"""
return conn._get_paged_json("api/carnatic/taala")
def get_works():
""" Get a list of Carnatic works in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing work information::
{"mbid": MusicBrainz work ID, "name": work name}
For additional information about each work use :func:`get_work`.
"""
return conn._get_paged_json("api/carnatic/work")
def get_taalas():
""" Get a list of Carnatic taalas in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing taala information::
{"uuid": taala UUID, "name": name of the taala}
For additional information about each taala use :func:`get_taala`.
"""
return conn._get_paged_json("api/carnatic/taala")
def get_instruments():
""" Get a list of Carnatic instruments in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing instrument information::
{"id": instrument id, "name": Name of the instrument}
For additional information about each instrument use :func:`get_instrument`
"""
return conn._get_paged_json("api/carnatic/instrument")
def get_concerts():
""" Get a list of Carnatic concerts in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing concert information::
{"mbid": MusicBrainz Release ID, "title": title of the concert}
For additional information about each concert use :func:`get_concert`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/carnatic/concert", extra_headers=extra_headers)
def get_raagas():
""" Get a list of Carnatic raagas in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing raaga information:
{"uuid": raaga uuid,
"name": name of the raaga
}
For additional information about each raaga use :func:`get_raaga`
"""
return conn._get_paged_json("api/carnatic/raaga")
def get_concerts():
""" Get a list of Carnatic concerts in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing concert information::
{"mbid": MusicBrainz Release ID, "title": title of the concert}
For additional information about each concert use :func:`get_concert`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/carnatic/concert",
extra_headers=extra_headers)
def get_artists():
""" Get a list of Carnatic artists in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing artist information::
{"mbid": MusicBrainz artist id, "name": Name of the artist}
For additional information about each artist use :func:`get_artist`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/carnatic/artist", extra_headers=extra_headers)
def get_releases():
""" Get a list of Jingju releases in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing release information::
{"mbid": Musicbrainz release id,
"title": title of the release
}
For additional information about each release use :func:`get_release`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/jingju/release", extra_headers=extra_headers)
def get_artists():
""" Get a list of Carnatic artists in the database.
This function will automatically page through API results.
:returns: A list of dictionaries containing artist information::
{"mbid": MusicBrainz artist id, "name": Name of the artist}
For additional information about each artist use :func:`get_artist`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/carnatic/artist",
extra_headers=extra_headers)
def get_recordings():
""" Get a list of carnatic recordings in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing recording information::
{"mbid": Musicbrainz recording id,
"title": Title of the recording
}
For additional information about each recording use :func:`get_recording`.
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/carnatic/recording",
extra_headers=extra_headers)
def get_releases():
""" Get a list of Jingju releases in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing release information::
{"mbid": Musicbrainz release id,
"title": title of the release
}
For additional information about each release use :func:`get_release`
"""
extra_headers = _get_collections()
return conn._get_paged_json("api/jingju/release",
extra_headers=extra_headers)
def get_recordings(recording_detail=False):
""" Get a list of carnatic recordings in the database.
This function will automatically page through API results.
:param recording_detail: if True, return full details for each recording like :func:`get_recording`
:returns: A list of dictionaries containing recording information::
{"mbid": MusicBrainz recording ID, "title": Title of the recording}
For additional information about each recording use :func:`get_recording`.
"""
extra_headers = _get_collections()
args = {}
if recording_detail:
args['detail'] = '1'
return conn._get_paged_json("api/carnatic/recording", extra_headers=extra_headers, **args)
def get_artists(artist_detail=False):
""" Get a list of Jingju artists in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing artist information::
{"mbid": Musicbrainz artist id,
"name": Name of the artist}
For additional information about each artist use :func:`get_artist`
"""
extra_headers = _get_collections()
args = {}
if artist_detail:
args['detail'] = '1'
return conn._get_paged_json("api/jingju/artist", extra_headers=extra_headers, **args)
def get_recordings(recording_detail=False):
""" Get a list of carnatic recordings in the database.
This function will automatically page through API results.
:param recording_detail: if True, return full details for each recording like :func:`get_recording`
:returns: A list of dictionaries containing recording information::
{"mbid": MusicBrainz recording ID, "title": Title of the recording}
For additional information about each recording use :func:`get_recording`.
"""
extra_headers = _get_collections()
args = {}
if recording_detail:
args['detail'] = '1'
return conn._get_paged_json("api/carnatic/recording",
extra_headers=extra_headers,
**args)
def get_artists(artist_detail=False):
""" Get a list of Jingju artists in the database.
This function will automatically page through API results.
returns: A list of dictionaries containing artist information::
{"mbid": Musicbrainz artist id,
"name": Name of the artist}
For additional information about each artist use :func:`get_artist`
"""
extra_headers = _get_collections()
args = {}
if artist_detail:
args['detail'] = '1'
return conn._get_paged_json("api/jingju/artist",
extra_headers=extra_headers,
**args)
