Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add concepts for production order, production run and product #10

Merged
merged 26 commits into from
Oct 10, 2023

Conversation

daniel-k
Copy link
Member

No description provided.

@daniel-k daniel-k requested a review from denizs July 20, 2023 13:39
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Show resolved Hide resolved
daniel-k and others added 2 commits July 21, 2023 08:50
Co-authored-by: Deniz Saner <deniz.saner@rwth-aachen.de>
docs/concepts.rst Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
denizs and others added 9 commits October 10, 2023 16:05
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
this was causing spell and link checks to fail
☝️ This PR is the first in a row in an effort to expose
production runs via the ENLYZE SDK.

At the moment, we only expose time series data via the SDK and
interaction with the timeseries service is contained in the
`TimeseriesApiClient`. However, the new production runs API introduces a
different pagination pattern, which makes it inconvenient to generalize
the `TimeseriesApiClient` to a `EnlyzePlatformApiClient` ™️.
Thus, this and subsequent PRs are building on top of the assumption that
we will have separate API Clients for the timeseries and production runs
API.

This first PR introduces an `ApiBaseClient` class, which implement
generalized `get` and `get_paginated` methods. The latter calls two
abstract methods, `_has_more` and `_next_page_call_args` that must be
implemented by API clients deriving from this class.

---------

Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Building up on #14 , this PR introduces the `ProductionRunsApiClient`,
which instruments the Production Runs API. A subsequent PR will then
expose a `ProductionRun` user model via the `EnlyzeClient`.

---------

Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
@denizs denizs changed the base branch from draft/production-run-models to feature/production-runs October 10, 2023 15:00
@github-actions
Copy link

github-actions bot commented Oct 10, 2023

Coverage results

Update on 2023-10-10 15:37:48.812257285 +0000

This is the coverage report for commit 77a0a4e

Name                                                                                   Stmts   Miss  Cover   Missing
--------------------------------------------------------------------------------------------------------------------
.tox/py311/lib/python3.11/site-packages/enlyze/__init__.py                                 4      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/api_clients/base.py                        65      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/api_clients/production_runs/client.py      20      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/api_clients/timeseries/client.py           19      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/api_clients/timeseries/models.py           34      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/auth.py                                    13      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/client.py                                  69      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/constants.py                                6      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/errors.py                                   3      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/models.py                                  72      0   100%
.tox/py311/lib/python3.11/site-packages/enlyze/validators.py                              30      0   100%
--------------------------------------------------------------------------------------------------------------------
TOTAL                                                                                    335      0   100%

4 empty files skipped.

@denizs denizs mentioned this pull request Oct 10, 2023
Copy link
Member Author

@daniel-k daniel-k left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some minor typos and one explanation/detail for the production run.

docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
docs/concepts.rst Outdated Show resolved Hide resolved
denizs and others added 2 commits October 10, 2023 17:30
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
denizs and others added 5 commits October 10, 2023 17:30
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
@daniel-k
Copy link
Member Author

Good to go from my side 👍

@denizs denizs merged commit 43d1b8b into feature/production-runs Oct 10, 2023
6 checks passed
@denizs denizs deleted the docs/production-runs branch October 10, 2023 15:44
@denizs denizs mentioned this pull request Oct 17, 2023
denizs added a commit that referenced this pull request Oct 17, 2023
This PR exposes production runs via the `EnlyzeClient`.
The heavy lifting has been performed in 
* #10 
* #14 
* #15 
* #16

---------

Co-authored-by: Daniel Krebs <daniel-k@users.noreply.github.com>
Co-authored-by: Mohamed Attia <mu.attiyah@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants