# Stanza Python SDK
Stanza is a developer-first tool for increasing reliability based on prioritized traffic management, quota allocation, and rate-limiting. On the back-end, it helps prevent downtime related to overload and excessive use of third-party APIs. On the front-end, it helps segment and weight your traffic, react automatically to overload or other conditions, and inspect the state of your critical user journeys.
"Stanza Python SDK" provides higher-order functions (["guards"](https://docs.dev.getstanza.dev/glossary#guard)) for adding this fault tolerance to your python 3.9+ application.
## Installation
The SDK is available on the Python Package Index (PyPI). You can install them via pip with the following command:
```shell
pip install getstanza
```
## Configuration
To use `sdk-python`, you'll need to import the `getstanza` package and initialize it with a [Stanza API Key](https://docs.dev.getstanza.dev/dashboard/administration/keys) and other options.
If not specified in the SDK initialization, the API Key, Service Name, Service Release, and Environment are read from the environment variables `STANZA_API_KEY`, `STANZA_SERVICE_NAME`, `STANZA_SERVICE_RELEASE`, and `STANZA_ENVIRONMENT`, respectively.
For more information, see the [Initialize Stanza section of our Python SDK documentation](https://docs.dev.getstanza.dev/gettingstarted/serversdk/python#initialize-stanza).
## Usage
The SDK supports weighted, prioritized, global rate limiting which is externally managed by the [Stanza Dashboard](https://docs.dev.getstanza.dev/dashboard).
The [samples/fastapi](./samples/fastapi) directory is a good place to start! (It's an example application which shows how to wrap inbound and outbound HTTP traffic with [Stanza Guards](https://docs.dev.getstanza.dev/configuration/guards).)
Or browse the [Official Stanza Documentation](https://docs.dev.getstanza.dev/) for more info on how to get started.
## Community
Join [Stanza's Community Discord](https://discord.gg/5feHXQam) to get involved and help us improve the SDK!
Raw data
{
"_id": null,
"home_page": "http://www.stanza.systems",
"name": "getstanza",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "fault-tolerance,traffic,traffic-control,stanza",
"author": "Stanza Systems",
"author_email": "hello@sre.is",
"download_url": "https://files.pythonhosted.org/packages/9f/e9/83b88ff230c7d2fcfbf89fea35ee3daa6ae7ac69d37247308936dbe215a0/getstanza-0.0.2b1.tar.gz",
"platform": null,
"description": "# Stanza Python SDK\n\nStanza is a developer-first tool for increasing reliability based on prioritized traffic management, quota allocation, and rate-limiting. On the back-end, it helps prevent downtime related to overload and excessive use of third-party APIs. On the front-end, it helps segment and weight your traffic, react automatically to overload or other conditions, and inspect the state of your critical user journeys.\n\n\"Stanza Python SDK\" provides higher-order functions ([\"guards\"](https://docs.dev.getstanza.dev/glossary#guard)) for adding this fault tolerance to your python 3.9+ application.\n\n## Installation\n\nThe SDK is available on the Python Package Index (PyPI). You can install them via pip with the following command:\n\n```shell\npip install getstanza\n```\n \n## Configuration\n\nTo use `sdk-python`, you'll need to import the `getstanza` package and initialize it with a [Stanza API Key](https://docs.dev.getstanza.dev/dashboard/administration/keys) and other options.\n\nIf not specified in the SDK initialization, the API Key, Service Name, Service Release, and Environment are read from the environment variables `STANZA_API_KEY`, `STANZA_SERVICE_NAME`, `STANZA_SERVICE_RELEASE`, and `STANZA_ENVIRONMENT`, respectively.\n\nFor more information, see the [Initialize Stanza section of our Python SDK documentation](https://docs.dev.getstanza.dev/gettingstarted/serversdk/python#initialize-stanza).\n\n## Usage\n\nThe SDK supports weighted, prioritized, global rate limiting which is externally managed by the [Stanza Dashboard](https://docs.dev.getstanza.dev/dashboard).\n\nThe [samples/fastapi](./samples/fastapi) directory is a good place to start! (It's an example application which shows how to wrap inbound and outbound HTTP traffic with [Stanza Guards](https://docs.dev.getstanza.dev/configuration/guards).)\n\nOr browse the [Official Stanza Documentation](https://docs.dev.getstanza.dev/) for more info on how to get started.\n\n## Community\n\nJoin [Stanza's Community Discord](https://discord.gg/5feHXQam) to get involved and help us improve the SDK!",
"bugtrack_url": null,
"license": "",
"summary": "Python SDK for adding Stanza Systems fault tolerance to your python 3 service.",
"version": "0.0.2b1",
"project_urls": {
"Homepage": "http://www.stanza.systems",
"Repository": "https://github.com/StanzaSystems/sdk-python"
},
"split_keywords": [
"fault-tolerance",
"traffic",
"traffic-control",
"stanza"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d6bbc4f0143a1597e2ebcb2cfc85bd28b21b9c55abc9edc04194e1f1b7f5fc6",
"md5": "2b2666788ddd9ea7eb634164c857610d",
"sha256": "d2cb627c13b956f81defef2d52e8c15f122c4e60ce1064580f7b6e9284eb77dc"
},
"downloads": -1,
"filename": "getstanza-0.0.2b1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b2666788ddd9ea7eb634164c857610d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 27411,
"upload_time": "2024-02-26T19:15:52",
"upload_time_iso_8601": "2024-02-26T19:15:52.545781Z",
"url": "https://files.pythonhosted.org/packages/4d/6b/bc4f0143a1597e2ebcb2cfc85bd28b21b9c55abc9edc04194e1f1b7f5fc6/getstanza-0.0.2b1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9fe983b88ff230c7d2fcfbf89fea35ee3daa6ae7ac69d37247308936dbe215a0",
"md5": "62d5ed5a4a913a2eb06d73fd2d23e1c8",
"sha256": "a8c349ae5ed0c240cd8fd81d1b52039e300891c069456cccbc225af616b57927"
},
"downloads": -1,
"filename": "getstanza-0.0.2b1.tar.gz",
"has_sig": false,
"md5_digest": "62d5ed5a4a913a2eb06d73fd2d23e1c8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 20983,
"upload_time": "2024-02-26T19:15:54",
"upload_time_iso_8601": "2024-02-26T19:15:54.439959Z",
"url": "https://files.pythonhosted.org/packages/9f/e9/83b88ff230c7d2fcfbf89fea35ee3daa6ae7ac69d37247308936dbe215a0/getstanza-0.0.2b1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-26 19:15:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "StanzaSystems",
"github_project": "sdk-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "getstanza"
}
JSON
