Updated all other docstrings to let doc_gen work properly
This commit is contained in:
parent
ff51762b8a
commit
9a5a5600d8
|
@ -1,42 +0,0 @@
|
||||||
# **class** `Autocomplete()`
|
|
||||||
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 (`{Class_name}().scryfallJson`).
|
|
||||||
|cards/autocomplete|
|
|
||||||
|Get a list of potential autocompletion phrases.|
|
|
||||||
|
|
||||||
## Args
|
|
||||||
|
|
||||||
| arg | description |
|
|
||||||
|:---:|:---:|
|
|
||||||
|q (string):
|
|
||||||
|The query of the autocompletion.|
|
|
||||||
|format (string, optional):
|
|
||||||
|Defaults to 'json'.|
|
|
||||||
|Returns data in the specified method.|
|
|
||||||
|face (string, optional):
|
|
||||||
|Defaults to empty string.|
|
|
||||||
|If you're using the `image` format,|
|
|
||||||
|this will specify if you want the front or back face.|
|
|
||||||
|version (string, optional):
|
|
||||||
|Defaults to empty string.|
|
|
||||||
|If you're using the `image` format, this will specify|
|
|
||||||
|if you want the small, normal, large, etc version of the image.|
|
|
||||||
|pretty (string, optional):
|
|
||||||
|Defaults to empty string.|
|
|
||||||
|Returns a prettier version of the json object.|
|
|
||||||
|Note that this may break functionality with Scrython.|
|
|
||||||
|
|
||||||
## Raises
|
|
||||||
|
|
||||||
| arg | description |
|
|
||||||
|:---:|:---:|
|
|
||||||
|Exception: If the 'q' parameter is not provided.|
|
|
||||||
|Exception: If the object returned is an error.|
|
|
||||||
|
|
||||||
## Example usage
|
|
||||||
|
|
||||||
| arg | description |
|
|
||||||
|:---:|:---:|
|
|
||||||
|>>> auto = scrython.cards.Autocomplete(q="Thal")|
|
|
||||||
|>>> auto.total_items()|
|
|
|
@ -10,14 +10,19 @@ class BulkData(FoundationObject):
|
||||||
"""
|
"""
|
||||||
/bulk-data
|
/bulk-data
|
||||||
Queries and creates an object relating to the /bulk-data endpoint.
|
Queries and creates an object relating to the /bulk-data endpoint.
|
||||||
|
|
||||||
Raises:
|
Args:
|
||||||
Exception: Raised if Scryfall sends an error object.
|
N/A
|
||||||
KeyError: Raised if you attempt to access a key that doesn't exist.
|
|
||||||
KeyError: Raise if you attempt to access a tuple key that doesn't exist.
|
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
object: The Scryfall endpoint object.
|
object: The Scryfall endpoint object.
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
Exception: Raised if Scryfall sends an error object.
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
>>> data = scrython.bulk_data.BulkData()
|
||||||
|
>>> data.bulk_compressed_size()
|
||||||
"""
|
"""
|
||||||
def __init__(self, **kwargs):
|
def __init__(self, **kwargs):
|
||||||
|
|
||||||
|
|
|
@ -23,11 +23,14 @@ class ArenaId(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'id' parameter is not provided.
|
Exception: If the 'id' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
||||||
Example usage:
|
Examples:
|
||||||
>>> card = scrython.cards.ArenaId(id="66975")
|
>>> card = scrython.cards.ArenaId(id="66975")
|
||||||
>>> card.name()
|
>>> card.name()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -27,11 +27,14 @@ class Autocomplete(FoundationObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'q' parameter is not provided.
|
Exception: If the 'q' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
||||||
Example usage:
|
Examples:
|
||||||
>>> auto = scrython.cards.Autocomplete(q="Thal")
|
>>> auto = scrython.cards.Autocomplete(q="Thal")
|
||||||
>>> auto.total_items()
|
>>> auto.total_items()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -23,6 +23,9 @@ class Id(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'id' parameter is not provided.
|
Exception: If the 'id' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
|
@ -10,6 +10,9 @@ class Collector(CardsObject):
|
||||||
collector_number (string): This is the collector number of the card
|
collector_number (string): This is the collector number of the card
|
||||||
lang (string, optional): Defaults to 'en'. A 2-3 character language code.
|
lang (string, optional): Defaults to 'en'. A 2-3 character language code.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'code' parameter is not provided.
|
Exception: If the 'code' parameter is not provided.
|
||||||
Exception: If the 'collector_number' parameter is not provided.
|
Exception: If the 'collector_number' parameter is not provided.
|
||||||
|
|
|
@ -24,6 +24,9 @@ class Mtgo(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'id' parameter is not provided.
|
Exception: If the 'id' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
|
@ -23,6 +23,9 @@ class Multiverse(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'id' parameter is not provided.
|
Exception: If the 'id' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
|
@ -28,6 +28,9 @@ class Named(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'fuzzy' or 'exact' parameter is not provided.
|
Exception: If the 'fuzzy' or 'exact' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
|
@ -23,6 +23,9 @@ class Random(CardsObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
||||||
|
|
|
@ -46,6 +46,9 @@ class Search(FoundationObject):
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
Exception: If the 'q' parameter is not provided.
|
Exception: If the 'q' parameter is not provided.
|
||||||
Exception: If the object returned is an error.
|
Exception: If the object returned is an error.
|
||||||
|
|
|
@ -6,7 +6,16 @@ class ArtifactTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known artifact types
|
Catalog object for all known artifact types
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.ArtifactTypes()
|
>>> catalog = scrython.catalog.ArtifactTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class ArtistNames(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known card names.
|
Catalog object for all known card names.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.CardNames()
|
>>> catalog = scrython.catalog.CardNames()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class CardNames(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known card names.
|
Catalog object for all known card names.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.CardNames()
|
>>> catalog = scrython.catalog.CardNames()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -14,6 +14,15 @@ class CatalogsObject(FoundationObject):
|
||||||
Defaults to empty string.
|
Defaults to empty string.
|
||||||
Returns a prettier version of the json object.
|
Returns a prettier version of the json object.
|
||||||
Note that this may break functionality with Scrython.
|
Note that this may break functionality with Scrython.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
N/A
|
||||||
"""
|
"""
|
||||||
|
|
||||||
def object(self):
|
def object(self):
|
||||||
|
|
|
@ -6,7 +6,16 @@ class CreatureTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known creature types.
|
Catalog object for all known creature types.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.CreatureTypes()
|
>>> catalog = scrython.catalog.CreatureTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class EnchantmentTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known enchantment types.
|
Catalog object for all known enchantment types.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.EnchantmentTypes()
|
>>> catalog = scrython.catalog.EnchantmentTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class LandTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known land types.
|
Catalog object for all known land types.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.LandTypes()
|
>>> catalog = scrython.catalog.LandTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class Loyalties(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known starting loyalties.
|
Catalog object for all known starting loyalties.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.Loyalties()
|
>>> catalog = scrython.catalog.Loyalties()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class PlaneswalkerTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known planeswalker types.
|
Catalog object for all known planeswalker types.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.PlaneswalkerTypes()
|
>>> catalog = scrython.catalog.PlaneswalkerTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class Powers(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known powers.
|
Catalog object for all known powers.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.Powers()
|
>>> catalog = scrython.catalog.Powers()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class SpellTypes(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known spell types.
|
Catalog object for all known spell types.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.SpellTypes()
|
>>> catalog = scrython.catalog.SpellTypes()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class Toughnesses(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known toughnesses.
|
Catalog object for all known toughnesses.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.Toughnesses()
|
>>> catalog = scrython.catalog.Toughnesses()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class Watermarks(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known watermarks.
|
Catalog object for all known watermarks.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.Watermarks()
|
>>> catalog = scrython.catalog.Watermarks()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
|
@ -6,7 +6,16 @@ class WordBank(CatalogsObject):
|
||||||
|
|
||||||
Catalog object for all known words on all cards.
|
Catalog object for all known words on all cards.
|
||||||
|
|
||||||
Example usage:
|
Args:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
N/A
|
||||||
|
|
||||||
|
Examples:
|
||||||
>>> catalog = scrython.catalog.WordBank()
|
>>> catalog = scrython.catalog.WordBank()
|
||||||
>>> catalog.data()
|
>>> catalog.data()
|
||||||
"""
|
"""
|
||||||
|
|
Loading…
Reference in New Issue