<div align="center">
# horreum-client-python
<a href="https://horreum.hyperfoil.io/"><img alt="Website" src="https://img.shields.io/website?up_message=live&url=https%3A%2F%2Fhorreum.hyperfoil.io/"></a>
<a href="https://github.com/Hyperfoil/horreum-client-python/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/Hyperfoil/horreum-client-python"></a>
<a href="https://github.com/Hyperfoil/horreum-client-python/fork"><img alt="GitHub forks" src="https://img.shields.io/github/forks/Hyperfoil/horreum-client-python"></a>
<a href="https://github.com/Hyperfoil/horreum-client-python/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/Hyperfoil/horreum-client-python"></a>
<a href="https://github.com/Hyperfoil/horreum-client-python/blob/main/LICENSE"><img alt="GitHub license" src="https://img.shields.io/github/license/Hyperfoil/horreum-client-python"></a>
</div>
---
## What is Horreum Python Client?
Horreum python client is a high-level python library to interact with [Horreum](#what-is-horreum) web server.
The raw client is generated using [kiota](https://github.com/microsoft/kiota) openapi generator tool starting from
the [Horreum OpenAPI spec](https://github.com/Hyperfoil/Horreum/blob/master/docs/site/content/en/openapi/openapi.yaml).
Refer to the [get started guide](docs/GET_STARTED.md) for comprehensive instructions on installing and utilizing this library.
## What is Horreum?
[Horreum](https://github.com/Hyperfoil/Horreum) is a service for storing performance data and regression analysis.
Please, visit our project website:
[https://horreum.hyperfoil.io](https://horreum.hyperfoil.io)
for more information.
[Horreum](https://github.com/Hyperfoil/Horreum) is a [Quarkus](https://quarkus.io/) based application which uses
[Quinoa](https://quarkiverse.github.io/quarkiverse-docs/quarkus-quinoa/dev/) as its [Node.js](https://nodejs.org/en) engine.
This project is about providing a simplified setup and examples to use
[Horreum](https://github.com/Hyperfoil/Horreum) using the [Python](https://www.python.org/) programming language.
## 🧑💻 Contributing
Contributions to `horreum-client-python` Please check our [CONTRIBUTING.md](./CONTRIBUTING.md)
### Development
Install poetry dependency (consider using Python virtual environments):
```bash
pip install --constraint=./dev-constraints.txt poetry
poetry --version
```
Generate source files
```bash
make generate
```
Build the library using `poetry`:
```bash
poetry build
```
#### Tests
Tests can be executed using [nox](https://nox.thea.codes/en/stable/) sessions.
To install it in your local environment, please run:
```bash
pip install --constraint=./dev-constraints.txt nox nox-poetry
nox --version
```
To check available sessions, run:
```bash
nox -l
```
And execute them by running:
```
nox -s <session>
```
Right now integrations tests are not fully automated, therefore you need to start up the Horreum server manually,
you can check more details in [Horreum README](https://github.com/Hyperfoil/Horreum/blob/master/README.md#getting-started-with-development-server).
> **_NOTE_**: The database should be empty to get all tests working
Once the Horreum server is up and running on `localhost:8080`, you can trigger integration tests by running:
```bash
nox -s its
```
### If you have any idea or doubt 👇
* [Ask a question](https://github.com/Hyperfoil/horreum-client-python/discussions)
* [Raise an issue](https://github.com/Hyperfoil/horreum-client-python/issues)
* [Feature request](https://github.com/Hyperfoil/horreum-client-python/issues)
* [Code submission](https://github.com/Hyperfoil/horreum-client-python/pulls)
Contribution is the best way to support and get involved in community !
Please, consult our [Code of Conduct](./CODE_OF_CONDUCT.md) policies for interacting in our
community.
Consider giving the project a [star](https://github.com/Hyperfoil/horreum-client-python/stargazers) on
[GitHub](https://github.com/Hyperfoil/horreum-client-python/) if you find it useful.
## License
[Apache-2.0 license](https://opensource.org/licenses/Apache-2.0)
## Thanks to all the Contributors ❤️
<img src="https://contrib.rocks/image?repo=Hyperfoil/horreum-client-python" />
Raw data
{
"_id": null,
"home_page": "https://github.com/Hyperfoil/horreum-client-python",
"name": "horreum",
"maintainer": "Andrea Lamparelli",
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": "alampare@redhat.com",
"keywords": "horreum, performance, change-detection",
"author": "Andrea Lamparelli",
"author_email": "alampare@redhat.com",
"download_url": "https://files.pythonhosted.org/packages/c2/84/d5c8c58307b19aa7c8ef5063df656b5303084fb3ce613145b3b52aaa9652/horreum-0.13.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# horreum-client-python\n\n<a href=\"https://horreum.hyperfoil.io/\"><img alt=\"Website\" src=\"https://img.shields.io/website?up_message=live&url=https%3A%2F%2Fhorreum.hyperfoil.io/\"></a>\n<a href=\"https://github.com/Hyperfoil/horreum-client-python/issues\"><img alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/Hyperfoil/horreum-client-python\"></a>\n<a href=\"https://github.com/Hyperfoil/horreum-client-python/fork\"><img alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/Hyperfoil/horreum-client-python\"></a>\n<a href=\"https://github.com/Hyperfoil/horreum-client-python/stargazers\"><img alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/Hyperfoil/horreum-client-python\"></a>\n<a href=\"https://github.com/Hyperfoil/horreum-client-python/blob/main/LICENSE\"><img alt=\"GitHub license\" src=\"https://img.shields.io/github/license/Hyperfoil/horreum-client-python\"></a> \n\n</div>\n\n---\n## What is Horreum Python Client?\n\nHorreum python client is a high-level python library to interact with [Horreum](#what-is-horreum) web server.\n\nThe raw client is generated using [kiota](https://github.com/microsoft/kiota) openapi generator tool starting from \nthe [Horreum OpenAPI spec](https://github.com/Hyperfoil/Horreum/blob/master/docs/site/content/en/openapi/openapi.yaml).\n\nRefer to the [get started guide](docs/GET_STARTED.md) for comprehensive instructions on installing and utilizing this library.\n\n## What is Horreum?\n\n[Horreum](https://github.com/Hyperfoil/Horreum) is a service for storing performance data and regression analysis.\n\nPlease, visit our project website: \n\n[https://horreum.hyperfoil.io](https://horreum.hyperfoil.io)\n\nfor more information.\n\n[Horreum](https://github.com/Hyperfoil/Horreum) is a [Quarkus](https://quarkus.io/) based application which uses\n[Quinoa](https://quarkiverse.github.io/quarkiverse-docs/quarkus-quinoa/dev/) as its [Node.js](https://nodejs.org/en) engine.\n\nThis project is about providing a simplified setup and examples to use \n[Horreum](https://github.com/Hyperfoil/Horreum) using the [Python](https://www.python.org/) programming language.\n\n## \ud83e\uddd1\u200d\ud83d\udcbb Contributing\n\nContributions to `horreum-client-python` Please check our [CONTRIBUTING.md](./CONTRIBUTING.md)\n\n### Development\n\nInstall poetry dependency (consider using Python virtual environments):\n```bash\npip install --constraint=./dev-constraints.txt poetry\npoetry --version\n```\n\nGenerate source files\n```bash\nmake generate\n```\n\nBuild the library using `poetry`:\n```bash\npoetry build\n```\n\n#### Tests\nTests can be executed using [nox](https://nox.thea.codes/en/stable/) sessions.\n\nTo install it in your local environment, please run:\n```bash\npip install --constraint=./dev-constraints.txt nox nox-poetry\nnox --version\n```\n\nTo check available sessions, run:\n```bash\nnox -l\n```\n\nAnd execute them by running:\n```\nnox -s <session>\n```\n\nRight now integrations tests are not fully automated, therefore you need to start up the Horreum server manually, \nyou can check more details in [Horreum README](https://github.com/Hyperfoil/Horreum/blob/master/README.md#getting-started-with-development-server).\n\n> **_NOTE_**: The database should be empty to get all tests working\n\nOnce the Horreum server is up and running on `localhost:8080`, you can trigger integration tests by running:\n```bash\nnox -s its\n```\n\n### If you have any idea or doubt \ud83d\udc47\n\n* [Ask a question](https://github.com/Hyperfoil/horreum-client-python/discussions)\n* [Raise an issue](https://github.com/Hyperfoil/horreum-client-python/issues)\n* [Feature request](https://github.com/Hyperfoil/horreum-client-python/issues)\n* [Code submission](https://github.com/Hyperfoil/horreum-client-python/pulls)\n\nContribution is the best way to support and get involved in community !\n\nPlease, consult our [Code of Conduct](./CODE_OF_CONDUCT.md) policies for interacting in our\ncommunity.\n\nConsider giving the project a [star](https://github.com/Hyperfoil/horreum-client-python/stargazers) on\n[GitHub](https://github.com/Hyperfoil/horreum-client-python/) if you find it useful.\n\n## License\n\n[Apache-2.0 license](https://opensource.org/licenses/Apache-2.0)\n\n## Thanks to all the Contributors \u2764\ufe0f\n\n<img src=\"https://contrib.rocks/image?repo=Hyperfoil/horreum-client-python\" />\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Horreum python library",
"version": "0.13",
"project_urls": {
"Homepage": "https://github.com/Hyperfoil/horreum-client-python",
"Issues": "https://github.com/Hyperfoil/horreum-client-python/issues"
},
"split_keywords": [
"horreum",
" performance",
" change-detection"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eb1b57b88bca25d1e6c8bfc21d9c8f59df629a975cddfec4e48cdfe2eaf69764",
"md5": "b8dfe86685de5db0a021cb8a301087ca",
"sha256": "40b8c3334ebabff1057fec4d8fb7020dffc066171f4d6f0ce9aefb75fc69d8eb"
},
"downloads": -1,
"filename": "horreum-0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b8dfe86685de5db0a021cb8a301087ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 212837,
"upload_time": "2024-05-01T10:21:52",
"upload_time_iso_8601": "2024-05-01T10:21:52.753026Z",
"url": "https://files.pythonhosted.org/packages/eb/1b/57b88bca25d1e6c8bfc21d9c8f59df629a975cddfec4e48cdfe2eaf69764/horreum-0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c284d5c8c58307b19aa7c8ef5063df656b5303084fb3ce613145b3b52aaa9652",
"md5": "1d1bc698ca31360cb4b50130cff0e4df",
"sha256": "5dd014ab068c73fa572d07fc2ea5cd951509fa5ec32ac46ea07bd5a89ca329e5"
},
"downloads": -1,
"filename": "horreum-0.13.tar.gz",
"has_sig": false,
"md5_digest": "1d1bc698ca31360cb4b50130cff0e4df",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 54812,
"upload_time": "2024-05-01T10:21:53",
"upload_time_iso_8601": "2024-05-01T10:21:53.944140Z",
"url": "https://files.pythonhosted.org/packages/c2/84/d5c8c58307b19aa7c8ef5063df656b5303084fb3ce613145b3b52aaa9652/horreum-0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-01 10:21:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Hyperfoil",
"github_project": "horreum-client-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "horreum"
}