Card

A scooze Card represents a Magic: the Gathering card closely following the Scryfall schema.

scooze.card

Card

Bases: HashableObject

A Card object that supports all fields available from Scryfall's JSON data. Represents a specific printing of a card.

Attributes:

Name	Type	Description
name	str | None	This card's name.
scooze_id	PydanticObjectId | None	A unique identifier for a document in a scooze database.
arena_id	int | None	This card's Arena ID, if applicable.
scryfall_id	str | None	Scryfall's unique ID for this card.
lang	Language | None	The language code for this print; see here
mtgo_id	int | None	This card's MTGO Catalog ID, if applicable.
mtgo_foil_id	int | None	This card's foil MTGO Catalog ID, if applicable.
multiverse_ids	tuple[int] | None	This card's multiverse IDs on Gatherer, if any.
tcgplayer_id	int | None	This card's ID on TCGplayer, or productId in their system.
tcgplayer_etched_id	int | None	This card's ID on TCGplayer, for the etched version if that is a separate product.
cardmarket_id	int | None	This card's ID on Cardmarket, or idProduct in their system.
oracle_id	str | None	A UUID for this card's oracle identity; shared across prints of the same card but not same-named objects with different gameplay properties.
prints_search_uri	str | None	A link to begin paginating through all prints of this card in Scryfall's API.
rulings_uri	str | None	A link to rulings for this card in Scryfall's API.
scryfall_uri	str | None	A link to the Scryfall page for this card.
uri	str | None	A link to this card in Scryfall's API.
all_parts	tuple[RelatedCard] | None	RelatedCards for tokens/meld pairs/other associated parts to this card, if applicable.
card_faces	tuple[CardFace] | None	All component CardFaces of this card, for multifaced cards.
cmc	float | None	This card's mana value/converted mana cost.
color_identity	frozenset[Color] | None	This card's color identity, for Commander variant deckbuilding.
color_indicator	frozenset[Color] | None	The colors in this card's color indicator, if it has one.
colors	frozenset[Color] | None	This card's colors.
edhrec_rank	int | None	This card's rank/popularity on EDHREC, if applicable.
hand_modifier	str | None	This card's Vanguard hand size modifier, if applicable.
keywords	frozenset[str] | None	Keywords and keyword actions this card uses.
legalities	frozendict[Format, Legality] | None	Formats and the legality status of this card in them.
life_modifier	str | None	This card's Vanguard life modifier value, if applicable.
loyalty	str | None	This card's starting planeswalker loyalty, if applicable.
mana_cost		Mana cost, as string of mana symbols. (e.g. "{1}{W}{U}{B}{R}{G}")
oracle_text	str | None	This card's oracle text, if any.
oversized	bool | None	Whether this card is oversized.
penny_rank	int | None	This card's rank/popularity on Penny Dreadful.
power	str | None	Power of this card, if applicable.
produced_mana	frozenset[Color] | None	Which colors of mana this card can produce.
reserved	bool | None	Whether this card is on the Reserved List.
toughness	str | None	Toughness of this card, if applicable.
type_line	str | None	This card's type line. (e.g. "Creature — Ooze")
artist	str | None	Artist for this card.
artist_ids	tuple[str] | None	List of Scryfall IDs for artists of this card.
attraction_lights	frozenset[int] | None	Attraction lights lit on this card, if applicable.
booster	bool | None	Whether this card can be opened in booster packs.
border_color	BorderColor | None	Border color of this card, from among black, white, borderless, silver, and gold.
card_back_id	str | None	Scryfall UUID of the card back design for this card.
collector_number	str | None	This card's collector number; can contain non-numeric characters.
content_warning	bool	True if use of this print should be avoided; see here
digital	bool | None	True if this card was only released in a video game.
finishes	frozenset[Finish] | None	Finishes this card is available in, from among foil, nonfoil, and etched.
flavor_name	str | None	Alternate name for this card, such as on Godzilla series.
flavor_text	str | None	Flavor text on this card, if any.
frame_effects	frozenset[FrameEffect] | None	Special frame effects on this card; see here
frame	frozenset[Frame] | None	This card's frame layout; see here
full_art	bool | None	Whether this print is full-art.
games	frozenset[Game] | None	Which games this print is available on, from among paper, mtgo, and arena.
highres_image	bool | None	Whether this card has a high-res image available.
illustration_id	str | None	A UUID for the particular artwork on this print, consistent across art reprints.
image_status	ImageStatus | None	The quality/status of images available for this card. Either missing, placeholder, lowres, or highres_scan.
image_uris	ImageUris | None	Links to images of this card in various qualities.
layout	Layout | None	This card's printed layout; see here
preview	Preview | None	Information about where, when, and how this print was previewed.
prices	Prices | None	Prices for this card on various marketplaces.
printed_name	str | None	Printed name of this card, for localized non-English cards.
printed_text	str | None	Printed text of this card, for localized non-English cards.
printed_type_line	str | None	Printed type line of this card, for localized non-English cards.
promo	bool | None	Whether this print is a promo.
promo_types	frozenset[str] | None	Which promo categories this print falls into, if any.
purchase_uris	PurchaseUris	Links to purchase this print from marketplaces.
rarity	Rarity | None	The rarity of this print.
related_uris	RelatedUris	Links to this print's listing on other online resources.
released_at	date | None	The date this card was first released.
reprint	bool | None	Whether this print is a reprint from an earlier set.
scryfall_set_uri	str | None	Link to the Scryfall set page for the set of this print.
security_stamp	SecurityStamp | None	Security stamp on this card, if any.
set_name	str | None	Full name of the set this print belongs to.
set_search_uri	str | None	Link to Scryfall API to start paginating through this print's full set.
set_type	SetType | None	An overall categorization for each set, provided by Scryfall.
set_uri	str | None	Link to the set for this print in Scryfall's API.
set_code	str | None	Set code of the set this print belongs to.
set_id	str | None	UUID of the set this print belongs to.
story_spotlight	bool | None	Whether this print is a Story Spotlight.
textless	bool | None	Whether this print is textless.
variation	bool | None	Whether this card print is a variation of another card.
variation_of	str | None	Which card this object is a variant of, if any.
watermark	str | None	Watermark printed on this card, if any.

