docs: updated documentation
This commit is contained in:
parent
adfe6de1cf
commit
c5c28b4c4b
5 changed files with 18 additions and 8 deletions
|
@ -10,7 +10,7 @@ There has not been an official release of PyZipline on PyPi yet, meaning these i
|
||||||
attrs: {class: annotate}
|
attrs: {class: annotate}
|
||||||
**Please make sure to install the matching version of PyZipline for your Zipline version!**
|
**Please make sure to install the matching version of PyZipline for your Zipline version!**
|
||||||
This documentation assumes you are using Zipline `3.7.7`.
|
This documentation assumes you are using Zipline `3.7.7`.
|
||||||
If you are not, please change all occurrances of `3.7.7` to your Zipline version.
|
If you are not, please see [Versioning](./versioning.md) for a list of supported versions.
|
||||||
If you're on [Zipline's `trunk` version](https://github.com/diced/zipline/tree/trunk), use `*` to get the latest versions of PyZipline. (1)
|
If you're on [Zipline's `trunk` version](https://github.com/diced/zipline/tree/trunk), use `*` to get the latest versions of PyZipline. (1)
|
||||||
///
|
///
|
||||||
|
|
||||||
|
@ -24,13 +24,13 @@ The command to use differs slightly depending on what OS/Distro you use.
|
||||||
On Windows:
|
On Windows:
|
||||||
|
|
||||||
``` prolog title="Command Prompt"
|
``` prolog title="Command Prompt"
|
||||||
py -m pip install pyzipline=3.7.7
|
py -m pip install pyzipline=0.1.0
|
||||||
```
|
```
|
||||||
|
|
||||||
On macOS and Linux:
|
On macOS and Linux:
|
||||||
|
|
||||||
``` prolog title="Bash"
|
``` prolog title="Bash"
|
||||||
python3 -m pip install pyzipline=3.7.7
|
python3 -m pip install pyzipline=0.1.0
|
||||||
```
|
```
|
||||||
|
|
||||||
## Poetry
|
## Poetry
|
||||||
|
@ -39,12 +39,12 @@ You can also use [Poetry](https://python-poetry.org/) to store your dependencies
|
||||||
Use the following command to install PyZipline:
|
Use the following command to install PyZipline:
|
||||||
|
|
||||||
``` prolog title="Command Prompt / Shell"
|
``` prolog title="Command Prompt / Shell"
|
||||||
poetry add pyzipline=3.7.7
|
poetry add pyzipline=0.1.0
|
||||||
```
|
```
|
||||||
|
|
||||||
Or, you can add PyZipline to your `pyproject.toml` file manually:
|
Or, you can add PyZipline to your `pyproject.toml` file manually:
|
||||||
|
|
||||||
``` toml title="pyproject.toml"
|
``` toml title="pyproject.toml"
|
||||||
[tool.poetry.dependencies]
|
[tool.poetry.dependencies]
|
||||||
pyzipline = "3.7.7"
|
pyzipline = "0.1.0"
|
||||||
```
|
```
|
||||||
|
|
7
docs/getting-started/versioning.md
Normal file
7
docs/getting-started/versioning.md
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
# Versioning
|
||||||
|
|
||||||
|
Below is a table containing versions of Zipline, alongside their respective PyZipline versions.
|
||||||
|
|
||||||
|
| PyZipline Versions | Zipline Versions | Supported | Security Fixes |
|
||||||
|
| :----------------: | :--------------: | :----------------------: | :-----------------------: |
|
||||||
|
| `0.1.0` | `3.7.7` | :white_check_mark: | :white_check_mark: |
|
|
@ -13,6 +13,7 @@ nav:
|
||||||
- Getting Started:
|
- Getting Started:
|
||||||
- Installation: getting-started/installation.md
|
- Installation: getting-started/installation.md
|
||||||
- Usage: getting-started/usage.md
|
- Usage: getting-started/usage.md
|
||||||
|
- Versioning: getting-started/versioning.md
|
||||||
- Reference:
|
- Reference:
|
||||||
- ZiplineApi: ref/zipline.md
|
- ZiplineApi: ref/zipline.md
|
||||||
- Utilities: ref/utils.md
|
- Utilities: ref/utils.md
|
||||||
|
@ -44,6 +45,7 @@ markdown_extensions:
|
||||||
- abbr
|
- abbr
|
||||||
- attr_list
|
- attr_list
|
||||||
- md_in_html
|
- md_in_html
|
||||||
|
- tables
|
||||||
- pymdownx.blocks.details
|
- pymdownx.blocks.details
|
||||||
- pymdownx.blocks.admonition
|
- pymdownx.blocks.admonition
|
||||||
- pymdownx.saneheaders
|
- pymdownx.saneheaders
|
||||||
|
@ -57,8 +59,8 @@ markdown_extensions:
|
||||||
line_spans: __span
|
line_spans: __span
|
||||||
pygments_lang_class: true
|
pygments_lang_class: true
|
||||||
- pymdownx.emoji:
|
- pymdownx.emoji:
|
||||||
emoji_index: !!python/name:pymdownx.emoji.twemoji
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
||||||
emoji_generator: !!python/name:pymdownx.emoji.to_svg
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
||||||
|
|
||||||
theme:
|
theme:
|
||||||
name: material
|
name: material
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
[tool.poetry]
|
[tool.poetry]
|
||||||
name = "pyzipline"
|
name = "pyzipline"
|
||||||
version = "3.7.7"
|
version = "0.1.0"
|
||||||
description = "Python API Wrapper for the Zipline API"
|
description = "Python API Wrapper for the Zipline API"
|
||||||
authors = ["SeaswimmerTheFsh <seaswimmerthefsh@gmail.com>"]
|
authors = ["SeaswimmerTheFsh <seaswimmerthefsh@gmail.com>"]
|
||||||
license = "GNU GPLv3"
|
license = "GNU GPLv3"
|
||||||
|
|
|
@ -112,6 +112,7 @@ class ZiplineApi:
|
||||||
///
|
///
|
||||||
|
|
||||||
Raises:
|
Raises:
|
||||||
|
Forbidden: The user is not authenticated
|
||||||
PyZiplineError: Raised if the API changes, causing a breaking change in this method
|
PyZiplineError: Raised if the API changes, causing a breaking change in this method
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
|
|
Loading…
Reference in a new issue