Skip to content

Catalogs

scooze.catalogs

BorderColor

Bases: ExtendedEnum, StrEnum

A color that borders of Magic cards can be.

BLACK = auto() class-attribute instance-attribute

WHITE = auto() class-attribute instance-attribute

BORDERLESS = auto() class-attribute instance-attribute

SILVER = auto() class-attribute instance-attribute

GOLD = auto() class-attribute instance-attribute

YELLOW = auto() class-attribute instance-attribute

Color

Bases: ExtendedEnum, StrEnum

A color that Magic cards can be.

WHITE = 'W' class-attribute instance-attribute

BLUE = 'U' class-attribute instance-attribute

BLACK = 'B' class-attribute instance-attribute

RED = 'R' class-attribute instance-attribute

GREEN = 'G' class-attribute instance-attribute

COLORLESS = 'C' class-attribute instance-attribute

Component

Bases: ExtendedEnum, StrEnum

A type of related object, used in Scryfall to link a card to other cards or tokens referenced by it; see here

MELD_PART = auto() class-attribute instance-attribute

MELD_RESULT = auto() class-attribute instance-attribute

TOKEN = auto() class-attribute instance-attribute

COMBO_PIECE = auto() class-attribute instance-attribute

Finish

Bases: ExtendedEnum, StrEnum

A finish type that a Magic card can be printed with.

FOIL = auto() class-attribute instance-attribute

NONFOIL = auto() class-attribute instance-attribute

ETCHED = auto() class-attribute instance-attribute

Format

Bases: ExtendedEnum, StrEnum

A Magic: the Gathering competitive format.

ALCHEMY = auto() class-attribute instance-attribute

BRAWL = auto() class-attribute instance-attribute

COMMANDER = auto() class-attribute instance-attribute

DUEL = auto() class-attribute instance-attribute

EXPLORER = auto() class-attribute instance-attribute

FUTURE = auto() class-attribute instance-attribute

GLADIATOR = auto() class-attribute instance-attribute

HISTORIC = auto() class-attribute instance-attribute

LEGACY = auto() class-attribute instance-attribute

MODERN = auto() class-attribute instance-attribute

OATHBREAKER = auto() class-attribute instance-attribute

OLDSCHOOL = auto() class-attribute instance-attribute

PAUPER = auto() class-attribute instance-attribute

PAUPERCOMMANDER = auto() class-attribute instance-attribute

PENNY = auto() class-attribute instance-attribute

PIONEER = auto() class-attribute instance-attribute

PREDH = auto() class-attribute instance-attribute

PREMODERN = auto() class-attribute instance-attribute

STANDARD = auto() class-attribute instance-attribute

STANDARDBRAWL = auto() class-attribute instance-attribute

TIMELESS = auto() class-attribute instance-attribute

VINTAGE = auto() class-attribute instance-attribute

LIMITED = auto() class-attribute instance-attribute

NONE = auto() class-attribute instance-attribute

Frame

Bases: ExtendedEnum, StrEnum

A frame style for a Magic card, corresponding to the year of its design.

FUTURE = auto() class-attribute instance-attribute

FrameEffect

Bases: ExtendedEnum, StrEnum

A frame effect on a Magic card that's different from the usual even border.

COLORSHIFTED = auto() class-attribute instance-attribute

COMPANION = auto() class-attribute instance-attribute

DEVOID = auto() class-attribute instance-attribute

DRAFT = auto() class-attribute instance-attribute

ENCHANTMENT = auto() class-attribute instance-attribute

ETCHED = auto() class-attribute instance-attribute

EXTENDEDART = auto() class-attribute instance-attribute

FULLART = auto() class-attribute instance-attribute

INVERTED = auto() class-attribute instance-attribute

LEGENDARY = auto() class-attribute instance-attribute

LESSON = auto() class-attribute instance-attribute

MIRACLE = auto() class-attribute instance-attribute

SHATTEREDGLASS = auto() class-attribute instance-attribute

SHOWCASE = auto() class-attribute instance-attribute

SNOW = auto() class-attribute instance-attribute

SPREE = auto() class-attribute instance-attribute

TEXTLESS = auto() class-attribute instance-attribute

TOMBSTONE = auto() class-attribute instance-attribute

COMPASSLANDDFC = auto() class-attribute instance-attribute

CONVERTDFC = auto() class-attribute instance-attribute

FANDFC = auto() class-attribute instance-attribute

MOONELDRAZIDFC = auto() class-attribute instance-attribute