from_json(data: dict | str) -> Self classmethod

Create a new Card with the given JSON.

Parameters:

Name	Type	Description	Default
data	dict | str	Some JSON to create a scooze Card from.	required

from_model(model: CardModel) -> Self classmethod

Create a new Card with the given CardModel.

Parameters:

Name	Type	Description	Default
model	CardModel	A CardModel to create a scooze Card from.	required

oracle_text_without_reminder(oracle_text: str) -> str classmethod

Provide the given oracle text with reminder text removed.

Note

This is a class method because cards with two unique faces won't know which face you'd want. Instead you simply pass the text from which you want to trim reminder text.

Parameters:

Name	Type	Description	Default
oracle_text	str	The oracle text of a card.	required

is_double_sided() -> bool

Determine if this is a double-sided card.

mana_symbols() -> Counter[CostSymbol]

A mapping of CostSymbols to how many times those symbols appear in this card's mana cost.

total_words() -> int

The number of words in this card's oracle text (excludes reminder text).

scooze.cardparts

ImageUris

Bases: HashableObject

URIs of images associated with this object on Scryfall.

Attributes:

Name	Type	Description
png	str | None	Full card, high quality image with transparent background and rounded corners.
border_crop	str | None	Full card image with corners and majority of border cropped out.
art_crop	str | None	Rectangular crop to just art box; may not be perfect for cards with strange layouts.
large	str | None	Large JPG image (672x936)
normal	str | None	Medium JPG image (488x860)
small	str | None	Small JPG image (146x204)

CardFace

Bases: HashableObject

An object for a single face of a multi-faced Card. Multi-faced cards include MDFCs, split cards, aftermath, etc; see here

Attributes:

Name	Type	Description
name	str | None	Name of this face.
artist	str | None	Illustrator for art on this face.
artist_id	str | None	Scryfall ID for the artist of this face.
cmc	float | None	Mana value of this face.
color_indicator	frozenset[Color] | None	Color indicator on this face, if any.
colors	frozenset[Color] | None	Colors of this face.
flavor_text	str | None	Flavor text of this face, if any.
illustration_id	str | None	Scryfall illustration ID of this face, if any.
image_uris	ImageUris | None	URIs for images of this face on Scryfall.
layout	Layout | None	Layout of this face, if any.
loyalty	str | None	Starting planeswalker loyalty of this face, if any.
mana_cost	str | None	Mana cost of this face.
oracle_id	str | None	Oracle ID of this face, for reversible cards.
oracle_text	str | None	Oracle text of this face, if any.
power	str | None	Power of this face, if any.
printed_name	str | None	Printed name of this face, for localized non-English cards.
printed_text	str | None	Printed text of this face, for localized non-English cards.
printed_type_line	str | None	Printed type line of this face, for localized non-English cards.
toughness	str | None	Toughness of this face, if any.
type_line	str | None	Type line of this face, if any.
watermark	str | None	Watermark printed on this face, if any.

Preview

Bases: HashableObject

An object for information about where and when a card was previewed.

Attributes:

Name	Type	Description
previewed_at	date | None	Date/time of preview being shown or added to Scryfall.
source	str | None	Name of preview source.
source_uri	str | None	Location of preview source.

Prices

Bases: HashableObject

An object for all price data associated with a Card object.

Attributes:

Name	Type	Description
usd	float | None	Price in US dollars, from TCGplayer.
usd_foil	float | None	Foil price in US dollars, from TCGplayer.
usd_etched	float | None	Etched foil price in US dollars, from TCGplayer.
eur	float | None	Price in Euros, from Cardmarket.
eur_foil	float | None	Foil price in Euros, from Cardmarket.
tix	float | None	Price in MTGO tix, from Cardhoarder.

PurchaseUris

Bases: HashableObject

URIs to this card's listings on major marketplaces.

Attributes:

Name	Type	Description
tcgplayer	str | None	Link to buy this card on the TCGplayer marketplace.
cardmarket	str | None	Link to buy this card on the Cardmarket marketplace.
cardhoarder	str | None	Link to buy this card digitally for MTGO on Cardhoarder.

RelatedCard

Bases: HashableObject

Data about Scryfall objects related to this card (tokens, cards referenced by name, meld pairs, etc.)

Attributes:

Name	Type	Description
name	str | None	Name of linked component.
scryfall_id	str	ID of linked component.
component	Component | None	One of token, meld_part, meld_result, or combo_piece.
type_line	str | None	Type line of linked component.
uri	str | None	URI of linked component.

RelatedUris

Bases: HashableObject

Links to information about a Scryfall-based card object on other non-Scryfall resources.

Attributes:

Name	Type	Description
edhrec	str | None	Link to EDHREC
gatherer	str | None	Link to gatherer.wizards.com
tcgplayer_infinite_articles	str | None	Link to infinite.tcgplayer.com/magic-the-gathering/articles
tcgplayer_infinite_decks	str | None	Link to infinite.tcgplayer.com/magic-the-gathering/decks