Giter VIP home page Giter VIP logo

mtg-sdk-python's Introduction

Magic: The Gathering SDK

mtg-developers on discord PyPI version Build Status Requirements Status Code Climate Coverage Status

This is the Magic: The Gathering SDK Python implementation. It is a wrapper around the MTG API of magicthegathering.io.

Requirements

Python 3 is currently the only supported version for the sdk. More specifically, the package was developed using Python 3.4.

Installation

Using pip:

pip install mtgsdk

Usage

Import (Card and Set will be most used)

from mtgsdk import Card
from mtgsdk import Set
from mtgsdk import Type
from mtgsdk import Supertype
from mtgsdk import Subtype
from mtgsdk import Changelog

Properties Per Class

Card

name
multiverse_id
layout
names
mana_cost
cmc
colors
color_identity
type
supertypes
subtypes
rarity
text
flavor
artist
number
power
toughness
loyalty
variations
watermark
border
timeshifted
hand
life
reserved
release_date
starter
rulings
foreign_names
printings
original_text
original_type
legalities
source
image_url
set
set_name
id

Set

code
name
gatherer_code
old_code
magic_cards_info_code
release_date
border
type
block
online_only
booster
mkm_id
mkm_name

How to get cards from specific language

Languages

Please note that a card may or may not be available in each language listed below.

Chinese Simplified
Chinese Traditional
French
German
Italian
Japanese
Korean
Portuguese (Brazil)
Russian
Spanish

Card.where(language="your_language").all()
Example:
  card = Card.where(language="Chinese Traditional").all()

Find Card by Multiverse Id

card = Card.find(386616)

Filter Cards via Query Parameters

cards = Card.where(set='ktk').where(subtypes='warrior,human').all()

Get all cards (will page through all the data - could take awhile)

cards = Card.all()

Get all cards, but only a specific page of data

cards = Card.where(page=5).where(pageSize=1000).all()

Find a Set by code

set = Set.find('ktk')

Get all sets

sets = Set.all()

Filter sets via query parameters

sets = Set.where(name='khans').all()

Get all types

types = Type.all()

Get all subtypes

subtypes = Subtype.all()

Get all supertypes

supertypes = Supertype.all()

Development

Install the EditorConfig plugin for your text editor or IDE

Linux

  1. Install dependencies: make setup
  2. Run test suite: make test

Windows

  1. Install dependencies: python setup.py install
  2. Run test suite: python -m unittest discover tests/

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.