Updated all other docstrings to let doc_gen work properly

This commit is contained in:
Nanda Scott 2018-10-26 17:24:34 -04:00
parent ff51762b8a
commit 9a5a5600d8
25 changed files with 179 additions and 63 deletions

View File

@ -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()|

View File

@ -11,13 +11,18 @@ 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):

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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):

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """

View File

@ -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()
""" """