ORIGINPWDFC = auto() class-attribute instance-attribute

SUNMOONDFC = auto() class-attribute instance-attribute

UPSIDEDOWNDFC = auto() class-attribute instance-attribute

WAXINGANDWANINGMOONDFC = auto() class-attribute instance-attribute

Game

Bases: ExtendedEnum, StrEnum

An official Magic game a card print can be available in.

PAPER = auto() class-attribute instance-attribute

ARENA = auto() class-attribute instance-attribute

MTGO = auto() class-attribute instance-attribute

ASTRAL = auto() class-attribute instance-attribute

SEGA = auto() class-attribute instance-attribute

ImageStatus

Bases: ExtendedEnum, StrEnum

An indicator for whether a card's image exists on Scryfall, and how high quality the sourced image is; see here

MISSING = auto() class-attribute instance-attribute

PLACEHOLDER = auto() class-attribute instance-attribute

LOWRES = auto() class-attribute instance-attribute

HIGHRES_SCAN = auto() class-attribute instance-attribute

Language

Bases: ExtendedEnum, StrEnum

A language that Magic cards have been printed in, using Scryfall's language codes; see here

ENGLISH = 'en' class-attribute instance-attribute

SPANISH = 'es' class-attribute instance-attribute

FRENCH = 'fr' class-attribute instance-attribute

GERMAN = 'de' class-attribute instance-attribute

ITALIAN = 'it' class-attribute instance-attribute

PORTUGUESE = 'pt' class-attribute instance-attribute

JAPANESE = 'ja' class-attribute instance-attribute

KOREAN = 'ko' class-attribute instance-attribute

RUSSIAN = 'ru' class-attribute instance-attribute

CHINESE_SIMPLIFIED = 'zhs' class-attribute instance-attribute

CHINESE_TRADITIONAL = 'zht' class-attribute instance-attribute

PHYREXIAN = 'ph' class-attribute instance-attribute

ANCIENT_GREEK = 'grc' class-attribute instance-attribute

ARABIC = 'ar' class-attribute instance-attribute

HEBREW = 'he' class-attribute instance-attribute

LATIN = 'la' class-attribute instance-attribute

SANSKRIT = 'sa' class-attribute instance-attribute

Layout

Bases: ExtendedEnum, StrEnum

A layout that a Magic card can be printed with.

NORMAL = auto() class-attribute instance-attribute

ADVENTURE = auto() class-attribute instance-attribute

ART_SERIES = auto() class-attribute instance-attribute

AUGMENT = auto() class-attribute instance-attribute

BATTLE = auto() class-attribute instance-attribute

CASE = auto() class-attribute instance-attribute

CLASS = auto() class-attribute instance-attribute

DOUBLE_FACED_TOKEN = auto() class-attribute instance-attribute

EMBLEM = auto() class-attribute instance-attribute

FLIP = auto() class-attribute instance-attribute

HOST = auto() class-attribute instance-attribute

LEVELER = auto() class-attribute instance-attribute

MELD = auto() class-attribute instance-attribute

MODAL_DFC = auto() class-attribute instance-attribute

MUTATE = auto() class-attribute instance-attribute

PLANAR = auto() class-attribute instance-attribute

PROTOTYPE = auto() class-attribute instance-attribute

REVERSIBLE_CARD = auto() class-attribute instance-attribute

SAGA = auto() class-attribute instance-attribute

SCHEME = auto() class-attribute instance-attribute

SPLIT = auto() class-attribute instance-attribute

TOKEN = auto() class-attribute instance-attribute

TRANSFORM = auto() class-attribute instance-attribute

VANGUARD = auto() class-attribute instance-attribute

Legality

Bases: ExtendedEnum, StrEnum

String enum of different legalities that a card can have in a format.

  • legal: eligible to be played in a format, and not banned
  • not_legal: not eligible to be legal (never printed in right set/rarity)
  • banned: eligible to be legal, but specifically banned
  • restricted: only 1 copy allowed in a deck (specific to Vintage)

LEGAL = auto() class-attribute instance-attribute

BANNED = auto() class-attribute instance-attribute

RESTRICTED = auto() class-attribute instance-attribute

Rarity

Bases: ExtendedEnum, StrEnum

A rarity that a print of a Magic card can be.

COMMON = auto() class-attribute instance-attribute

UNCOMMON = auto() class-attribute instance-attribute

RARE = auto() class-attribute instance-attribute

SPECIAL = auto() class-attribute instance-attribute

