Source code for woob.capabilities.bands

# Copyright(C) 2018 Quentin Defenouillere
#
# This file is part of woob.
#
# woob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# woob is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with woob. If not, see <http://www.gnu.org/licenses/>.

from .base import BaseObject, Capability, StringField, UserError


__all__ = [
    "BandInfo",
    "BandSearch",
    "Albums",
    "BandNotFound",
    "Suggestion",
    "Favorite",
    "CapBands",
]


[docs]class BandSearch(BaseObject): """ Bands search. """ name = StringField("Name of band") short_description = StringField("Short description of the band") def __init__(self, id="", name=None, short_description=None, url=None): super().__init__(id, url) self.name = name self.short_description = short_description
[docs]class BandNotFound(UserError): """ Raised when no band is found. """ pass
[docs]class BandInfo(BaseObject): """ Information about one specific band. """ name = StringField("Name of band") genre = StringField("Music genre of the band") year = StringField("Year of creation") country = StringField("Country of origin") description = StringField("Description of the band") def __init__(self, name=None, year=None, country=None, genre=None, description=None, url=None): super().__init__(id, url) self.name = name self.genre = genre self.year = year self.description = description self.country = country
[docs]class Albums(BaseObject): """ Information about one specific band. """ name = StringField("Album name") album_type = StringField("Type of album") year = StringField("Year of release") reviews = StringField("Album reviews") def __init__(self, name=None, album_type=None, year=None, reviews=None, url=None): super().__init__(id, url) self.name = name self.album_type = album_type self.year = year self.reviews = reviews
[docs]class Favorite(BaseObject): """ Fetch your favorite bands. """ name = StringField("Name of favorite band") band_url = StringField("URL of the favorite band") short_description = StringField("Short description of the favorite band") def __init__(self, id="", name=None, band_url=None, short_description=None): super().__init__(id, name) self.name = name self.band_url = band_url self.short_description = short_description
[docs]class Suggestion(BaseObject): """ Band suggestions based on your favorite bands. """ name = StringField("Name of suggested band") description = StringField("Band description") url = StringField("URL of suggested band") def __init__(self, id="", name=None, description=None, url=None): super().__init__(id, url) self.name = name self.url = url self.description = description
[docs]class CapBands(Capability): """ Capability to get band information on music websites. """
[docs] def get_info(self): """ Get band info. :param band_id: ID of the band :rtype: :class:`BandInfo` """ raise NotImplementedError()
[docs] def get_albums(self): """ Get a band's discography. :rtype: iter[:class:`Albums`] """ raise NotImplementedError()
[docs] def get_favorites(self): """ Get my favorite bands. :rtype: iter[:class:`Favorite`] """ raise NotImplementedError()
[docs] def suggestions(self): """ Get band suggestions according to your favorite bands. :rtype: iter[:class:`Suggestion`] """ raise NotImplementedError()