python-entsoe 0.2.0__tar.gz → 0.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.github/workflows/publish.yml +1 -1
- python_entsoe-0.3.0/CLAUDE.md +46 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/PKG-INFO +1 -1
- python_entsoe-0.3.0/examples/balancing.ipynb +8434 -0
- python_entsoe-0.3.0/examples/generation.ipynb +6749 -0
- python_entsoe-0.3.0/examples/generation_per_plant.ipynb +4588 -0
- python_entsoe-0.3.0/examples/load.ipynb +4656 -0
- python_entsoe-0.3.0/examples/prices.ipynb +6715 -0
- python_entsoe-0.3.0/examples/transmission.ipynb +5728 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/pyproject.toml +1 -1
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/scripts/generate_notebooks.py +205 -37
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/__init__.py +6 -1
- python_entsoe-0.3.0/src/entsoe/_mappings.py +354 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/_xml.py +16 -5
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/generation.py +14 -13
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_generation.py +2 -2
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/uv.lock +2 -2
- python_entsoe-0.2.0/examples/balancing.ipynb +0 -166
- python_entsoe-0.2.0/examples/generation.ipynb +0 -207
- python_entsoe-0.2.0/examples/load.ipynb +0 -174
- python_entsoe-0.2.0/examples/prices.ipynb +0 -164
- python_entsoe-0.2.0/examples/transmission.ipynb +0 -219
- python_entsoe-0.2.0/src/entsoe/_mappings.py +0 -145
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.gitignore +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.python-version +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/README.md +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/docs/data-availability.md +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/_http.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/client.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/exceptions.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/__init__.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/_base.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/balancing.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/load.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/prices.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/transmission.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/py.typed +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/__init__.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/conftest.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_balancing.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_load.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_prices.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_transmission.py +0 -0
- {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_validation.py +0 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# python-entsoe
|
|
2
|
+
|
|
3
|
+
Python client for the ENTSO-E Transparency Platform API.
|
|
4
|
+
|
|
5
|
+
## Environment
|
|
6
|
+
|
|
7
|
+
- **Python**: ≥3.13, managed with `uv`
|
|
8
|
+
- **API key**: stored in `.env` as `ENTSOE_API_KEY`
|
|
9
|
+
- Run scripts: `uv run python <script>`
|
|
10
|
+
- Run tests: `uv run pytest`
|
|
11
|
+
|
|
12
|
+
## PyPI Publishing
|
|
13
|
+
|
|
14
|
+
Publishing is **tag-based only**. Pushing to `main` does NOT trigger a release.
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
# 1. Bump version in pyproject.toml
|
|
18
|
+
# 2. Commit the version bump
|
|
19
|
+
# 3. Tag and push
|
|
20
|
+
git tag v0.3.0
|
|
21
|
+
git push origin main --tags
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The GitHub Actions workflow (`.github/workflows/publish.yml`) uses OIDC trusted publishing — no tokens needed.
|
|
25
|
+
|
|
26
|
+
## Example Notebooks
|
|
27
|
+
|
|
28
|
+
Notebooks in `examples/` are **generated** — do not edit them directly.
|
|
29
|
+
|
|
30
|
+
### Workflow
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# 1. Edit the notebook definitions
|
|
34
|
+
# → scripts/generate_notebooks.py
|
|
35
|
+
|
|
36
|
+
# 2. Generate clean notebooks (no outputs)
|
|
37
|
+
uv run python scripts/generate_notebooks.py
|
|
38
|
+
|
|
39
|
+
# 3. Generate + execute (saves outputs for GitHub rendering)
|
|
40
|
+
uv run python scripts/generate_notebooks.py --execute
|
|
41
|
+
|
|
42
|
+
# 4. Force re-execution (even if already executed)
|
|
43
|
+
uv run python scripts/generate_notebooks.py --execute --force
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Execution is **idempotent** — notebooks with existing outputs are skipped unless `--force` is passed. Requires `ENTSOE_API_KEY` in environment.
|