scooze

A flexible data layer for applications working with Magic: the Gathering cards and decks.

Features

📊 Robust data models for representing Magic: the Gathering cards and decks

• Cards - follows the Scryfall standard
• Decks - main deck/sideboard/command zone, format legality, average words, and more

🎛️ CLI to manage a local database of Scryfall data

🐍 Python and REST APIs for interacting with the scooze database

Help

The source code can be found here.

See our documentation for more information.

Installation

Install using pip install scooze. For more installation options, see the Install section in the documentation.

A Simple Example

from scooze import Card, Deck, Format, InThe

deck = Deck()
card1 = Card("Python")
card2 = Card("Anaconda")
swamp = Card("Swamp")

deck.add_card(card1, 25)
deck.add_card(swamp, 15)
deck.add_card(card2, 100, InThe.SIDE)

legal_limited = deck.is_legal(Format.LIMITED)   # True
legal_pauper = deck.is_legal(Format.PAUPER)     # False

export = deck.export()
"""
Deck:
25 Python
15 Swamp

Sideboard:
100 Anaconda
"""

See Setup and our API Documentation for more details.

Contributing

For guidance on setting up a development environment and how to make a contribution to scooze, see Contributing to scooze.

Report a Bug

If you find a bug 🐛 please open a bug report. If you have an idea for an improvement or new feature 🚀 please open a feature request.

If you find a security vulnerability, please follow the instructions here.