kihashi / mana_archive

Mana Archive is a database and API for accessing information about cards from the Magic: The Gathering collectible card game.

Mana Archive is a database and API for accessing information about cards from the Magic: The Gathering collectible card game.

Data Sources

Mana Archive includes a parser for MTGJSON. Other data sources may be added in the future. If you would like another data source, please open an issue and I will see about making a parser for it. Note that if the data source does not include data, then that data will not be added to the database.

Setting Up and Building

First, clone the repository and install the requirements:

git clone https://github.com/kihashi/mana_archive.git ./mana_archive
cd mana_archive
pip install -r requirements.txt

Mana Archive includes a pavement file for easy building. This provides some commands to easily set up the database.

paver build # Downloads necessary data files and parses them. This will take some time.

Paver Commands

These commands are provided for convenience, however, you can run the commands from each task should you so desire. See the pavement.py file.

• clean -- Removes the database file.
• clean_all -- Removes the database file and the JSON data file.
• download_data -- Downloads the JSON data file.
• build -- Downloads the JSON data file, sets up the database models, creates static data (colors, layouts, and rarities) and parses the JSON data file. Also parses price data if the required API keys/URLs are provided in the config.
• buildclean -- clean_all then build.