Working on automating doc creation.
This commit is contained in:
parent
3bd19ca5a5
commit
1d9b2eb9e1
|
@ -0,0 +1,42 @@
|
|||
# **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()|
|
|
@ -0,0 +1,36 @@
|
|||
import sys
|
||||
import scrython
|
||||
from scrython import *
|
||||
import re
|
||||
|
||||
intro = """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`)."""
|
||||
|
||||
for _class in scrython.__all__:
|
||||
|
||||
match = list(filter(None, (token.strip() for token in re.findall(r'[^\n]*', eval(_class).__doc__))))
|
||||
|
||||
with open('{}.md'.format(eval(_class).__name__), 'w') as f:
|
||||
f.write('# **class** `{}()`\n'.format(eval(_class).__name__))
|
||||
f.write(intro)
|
||||
for token in match:
|
||||
# Match section header
|
||||
if re.findall(r'[A-Z][a-z].*:', token) and ':' in re.findall(r':.*', token):
|
||||
f.write('\n\n## {}\n\n'.format(token.replace(':', '')))
|
||||
if 'Example' in token:
|
||||
f.write()
|
||||
else:
|
||||
f.write('| arg | description |\n|:---:|:---:|')
|
||||
|
||||
# Match args description
|
||||
elif re.findall(r'[\w]+\s\(.+\):', token):
|
||||
if 'Defaults' in token:
|
||||
f.write(token)
|
||||
else:
|
||||
f.write('\n|{}'.format(token))
|
||||
else:
|
||||
f.write('\n|{}|'.format(token))
|
||||
# r'[\w]+\s\(.+\):' Matches anything that's a described parameter
|
||||
# r'[A-Z][a-z](.*)' Matches section titles
|
||||
break
|
|
@ -0,0 +1,23 @@
|
|||
# **class** `{Class_name}()`
|
||||
|
||||
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`).
|
||||
|
||||
## Args
|
||||
|
||||
|arg|description|
|
||||
|:---:|:---:|
|
||||
|{arg} ({type})|{description}|
|
||||
|
||||
## Raises
|
||||
|
||||
|exception type|reason|
|
||||
|:---:|:---:|
|
||||
|{Exception}|{reason}|
|
||||
|
||||
## Example usage
|
||||
|
||||
```
|
||||
{Examples}
|
||||
```
|
Loading…
Reference in New Issue