[](https://scm-compliance-api.radix.equinor.com/repos/equinor/117c00d4-fc77-4406-8e47-e616d0d84b62/badge)
# Gordo client
# Table of Contents
* [Installation](#Installation)
* [Developers Instructions](#Developers-Instructions)
* [Setup](#Setup)
* [Pre-commit](#Pre-commit)
* [Run tests](#Run-tests)
* [Contributing](#Contributing)
---
Client for [Gordo](https://github.com/equinor/gordo) project.
[Documentation is available on Read the Docs](https://gordo-client.readthedocs.io/)
## Installation
At least python 3.9 need to be installed in the system first.
In order to install or uninstall this library run following commands.
```bash
# Install
pip install gordo-client
# Uninstall
pip uninstall gordo-client
```
## Developers Instructions
### Setup
Install [poetry](https://python-poetry.org/docs/#installation).
Setup and run development shell instance:
```console
> poetry install
> poetry shell
```
You could also install and apply [pre-commit](https://pre-commit.com/#usage) hooks.
Run `poetry install` to install or re-install all dependencies.
Run `poetry update` to update the locked dependencies to the most recent
version, honoring the constrains put inside `pyproject.toml`.
### Pre-commit
You could also install and apply [pre-commit](https://pre-commit.com/#usage) hooks.
### Run tests
Install [docker](https://docs.docker.com/engine/install/) (or similar container manager) if you want to run test-suite.
Run tests (except docker-related ones):
```console
> poetry run pytest -n auto -m "not dockertest"
```
Run docker-related tests:
```console
> poetry run pytest -m "dockertest"
```
## Contributing
We welcome contributions to this project! To get started, please follow these steps:
1. Fork this repository to your own GitHub account and then clone it to your local device.
```
git clone https://github.com/your-account/your-project.git
```
2. Create a new branch for your feature or bug fix.
```
git checkout -b your-feature-or-bugfix-branch
```
3. Make your changes and commit them with a descriptive message.
```
git commit -m "Add a new feature" -a
```
4. Push your changes to your forked repository.
```
git push origin your-feature-or-bugfix-branch
```
5. Open a pull request in this repository and describe the changes you made.
We'll review your changes and work with you to get them merged into the main branch of the project.
Raw data
{
"_id": null,
"home_page": "https://github.com/equinor/gordo-client",
"name": "gordo-client",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "gordo-client",
"author": "Equinor ASA",
"author_email": "fg_gpl@equinor.com",
"download_url": null,
"platform": null,
"description": "[](https://scm-compliance-api.radix.equinor.com/repos/equinor/117c00d4-fc77-4406-8e47-e616d0d84b62/badge)\n\n# Gordo client\n\n# Table of Contents\n* [Installation](#Installation)\n* [Developers Instructions](#Developers-Instructions)\n\t* [Setup](#Setup)\n\t* [Pre-commit](#Pre-commit)\n\t* [Run tests](#Run-tests)\n* [Contributing](#Contributing)\n\n---\n\nClient for [Gordo](https://github.com/equinor/gordo) project.\n\n[Documentation is available on Read the Docs](https://gordo-client.readthedocs.io/)\n\n## Installation\n\nAt least python 3.9 need to be installed in the system first.\n\nIn order to install or uninstall this library run following commands.\n```bash\n# Install\npip install gordo-client\n\n# Uninstall\npip uninstall gordo-client\n```\n\n## Developers Instructions\n\n### Setup\n\nInstall [poetry](https://python-poetry.org/docs/#installation).\n\nSetup and run development shell instance:\n\n```console\n> poetry install\n> poetry shell\n```\n\nYou could also install and apply [pre-commit](https://pre-commit.com/#usage) hooks.\n\nRun `poetry install` to install or re-install all dependencies.\n\nRun `poetry update` to update the locked dependencies to the most recent\nversion, honoring the constrains put inside `pyproject.toml`.\n\n### Pre-commit\n\nYou could also install and apply [pre-commit](https://pre-commit.com/#usage) hooks.\n\n### Run tests\n\nInstall [docker](https://docs.docker.com/engine/install/) (or similar container manager) if you want to run test-suite.\n\nRun tests (except docker-related ones):\n\n```console\n> poetry run pytest -n auto -m \"not dockertest\"\n```\n\nRun docker-related tests:\n```console\n> poetry run pytest -m \"dockertest\"\n```\n\n## Contributing\nWe welcome contributions to this project! To get started, please follow these steps:\n\n1. Fork this repository to your own GitHub account and then clone it to your local device.\n\n```\ngit clone https://github.com/your-account/your-project.git\n```\n\n2. Create a new branch for your feature or bug fix.\n\n```\ngit checkout -b your-feature-or-bugfix-branch\n```\n\n3. Make your changes and commit them with a descriptive message.\n\n```\ngit commit -m \"Add a new feature\" -a\n```\n\n4. Push your changes to your forked repository.\n\n```\ngit push origin your-feature-or-bugfix-branch\n```\n\n5. Open a pull request in this repository and describe the changes you made.\n\nWe'll review your changes and work with you to get them merged into the main branch of the project.\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "Gordo client",
"version": "6.3.0",
"project_urls": {
"Homepage": "https://github.com/equinor/gordo-client",
"Repository": "https://github.com/equinor/gordo-client"
},
"split_keywords": [
"gordo-client"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b3c85748dfd4fb4dcabad9b7bf8f2e862542274889d3f6753e87c32def01dbd5",
"md5": "3aab600c62045aaaed6809ff41596242",
"sha256": "f246a9746db8bae23bb39284bf724d73dfb80423f666c23247eab83963f95946"
},
"downloads": -1,
"filename": "gordo_client-6.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3aab600c62045aaaed6809ff41596242",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 45092,
"upload_time": "2024-07-04T10:49:46",
"upload_time_iso_8601": "2024-07-04T10:49:46.508650Z",
"url": "https://files.pythonhosted.org/packages/b3/c8/5748dfd4fb4dcabad9b7bf8f2e862542274889d3f6753e87c32def01dbd5/gordo_client-6.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-04 10:49:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "equinor",
"github_project": "gordo-client",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gordo-client"
}
JSON
