monorail
/
Scrython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Scrython/docs/Cards.md

180 lines
8.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Cards
Documentation for a card object. These docs will likely not be as detailed as the official Scryfall Documentation, and you should reference that for more information.
>In the event that a key isn't found or has been changed, you can access the full JSON output with the `scryfallJson` variable (`card.scryfallJson`).
## Attributes
All attributes are listed assuming the following
`card = scrython.cards.<Class>()` is the current usage.
|Name|Data type returned|Description|
|:---:|:---:|:---:|
|`card.object()`|String | Returns the type of object it is. (card, error, etc)
|`card.id()`|String | The scryfall id of the card.
|`card.multiverse_ids()`|List | The associated multiverse ids of the card.
|`card.mtgo_id()`|Integer | The Magic Online id of the card.
|`card.mtgo_foil_id()`|Integer | The Magic Online foil id of the card.
|`card.name()`|String | The full name of the card. Cards with multiple faces are named with '//' as a seperator.
|`card.uri()`|String | The Scryfall API uri for the card.
|`card.scryfall_uri()`|String | The full Scryfall page of the card.
|`card.layout()`|String | The image layout of the card. (normal, transform, etc)
|`card.highres_image()`|Bool | Returns True if the card has a high res image.
|`card.image_uris()`|Dict | All image uris of the card in various qualities.
|`card.cmc()`|float | A float of the converted mana cost of the card.
|`card.type_line()`|String | The full type line of the card.
|`card.oracle_text()`|String | The official oracle text of a card.
|`card.mana_cost()`|String | The full mana cost using shorthanded mana symbols.
|`card.colors()`|List | An array of strings with all colors found in the mana cost.
|`card.color_identity()`|List | An array of strings with all colors found on the card itself.
|`card.legalities()`|Dict | A dictionary of all formats and their legality.
|`card.reserved()`|Bool | Returns True if the card is on the reserved list.
|`card.reprint()`|Bool | Returns True if the card has been reprinted before.
|`card.set_code()`|String | The 3 letter code for the set of the card.
|`card.set_name()`|String | The full name for the set of the card.
|`card.set_uri()`|String | The API uri for the full set list of the card.
|`card.set_search_uri()`|String | Same output as set_uri.
|`card.scryfall_set_uri()`|String | The full link to the set on Scryfall.
|`card.rulings_uri()`|String | The API uri for the rulings of the card.
|`card.prints_search_uri()`|String | A link to where you can begin paginating all re/prints for this card on Scryfall’s API.
|`card.collector_number()`|String | The collector number of the card.
|`card.digital()`|Bool | Returns True if the card is the digital version.
|`card.rarity()`|String | The rarity of the card.
|`card.illuStringation_id()`|String | The related id of the card art.
|`card.artist()`|String | The artist of the card.
|`card.frame()`|String | The year of the card frame.
|`card.full_art()`|Bool | Returns True if the card is considered full art.
|`card.border_color()`|String | The color of the card border.
|`card.timeshifted()`|Bool | Returns True if the card is timeshifted.
|`card.colorshifted()`|Bool | Returns True if the card is colorshifted.
|`card.futureshifted()`|Bool | Returns True if the card is futureshifted.
|`card.edhrec_rank()`|Integer | The rank of the card on edhrec.com
|`card.currency("<mode>")`|String | Takes an argument for a currency, then returns a string of that value. (`currency("usd")>>"1.35"`). Current modes are `usd`, `eur`, and `tix`.
|`card.related_uris()`|Dict | A dictionary of related websites for this card.
|`card.purchase_uris()`|Dict | A dictionary of links to purchase the card.
|`card.life_modifier()`|String | This is the cards life modifier value, assuming it's a Vanguard card.
|`card.hand_modifier()`|String | This cards hand modifier value, assuming it's a Vanguard card.
|`card.color_indicator()`|List | An array of all colors found in this card's color indicator.
|`card.all_parts()`|List | This this card is closely related to other cards, this property will be an array with it.
|`card.card_faces()`|List | If it exists, all parts found on a card's face will be found as an object from this array.
|`card.watermark()`|String | The associated watermark of the card, if any.
|`card.story_spotlight_number()`|Integer | This card's story spotlight number, if any.
|`card.story_spotlight_uri()`|String | The URI for the card's story article, if any.
|`card.power()`|String| The power of the creature, if applicable.
|`card.toughness()`|String| The toughness of the creature, if applicable.
|`card.flavor_text()`|String| The flavor text of the card, if any.
|`card.arena_id()`|Integer| The Arena ID of the card, if any.
|`card.lang()`|String| The language of the card.
|`card.printed_name()`|String| If the card is in a non-English language, this will be the name as it appears on the card.
|`card.printed_type_line()`|String| If the card is in a non-English language, this will be the type line as it appears on the card.
|`card.printed_text()`|String| If the card is in a non-English language, this will be the rules text as it appears on the card.
## *class* `cards.Named()`
Gets a card by the name.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
| :---: | :---: | :---: |:---: |
|fuzzy|Yes|string|Uses the fuzzy parameter for the card name.|
|exact|Yes|string|Uses the exact parameter for the card name.|
|set|No|string|Returns the set of the card if specified. If not the card edition will be the most recent printing. Requires the 3 letter set code.
>Since the `/cards/named` endpoint specifically requires the fuzzy or exact markers, they are required to be explicitly denoted.
## *class* `cards.Random()`
Get a random card.
**Parameters:**
No parameters are required.
## *class* `cards.Multiverse()`
Get a card by Multiverse id
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|id|Yes|Integer or String| This is the associated multiverse id of the given card.
## *class* `cards.Mtgo()`
Get a card by MTGO id.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|id|Yes|String|The required mtgo id of the card.
## *class* `cards.Collector()`
Get a card by collector number.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|code|Yes|String|This is the 3 letter code for the set|
|collector_number|Yes|String|This is the collector number of the card.|
|lang|No|String|A 2-3 letter that denotes to what language you want. Defaults to `en` if not specified.|
## *class* `cards.Id()`
Get a card by the Scryfall id.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|id|Yes|String|The Scryfall Id of the card.|
## *class* `cards.Autocomplete()`
Get a list of potential autocompletion phrases.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|q|Yes|String| The query of the autocompletion.|
**Attributes:**
|Name|Output Type|Description|
|:--:|:--:|:--:|
|`object()`|String|Returns what kind of object it is.|
|`total_items()`|Integer|How many items are in the list.|
|`data()`|List|The list of potential autocompletes.|
## *class* `cards.Search()`
Uses a search query to gather relevant data.
**Parameters:**
| Param |Required [y/n]| Input type | Function |
|:---:|:---:|:---:|:---:|
|`q`|Yes|String| The query to search. This will be updated in the future.|
|`order`|No|String| The order you'd like the data returned.|
|`unique`|No|String|A way to filter similar cards.|
|`dir`|No|String|The direction you'd like to sort. (`asc`, `desc`, `auto`)|
|`include_extras`|No|Boolean|Includes cards that are normally omitted from search results, like Un-sets.|
|`page`|No|Integer|The page number you'd like to search, if any.|
**Attributes:**
|Name|Output Type|Description|
|:--:|:--:|:--:|
|`object()`|String|Returns what kind of object it is.|
|`total_cards()`|Integer|How many cards are returned from the query.|
|`data()`|List|The list of potential autocompletes.|
|`has_more()`|Boolean|True if there is more than 1 page of results.|
|`next_page()`|String|The API URI to the next page of the query.|
|`warnings()`|List| Provides an array of errors, if any.|
|`data_length()`|Integer| The length of the data returned.|
|`data_tuple()`|Dict| Accesses an object at the specified index.|
Reference in New Issue View Git Blame Copy Permalink