791 lines
22 KiB
Python
791 lines
22 KiB
Python
import sys
|
||
sys.path.append('..')
|
||
from scrython.foundation import FoundationObject
|
||
import aiohttp
|
||
import asyncio
|
||
import urllib.parse
|
||
from threading import Thread
|
||
|
||
class CardsObject(FoundationObject):
|
||
"""
|
||
Master class that all card objects inherit from.
|
||
|
||
Args:
|
||
format (string, optional):
|
||
Defaults to 'json'.
|
||
Returns data in the specified method.
|
||
face (string, optional):
|
||
Defaults to empty string.
|
||
If you're using the `image` format, this will specify if you want the front or back face.
|
||
version (string, optional):
|
||
Defaults to empty string.
|
||
If you're using the `image` format, this will specify if you want the small, normal,
|
||
large, etc version of the image.
|
||
pretty (string, optional):
|
||
Defaults to empty string.
|
||
Returns a prettier version of the json object.
|
||
Note that this may break functionality with Scrython.
|
||
|
||
Raises:
|
||
Exception: If the object returned is an error.
|
||
"""
|
||
|
||
def object(self):
|
||
"""Returns the type of object it is
|
||
(card, error, etc)
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('object')
|
||
|
||
return self.scryfallJson['object']
|
||
|
||
def id(self):
|
||
"""A unique ID for the returned card object
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('id')
|
||
|
||
return self.scryfallJson['id']
|
||
|
||
def multiverse_ids(self):
|
||
"""The official Gatherer multiverse ids of the card
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
super(CardsObject, self)._checkForKey('multiverse_ids')
|
||
|
||
return self.scryfallJson['multiverse_ids']
|
||
|
||
def mtgo_id(self):
|
||
"""The official MTGO id of the of the card
|
||
|
||
Returns:
|
||
integer: The Magic Online id of the card
|
||
"""
|
||
super(CardsObject, self)._checkForKey('mtgo_id')
|
||
|
||
return self.scryfallJson['mtgo_id']
|
||
|
||
def mtgo_foil_id(self):
|
||
"""The corresponding MTGO foil ID of the card
|
||
|
||
Returns:
|
||
integer: The Magic Online foil id of the card
|
||
"""
|
||
super(CardsObject, self)._checkForKey('mtgo_foil_id')
|
||
|
||
return self.scryfallJson['mtgo_foil_id']
|
||
|
||
def tcgplayer_id(self):
|
||
"""The `productId` of the card on TCGplayer.
|
||
|
||
Returns:
|
||
integer: The TCGplayer id of the card
|
||
"""
|
||
super(CardsObject, self)._checkForKey('tcgplayer_id')
|
||
|
||
return self.scryfallJson['tcgplayer_id']
|
||
|
||
def tcgplayer_etched_id(self):
|
||
"""The `etched_id` of the card on TCGplayer.
|
||
|
||
Returns:
|
||
integer: The TCGplayer etched id of the card
|
||
"""
|
||
super(CardsObject, self)._checkForKey('tcgplayer_etched_id')
|
||
|
||
return self.scryfallJson['tcgplayer_etched_id']
|
||
|
||
def name(self):
|
||
"""The oracle name of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('name')
|
||
|
||
return self.scryfallJson['name']
|
||
|
||
def uri(self):
|
||
"""The Scryfall API uri for the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('uri')
|
||
|
||
return self.scryfallJson['uri']
|
||
|
||
def scryfall_uri(self):
|
||
"""The full Scryfall page of the card
|
||
As if it was a URL from the site.
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('scryfall_uri')
|
||
|
||
return self.scryfallJson['scryfall_uri']
|
||
|
||
def layout(self):
|
||
"""The image layout of the card. (normal, transform, etc)
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('layout')
|
||
|
||
return self.scryfallJson['layout']
|
||
|
||
def highres_image(self):
|
||
"""Determine if a card has a highres scan available
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('highres_image')
|
||
|
||
return self.scryfallJson['highres_image']
|
||
|
||
def image_uris(self, index=0, image_type=None):
|
||
"""All image uris of the card in various qualities
|
||
|
||
An index and an image type must be supplied a single uri.
|
||
|
||
If the card has additional faces, the returned dict will
|
||
default to the front of the card.
|
||
|
||
Returns:
|
||
dict: If given no arguments
|
||
string: If given an index and image_type
|
||
|
||
Raises:
|
||
Exception: If given no index
|
||
KeyError: If the given image type is not a known type
|
||
"""
|
||
|
||
layouts = {
|
||
'normal': lambda num: self.scryfallJson['image_uris'],
|
||
'split': lambda num: self.scryfallJson['image_uris'],
|
||
'flip': lambda num: self.scryfallJson['image_uris'],
|
||
'transform': lambda num: self.scryfallJson['card_faces'][num]['image_uris'],
|
||
'meld': lambda num: self.scryfallJson['image_uris'],
|
||
'leveler': lambda num: self.scryfallJson['image_uris'],
|
||
'saga': lambda num: self.scryfallJson['image_uris'],
|
||
'class': lambda num: self.scryfallJson['image_uris'],
|
||
'planar': lambda num: self.scryfallJson['image_uris'],
|
||
'scheme': lambda num: self.scryfallJson['image_uris'],
|
||
'vanguard': lambda num: self.scryfallJson['image_uris'],
|
||
'token': lambda num: self.scryfallJson['image_uris'],
|
||
'double_faced_token': lambda num: self.scryfallJson['card_faces'][num]['image_uris'],
|
||
'emblem': lambda num: self.scryfallJson['image_uris'],
|
||
'augment': lambda num: self.scryfallJson['image_uris'],
|
||
'host': lambda num: self.scryfallJson['image_uris'],
|
||
'adventure': lambda num: self.scryfallJson['image_uris'],
|
||
'modal_dfc': lambda num: self.scryfallJson['card_faces'][num]['image_uris']
|
||
}
|
||
|
||
image_types = {
|
||
'small': lambda d: d['small'],
|
||
'normal': lambda d: d['normal'],
|
||
'large': lambda d: d['large'],
|
||
'png': lambda d: d['png'],
|
||
'art_crop': lambda d: d['art_crop'],
|
||
'border_crop': lambda d: d['border_crop']
|
||
}
|
||
|
||
images_dict = layouts.get(self.scryfallJson['layout'])
|
||
|
||
uri = image_types.get(image_type)
|
||
|
||
if index == 0 and image_type is None:
|
||
return images_dict(0)
|
||
elif not isinstance(index, int):
|
||
raise Exception('You must supply an index to get a uri')
|
||
elif image_type not in list(image_types.keys()):
|
||
raise KeyError('Image type not in known types')
|
||
|
||
return uri(images_dict(index))
|
||
|
||
def cmc(self):
|
||
"""A float of the converted mana cost of the card
|
||
|
||
Returns:
|
||
float: The cmc of the card
|
||
"""
|
||
super(CardsObject, self)._checkForKey('cmc')
|
||
|
||
return self.scryfallJson['cmc']
|
||
|
||
def type_line(self):
|
||
"""The full type line of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('type_line')
|
||
|
||
return self.scryfallJson['type_line']
|
||
|
||
def oracle_text(self):
|
||
"""The official oracle text of a card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('oracle_text')
|
||
|
||
return self.scryfallJson['oracle_text']
|
||
|
||
def mana_cost(self):
|
||
"""The full mana cost using shorthanded mana symbols
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('mana_cost')
|
||
|
||
return self.scryfallJson['mana_cost']
|
||
|
||
def colors(self):
|
||
"""A list of strings with all colors found in the mana cost
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
super(CardsObject, self)._checkForKey('colors')
|
||
|
||
return self.scryfallJson['colors']
|
||
|
||
def color_identity(self):
|
||
"""A list of strings with all colors found on the card itself
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
super(CardsObject, self)._checkForKey('color_identity')
|
||
|
||
return self.scryfallJson['color_identity']
|
||
|
||
def legalities(self):
|
||
"""A dictionary of all formats and their legality
|
||
|
||
Returns:
|
||
dict
|
||
"""
|
||
super(CardsObject, self)._checkForKey('legalities')
|
||
|
||
return self.scryfallJson['legalities']
|
||
|
||
def reserved(self):
|
||
"""Returns True if the card is on the reserved list
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('reserved')
|
||
|
||
return self.scryfallJson['reserved']
|
||
|
||
def reprint(self):
|
||
"""Returns True if the card has been reprinted before
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('reprint')
|
||
|
||
return self.scryfallJson['reprint']
|
||
|
||
def set_code(self):
|
||
"""The 3 letter code for the set of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('set')
|
||
|
||
return self.scryfallJson['set']
|
||
|
||
def set_name(self):
|
||
"""The full name for the set of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('set_name')
|
||
|
||
return self.scryfallJson['set_name']
|
||
|
||
def set_uri(self):
|
||
"""The API uri for the full set list of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('set_uri')
|
||
|
||
return self.scryfallJson['set_uri']
|
||
|
||
def set_search_uri(self):
|
||
"""Same output as set_uri
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('set_search_uri')
|
||
|
||
return self.scryfallJson['set_search_uri']
|
||
|
||
def scryfall_set_uri(self):
|
||
"""The full link to the set on Scryfall
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('scryfall_set_uri')
|
||
|
||
return self.scryfallJson['scryfall_set_uri']
|
||
|
||
def rulings_uri(self):
|
||
"""The API uri for the rulings of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('rulings_uri')
|
||
|
||
return self.scryfallJson['rulings_uri']
|
||
|
||
def prints_search_uri(self):
|
||
"""A link to where you can begin paginating all re/prints for this card on Scryfall’s API
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('prints_search_uri')
|
||
|
||
return self.scryfallJson['prints_search_uri']
|
||
|
||
def collector_number(self):
|
||
"""The collector number of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('collector_number')
|
||
|
||
return self.scryfallJson['collector_number']
|
||
|
||
def digital(self):
|
||
"""Returns True if the card is the digital version
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('digital')
|
||
|
||
return self.scryfallJson['digital']
|
||
|
||
def rarity(self):
|
||
"""The rarity of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('rarity')
|
||
|
||
return self.scryfallJson['rarity']
|
||
|
||
def illustration_id(self):
|
||
"""The related id of the card art
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('illustration_id')
|
||
|
||
return self.scryfallJson['illustration_id']
|
||
|
||
def artist(self):
|
||
"""The artist of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('artist')
|
||
|
||
return self.scryfallJson['artist']
|
||
|
||
def frame(self):
|
||
"""The year of the card frame
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('frame')
|
||
|
||
return self.scryfallJson['frame']
|
||
|
||
def frame_effects(self):
|
||
"""The card's frame effect, if any. (miracle, nyxtouched, etc.)
|
||
|
||
Returns:
|
||
list: The card's frame effects.
|
||
"""
|
||
super(CardsObject, self)._checkForKey('frame_effects')
|
||
|
||
return self.scryfallJson['frame_effects']
|
||
|
||
def full_art(self):
|
||
"""Returns True if the card is considered full art
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('full_art')
|
||
|
||
return self.scryfallJson['full_art']
|
||
|
||
def border_color(self):
|
||
"""The color of the card border
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('border_color')
|
||
|
||
return self.scryfallJson['border_color']
|
||
|
||
def edhrec_rank(self):
|
||
"""The rank of the card on edhrec.com
|
||
|
||
Returns:
|
||
int: The rank of the card on edhrec.co
|
||
"""
|
||
super(CardsObject, self)._checkForKey('edhrec_rank')
|
||
|
||
return self.scryfallJson['edhrec_rank']
|
||
|
||
def prices(self, mode):
|
||
"""Returns prices from modes `usd`, `usd_foil`, `usd_etched`, `usd_glossy`, `eur`, and `tix`
|
||
|
||
Args:
|
||
mode (string): The prices to get
|
||
|
||
Raises:
|
||
KeyError: If the mode parameter does not match a known key
|
||
|
||
Returns:
|
||
float: The prices as a float
|
||
"""
|
||
modes = ['usd', 'usd_foil', 'usd_etched', 'usd_glossy', 'eur', 'tix']
|
||
if mode not in modes:
|
||
raise KeyError("{} is not a key.".format(mode))
|
||
|
||
super(CardsObject, self)._checkForKey('prices', mode)
|
||
|
||
return self.scryfallJson['prices'][mode]
|
||
|
||
def related_uris(self):
|
||
"""A dictionary of related websites for this card
|
||
|
||
Returns:
|
||
dict
|
||
"""
|
||
super(CardsObject, self)._checkForKey('related_uris')
|
||
|
||
return self.scryfallJson['related_uris']
|
||
|
||
def purchase_uris(self):
|
||
"""A dictionary of links to purchase the card
|
||
|
||
Returns:
|
||
dict
|
||
"""
|
||
super(CardsObject, self)._checkForKey('purchase_uris')
|
||
|
||
return self.scryfallJson['purchase_uris']
|
||
|
||
def life_modifier(self):
|
||
"""This is the cards life modifier value, assuming it's a Vanguard card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('life_modifier')
|
||
|
||
return self.scryfallJson['life_modifier']
|
||
|
||
def hand_modifier(self):
|
||
"""This cards hand modifier value, assuming it's a Vanguard card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('hand_modifier')
|
||
|
||
return self.scryfallJson['hand_modifier']
|
||
|
||
def color_indicator(self, num):
|
||
"""An list of all colors found in this card's color indicator
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
self._checkForTupleKey('card_faces', num, 'color_indicator')
|
||
|
||
return self.scryfallJson['card_faces'][num]['color_indicator']
|
||
|
||
def all_parts(self):
|
||
"""This this card is closely related to other cards, this property will be an list with it
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
super(CardsObject, self)._checkForKey('all_parts')
|
||
|
||
return self.scryfallJson['all_parts']
|
||
|
||
def card_faces(self):
|
||
"""If it exists, all parts found on a card's face will be found as an object from this list
|
||
|
||
Returns:
|
||
list
|
||
"""
|
||
super(CardsObject, self)._checkForKey('card_faces')
|
||
|
||
return self.scryfallJson['card_faces']
|
||
|
||
def watermark(self):
|
||
"""The associated watermark of the card, if any
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('watermark')
|
||
|
||
return self.scryfallJson['watermark']
|
||
|
||
def story_spotlight(self):
|
||
"""True if this card is featured in the story
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('story_spotlight')
|
||
|
||
return self.scryfallJson['story_spotlight']
|
||
|
||
def power(self):
|
||
"""The power of the creature, if applicable
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('power')
|
||
|
||
return self.scryfallJson['power']
|
||
|
||
def toughness(self):
|
||
"""The toughness of the creature, if applicable
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('toughness')
|
||
|
||
return self.scryfallJson['toughness']
|
||
|
||
def loyalty(self):
|
||
"""This card's loyalty. Some loyalties may be X rather than a number
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('loyalty')
|
||
|
||
return self.scryfallJson['loyalty']
|
||
|
||
def flavor_text(self):
|
||
"""The flavor text of the card, if any
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('flavor_text')
|
||
|
||
return self.scryfallJson['flavor_text']
|
||
|
||
def arena_id(self):
|
||
"""The Arena ID of the card, if any
|
||
|
||
Returns:
|
||
int: The Arena ID of the card, if any
|
||
"""
|
||
super(CardsObject, self)._checkForKey('arena_id')
|
||
|
||
return self.scryfallJson['arena_id']
|
||
|
||
def lang(self):
|
||
"""The language of the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('lang')
|
||
|
||
return self.scryfallJson['lang']
|
||
|
||
def printed_name(self):
|
||
"""If the card is in a non-English language, this will be the name as it appears on the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('printed_name')
|
||
|
||
return self.scryfallJson['printed_name']
|
||
|
||
def printed_type_line(self):
|
||
"""If the card is in a non-English language, this will be the type line as it appears on the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('printed_type_line')
|
||
|
||
return self.scryfallJson['printed_type_line']
|
||
|
||
def printed_text(self):
|
||
"""If the card is in a non-English language, this will be the rules text as it appears on the card
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('printed_text')
|
||
|
||
return self.scryfallJson['printed_text']
|
||
|
||
def oracle_id(self):
|
||
"""A unique ID for this card's oracle text
|
||
|
||
Returns:
|
||
string
|
||
"""
|
||
super(CardsObject, self)._checkForKey('oracle_id')
|
||
|
||
return self.scryfallJson['oracle_id']
|
||
|
||
def foil(self):
|
||
"""True if this printing exists in a foil version.
|
||
|
||
DEPRECATION NOTICE: This method will be deprecated on Nov 1, 2021.
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('foil')
|
||
|
||
print('WARNING: This method will be deprecated on Nov 1, 2021. Please use the `finishes` method instead.')
|
||
|
||
return self.scryfallJson['foil']
|
||
|
||
def nonfoil(self):
|
||
"""True if this printing does not exist in foil
|
||
|
||
DEPRECATION NOTICE: This method will be deprecated on Nov 1, 2021.
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('nonfoil')
|
||
|
||
print('WARNING: This method will be deprecated on Nov 1, 2021. Please use the `finishes` method instead.')
|
||
|
||
return self.scryfallJson['nonfoil']
|
||
|
||
def oversized(self):
|
||
"""True if this printing is an oversized card
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('oversized')
|
||
|
||
return self.scryfallJson['oversized']
|
||
|
||
def games(self):
|
||
"""A list of games that this card print is available in.
|
||
|
||
Returns:
|
||
array: A list of games
|
||
"""
|
||
super(CardsObject, self)._checkForKey('games')
|
||
|
||
return self.scryfallJson['games']
|
||
|
||
def promo(self):
|
||
"""True if this card is a promotional print.
|
||
|
||
Returns:
|
||
boolean
|
||
"""
|
||
super(CardsObject, self)._checkForKey('promo')
|
||
|
||
return self.scryfallJson['promo']
|
||
|
||
def released_at(self):
|
||
"""The date this card was first released.
|
||
|
||
Returns:
|
||
string: The date in ISO format
|
||
"""
|
||
super(CardsObject, self)._checkForKey('released_at')
|
||
|
||
return self.scryfallJson['released_at']
|
||
|
||
def preview(self, key=None):
|
||
"""Preview information for this card, if any.
|
||
You may pass the name of a valid key to return the value of that key.
|
||
Such as a source_uri.
|
||
|
||
Args:
|
||
key (string): A key for specific information about the preview.
|
||
|
||
Returns:
|
||
dict: If provided no key, the entire dict is returned.
|
||
string: If provided a key, the value of that key is returned.
|
||
"""
|
||
super(CardsObject, self)._checkForKey('preview')
|
||
|
||
if key in self.scryfallJson['preview']:
|
||
return self.scryfallJson['preview'][key]
|
||
|
||
return self.scryfallJson['preview']
|
||
|
||
def image_status(self):
|
||
"""Provides insight to the status of the images of the card.
|
||
|
||
Returns:
|
||
string: An enum of 'missing', 'placeholder', 'lowres', 'highres_scan'
|
||
"""
|
||
super(CardsObject, self)._checkForKey('image_status')
|
||
|
||
return self.scryfallJson['image_status']
|
||
|
||
def finishes(self):
|
||
"""A list of computer-readable flags that indicate if this card
|
||
can come in foil, nonfoil, etched, or glossy finishes.
|
||
|
||
Returns:
|
||
list: A list of all finishes.
|
||
"""
|
||
super(CardsObject, self)._checkForKey('finishes')
|
||
|
||
return self.scryfallJson['finishes'] |