Skip to main content

MTG_Scryfall_Grabber (MSG) is a Python library/repository for scraping and organizing data from the Scryfall Rest-API.

Project description

mtg_scryfall_grabber

Pylint pytest

mtg_scryfall_grabber (MSG) is a Python library and module for scraping and organizing data from the Scryfall Rest-API.

conda is not needed but a sample environment.yaml is provided for the bare minimums you need to run in your own conda enviornment.

Installation

Please go to Releases for the latest directories.

Additionally, this can be installed from pip using

python3 -m pip install mtg_scryfall_grabber

Usage

After installing via pip using

python3 -m pip install --upgrade mtg_scryfall_grabber

The functions from mtg_scryfall_grabber.py can be invoked using

import mtg_scryfall_grabber

Quickstart (/w conda)

conda install

conda can be installed from here

Once conda is installed

  1. Clone the following repo
https://github.com/Contrastellar/mtg_scryfall_grabber
  1. Navigate to the repo
cd ./mtg_scryfall_grabber/
  1. Install the environment, where $NAME_OF_ENVIRONMENT is any name, or is omitted altogether, as one is given in the file.
conda env create --file ./environment.yaml --name $NAME_OF_ENVIRONMENT
  1. Activate the environment
conda activate $NAME_OF_ENVIRONMENT
  1. Navigate to the ./example/ directory
cd ./example/
  1. Run the following OS dependant command to download the information for the set "Phyrexia, All Will Be One"

PowerShell

py msfg.py ONE -c -p

Unix

python3 msfg.py ONE -c -p

Quickstart w/o conda

To get started quickly, one must install Python 3 (version 3.8 or greater).

Once having completed Python 3 installation for your Operating System, running the following command

PowerShell ---

py -m pip install --upgrade mtg-scryfall-grabber

MacOS/UNIX Terminal/bash ---

python3 -m pip install --upgrade mtg-scryfall-grabber

This will install mtg-scryfall-grabber's mtg_scryfall_grabber library, to be imported and used in your own Python Module if so desired. From here, downloading (either from releases, or from cloning this repository) the example/msfg.py file. Once this is done, the following steps can be taken to 'quickstart' downloading information from the Scryfall API.

  1. In your commandline (henceforth the CLI), navigate to the directory.
cd $MTG_SCRYFALL_GRABBER_DOWNLOAD_LOCATION/example/
  1. Run the following command to download the information for the set "Phyrexia, All Will Be One"

PowerShell

py msfg.py ONE -c -p

MacOS/UNIX Terminal/Bash

python3 msfg.py ONE -c -p

In ./example/, this will create a directory named "output", which will contain a .json file named like ONE_name_price_$(TIME).json -- where it is compiled by set code + unix time.

TODO

Nothing else major needs to be done at this point, however polishing and code testing will be implemented to this library before this is considered a full, ready-to-be-used in production v.1 release.

Additional functions need to be implimented, however -- an example implementation of this library is given in ./example/ under msfg.py. This implementation can also be treated as the "primary" method of using this library, in order to generate JSON to be used inside Excel spreadsheets or another spreadsheet program.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

The license is covered under the file license.md.

In essence, please do not use this software for commercial (for profit) means. This library is provided as is, modifications to the source code are allowed. This is to follow the Wizards of the Coast's (WotC) Fan Content Policy. All modifications should be done in accordance with the WotC Fan Content Policy.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mtg_scryfall_grabber-1.0.0.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

mtg_scryfall_grabber-1.0.0-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file mtg_scryfall_grabber-1.0.0.tar.gz.

File metadata

  • Download URL: mtg_scryfall_grabber-1.0.0.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.17

File hashes

Hashes for mtg_scryfall_grabber-1.0.0.tar.gz
Algorithm Hash digest
SHA256 2a743a90394a0ab5063ae87a47740950cc0e9530777b057072fcc97c023c5c4c
MD5 3ea3396d87d4fb2aee0f17e08baf1258
BLAKE2b-256 ba55f3844c5fb0e093b7468a4ea2d1d2bf84584eeb30c58e5c709bd5fa836d41

See more details on using hashes here.

Provenance

File details

Details for the file mtg_scryfall_grabber-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mtg_scryfall_grabber-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e34b20f0173a80deca68b4ef3f13f7b1deed9c5c8d0a15b36d109189036344c8
MD5 769944927c2f04a8f0a3c01900b364cb
BLAKE2b-256 cb08862b3d2226721e08759a9237be6fc4eff9dde3e45a1d95b4f16b1dfa0ce2

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page