MYTHIC = auto() class-attribute instance-attribute

BONUS = auto() class-attribute instance-attribute

ScryfallBulkFile

Bases: ExtendedEnum, StrEnum

Canonical names for Scryfall bulk files.

ORACLE = 'oracle_cards' class-attribute instance-attribute

ARTWORK = 'unique_artwork' class-attribute instance-attribute

DEFAULT = 'default_cards' class-attribute instance-attribute

ALL = 'all_cards' class-attribute instance-attribute

SecurityStamp

Bases: ExtendedEnum, StrEnum

A holographic security stamp printed on the bottom of some Magic cards, generally rares and mythics.

OVAL = auto() class-attribute instance-attribute

ACORN = auto() class-attribute instance-attribute

ARENA = auto() class-attribute instance-attribute

CIRCLE = auto() class-attribute instance-attribute

HEART = auto() class-attribute instance-attribute

TRIANGLE = auto() class-attribute instance-attribute

SetType

Bases: ExtendedEnum, StrEnum

A Scryfall-provided categorization for a set; see here

ALCHEMY = auto() class-attribute instance-attribute

ARCHENEMY = auto() class-attribute instance-attribute

ARSENAL = auto() class-attribute instance-attribute

BOX = auto() class-attribute instance-attribute

COMMANDER = auto() class-attribute instance-attribute

CORE = auto() class-attribute instance-attribute

DRAFT_INNOVATION = auto() class-attribute instance-attribute

DUEL_DECK = auto() class-attribute instance-attribute

EXPANSION = auto() class-attribute instance-attribute

FROM_THE_VAULT = auto() class-attribute instance-attribute

FUNNY = auto() class-attribute instance-attribute

MASTERPIECE = auto() class-attribute instance-attribute

MASTERS = auto() class-attribute instance-attribute

MEMORABILIA = auto() class-attribute instance-attribute

MINIGAME = auto() class-attribute instance-attribute

PLANECHASE = auto() class-attribute instance-attribute

PREMIUM_DECK = auto() class-attribute instance-attribute

PROMO = auto() class-attribute instance-attribute

SPELLBOOK = auto() class-attribute instance-attribute

STARTER = auto() class-attribute instance-attribute

TOKEN = auto() class-attribute instance-attribute

TREASURE_CHEST = auto() class-attribute instance-attribute

VANGUARD = auto() class-attribute instance-attribute

CostSymbol

Bases: ExtendedEnum, StrEnum

A symbol that can show up in mana cost or oracle text of Magic cards.

WHITE = 'W' class-attribute instance-attribute

BLUE = 'U' class-attribute instance-attribute

BLACK = 'B' class-attribute instance-attribute

RED = 'R' class-attribute instance-attribute

GREEN = 'G' class-attribute instance-attribute

COLORLESS = 'C' class-attribute instance-attribute

GENERIC_0 = '0' class-attribute instance-attribute

GENERIC_1 = '1' class-attribute instance-attribute

GENERIC_2 = '2' class-attribute instance-attribute

GENERIC_3 = '3' class-attribute instance-attribute

GENERIC_4 = '4' class-attribute instance-attribute

GENERIC_5 = '5' class-attribute instance-attribute

GENERIC_6 = '6' class-attribute instance-attribute

GENERIC_7 = '7' class-attribute instance-attribute

GENERIC_8 = '8' class-attribute instance-attribute

GENERIC_9 = '9' class-attribute instance-attribute

GENERIC_10 = '10' class-attribute instance-attribute

GENERIC_11 = '11' class-attribute instance-attribute

GENERIC_12 = '12' class-attribute instance-attribute

GENERIC_13 = '13' class-attribute instance-attribute

GENERIC_14 = '14' class-attribute instance-attribute

GENERIC_15 = '15' class-attribute instance-attribute

GENERIC_16 = '16' class-attribute instance-attribute

GENERIC_17 = '17' class-attribute instance-attribute

GENERIC_18 = '18' class-attribute instance-attribute

GENERIC_19 = '19' class-attribute instance-attribute

GENERIC_20 = '20' class-attribute instance-attribute

GENERIC_X = 'X' class-attribute instance-attribute

GENERIC_Y = 'Y' class-attribute instance-attribute

SNOW = 'S' class-attribute instance-attribute

HYBRID_WU = 'W/U' class-attribute instance-attribute

HYBRID_UB = 'U/B' class-attribute instance-attribute

HYBRID_BR = 'B/R' class-attribute instance-attribute

