from .cards_object import CardsObject import urllib.parse class Search(CardsObject): """ cards/search Uses a search query to gather relevant data. Positional arguments: q : str ...... The query to search. This will be updated in the future. Optional arguments: order : str ................... The order you'd like the data returned. unique : str ........................... A way to filter similar cards. dir : str ......... The direction you'd like to sort. (asc, desc, auto) include_extras : bool ... Includes cards that are normally omitted from search results, like Un-sets. page : int .............. The page number you'd like to search, if any. Inherits all arguments from CardsObject. Attributes: object : str ....................... Returns what kind of object it is. total_cards : int ......... How many cards are returned from the query. data : list ...................... The list of potential autocompletes. has_more : bool ......... True if there is more than 1 page of results. next_page : str ............ The API URI to the next page of the query. Example usage: >>> search = scrython.cards.Search(q="++e:A25", order="spoiled") >>> search.data() """ def __init__(self, **kwargs): if kwargs.get('q') is None: raise TypeError('No query is specified.') self.dict = { 'q':kwargs.get('q'), 'order':kwargs.get('order', 'none'), 'unique':kwargs.get('unique', 'none'), 'dir':kwargs.get('dir', 'none'), 'include_extras':kwargs.get('include_extras', 'false'), 'page':kwargs.get('page', '1') } self.args = urllib.parse.urlencode(self.dict) self.url = 'cards/search?' + self.args super(Search, self).__init__(self.url) def __checkForKey(self, key): try: return self.scryfallJson[key] except KeyError: return None def object(self): if self.__checkForKey('object') is None: raise KeyError('This object has no key \'object\'') return self.scryfallJson['object'] def total_cards(self): if self.__checkForKey('total_cards') is None: raise KeyError('This object has no key \'total_cards\'') return self.scryfallJson['total_cards'] def data(self): if self.__checkForKey('data') is None: raise KeyError('This object has no key \'data\'') return self.scryfallJson['data'] def next_page(self): if self.__checkForKey('next_page') is None: raise KeyError('This object has no key \'next_page\'') return self.scryfallJson['next_page'] def warnings(self): if self.__checkForKey('warnings') is None: raise KeyError('This object has no key \'warnings\'') return self.scryfallJson['warnings'] #The following attributes are only to override the inherited class attributes. #This class has no matching attributes but we still need the getRequest function from CardsObject def id(self): raise AttributeError('Search object has no attribute \'id\'') def multiverse_ids(self): raise AttributeError('Search object has no attribute \'multiverse_ids\'') def mtgo_id(self): raise AttributeError('Search object has no attribute \'mtgo_id\'') def mtgo_foil_id(self): raise AttributeError('Search object has no attribute \'mtgo_foil_id\'') def name(self): raise AttributeError('Search object has no attribute \'name\'') def uri(self): raise AttributeError('Search object has no attribute \'uri\'') def scryfall_uri(self): raise AttributeError('Search object has no attribute \'scryfall_uri\'') def layout(self): raise AttributeError('Search object has no attribute \'layout\'') def highres_image(self): raise AttributeError('Search object has no attribute \'highres_image\'') def image_uris(self): raise AttributeError('Search object has no attribute \'image_uris\'') def cmc(self): raise AttributeError('Search object has no attribute \'cmc\'') def type_line(self): raise AttributeError('Search object has no attribute \'type_line\'') def oracle_text(self): raise AttributeError('Search object has no attribute \'oracle_text\'') def mana_cost(self): raise AttributeError('Search object has no attribute \'mana_cost\'') def colors(self): raise AttributeError('Search object has no attribute \'colors\'') def color_identity(self): raise AttributeError('Search object has no attribute \'color_identity\'') def legalities(self): raise AttributeError('Search object has no attribute \'legalities\'') def reserved(self): raise AttributeError('Search object has no attribute \'reserved\'') def reprint(self): raise AttributeError('Search object has no attribute \'reprint\'') def set_code(self): raise AttributeError('Search object has no attribute \' def set_code\'') def set_name(self): raise AttributeError('Search object has no attribute \' def set_name\'') def set_uri(self): raise AttributeError('Search object has no attribute \'set_uri\'') def set_search_uri(self): raise AttributeError('Search object has no attribute \'set_search_uri\'') def scryfall_set_uri(self): raise AttributeError('Search object has no attribute \'scryfall_set_uri\'') def rulings_uri(self): raise AttributeError('Search object has no attribute \'rulings_uri\'') def prints_search_uri(self): raise AttributeError('Search object has no attribute \'prints_search_uri\'') def collector_number(self): raise AttributeError('Search object has no attribute \'collector_number\'') def digital(self): raise AttributeError('Search object has no attribute \'digital\'') def rarity(self): raise AttributeError('Search object has no attribute \'rarity\'') def illustration_id(self): raise AttributeError('Search object has no attribute \'illustration_id\'') def artist(self): raise AttributeError('Search object has no attribute \'artist\'') def frame(self): raise AttributeError('Search object has no attribute \'frame\'') def full_art(self): raise AttributeError('Search object has no attribute \'full_art\'') def border_color(self): raise AttributeError('Search object has no attribute \'border_color\'') def timeshifted(self): raise AttributeError('Search object has no attribute \'timeshifted\'') def colorshifted(self): raise AttributeError('Search object has no attribute \'colorshifted\'') def futureshifted(self): raise AttributeError('Search object has no attribute \'futureshifted\'') def edhrec_rank(self): raise AttributeError('Search object has no attribute \'edhrec_rank\'') def currency(self, mode): raise AttributeError('Search object has no attribute \'currency(self,\'') def related_uris(self): raise AttributeError('Search object has no attribute \'related_uris\'') def purchase_uris(self): raise AttributeError('Search object has no attribute \'purchase_uris\'') def life_modifier(self): raise AttributeError('Search object has no attribute \'life_modifier\'') def hand_modifier(self): raise AttributeError('Search object has no attribute \'hand_modifier\'') def color_indicator(self): raise AttributeError('Search object has no attribute \'color_indicator\'') def all_parts(self): raise AttributeError('Search object has no attribute \'all_parts\'') def card_faces(self): raise AttributeError('Search object has no attribute \'card_faces\'') def watermark(self): raise AttributeError('Search object has no attribute \'watermark\'') def story_spotlight_number(self): raise AttributeError('Search object has no attribute \'story_spotlight_number\'') def story_spotlight_uri(self): raise AttributeError('Search object has no attribute \'story_spotlight_uri\'')