HYBRID_RG = 'R/G' class-attribute instance-attribute

HYBRID_GW = 'G/W' class-attribute instance-attribute

HYBRID_WB = 'W/B' class-attribute instance-attribute

HYBRID_UR = 'U/R' class-attribute instance-attribute

HYBRID_BG = 'B/G' class-attribute instance-attribute

HYBRID_RW = 'R/W' class-attribute instance-attribute

HYBRID_GU = 'G/U' class-attribute instance-attribute

HYBRID_CW = 'C/W' class-attribute instance-attribute

HYBRID_CU = 'C/U' class-attribute instance-attribute

HYBRID_CB = 'C/B' class-attribute instance-attribute

HYBRID_CR = 'C/R' class-attribute instance-attribute

HYBRID_CG = 'C/G' class-attribute instance-attribute

PHYREXIAN_WHITE = 'W/P' class-attribute instance-attribute

PHYREXIAN_BLUE = 'U/P' class-attribute instance-attribute

PHYREXIAN_BLACK = 'B/P' class-attribute instance-attribute

PHYREXIAN_RED = 'R/P' class-attribute instance-attribute

PHYREXIAN_GREEN = 'G/P' class-attribute instance-attribute

PHYREXIAN_COLORLESS = 'C/P' class-attribute instance-attribute

GENERIC_PHYREXIAN = 'H' class-attribute instance-attribute

HYBRID_PHYREXIAN_WU = 'W/U/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_UB = 'U/B/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_BR = 'B/R/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_RG = 'R/G/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_GW = 'G/W/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_WB = 'W/B/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_UR = 'U/R/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_BG = 'B/G/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_RW = 'R/W/P' class-attribute instance-attribute

HYBRID_PHYREXIAN_GU = 'G/U/P' class-attribute instance-attribute

TWOBRID_WHITE = '2/W' class-attribute instance-attribute

TWOBRID_BLUE = '2/U' class-attribute instance-attribute

TWOBRID_BLACK = '2/B' class-attribute instance-attribute

TWOBRID_RED = '2/R' class-attribute instance-attribute

TWOBRID_GREEN = '2/G' class-attribute instance-attribute

TAP = 'T' class-attribute instance-attribute

UNTAP = 'Q' class-attribute instance-attribute

ENERGY = 'E' class-attribute instance-attribute

PAWPRINT = 'P' class-attribute instance-attribute

GENERIC_HALF = '½' class-attribute instance-attribute

HALF_WHITE = 'HW' class-attribute instance-attribute

HALF_BLUE = 'HU' class-attribute instance-attribute

HALF_BLACK = 'HB' class-attribute instance-attribute

HALF_RED = 'HR' class-attribute instance-attribute

HALF_GREEN = 'HG' class-attribute instance-attribute

GENERIC_100 = '100' class-attribute instance-attribute

GENERIC_1000000 = '1000000' class-attribute instance-attribute

GENERIC_INFINITY = '∞' class-attribute instance-attribute

GENERIC_Z = 'Z' class-attribute instance-attribute

TICKET = 'TK' class-attribute instance-attribute

LEGENDARY = 'L' class-attribute instance-attribute

LAND_DROP = 'D' class-attribute instance-attribute

is_generic: bool property

Determine if this mana symbol is generic.

Example 
CostSymbol.GENERIC_1.is_generic()

is_half: bool property

Determine if this mana symbol is half.

Example 
CostSymbol.GENERIC_HALF.is_half()

is_hybrid: bool property

Determine if this mana symbol is hybrid.

Example 
CostSymbol.HYBRID_RG.is_hybrid()

is_phyrexian: bool property

Determine if this mana symbol is Phyrexian.

Example 
CostSymbol.PHYREXIAN_BLUE.is_phyrexian()

is_twobrid: bool property

Determine if this mana symbol is a twobrid.

Example 
CostSymbol.TWOBRID_WHITE.is_twobrid()

is_variable: bool property

Determine if this mana symbol is variable.

Example 
CostSymbol.GENERIC_X.is_variable()

is_un: bool property

Determine if this mana symbol is from an "Un"-set.

Example 
CostSymbol.GENERIC_100.is_un()

is_nonmana: bool property

Determine if this mana symbol is non-mana.

Example 
CostSymbol.TAP.is_nonmana()

mana_value_contribution: float property

The numerical mana value for this symbol; will be integer valued except for 1/2 mana symbols from "Un"-sets.

Example 
CostSymbol.GREEN.mana_value_contribution()
>>> 1