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.
Files changed (44) hide show
  1. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.github/workflows/publish.yml +1 -1
  2. python_entsoe-0.3.0/CLAUDE.md +46 -0
  3. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/PKG-INFO +1 -1
  4. python_entsoe-0.3.0/examples/balancing.ipynb +8434 -0
  5. python_entsoe-0.3.0/examples/generation.ipynb +6749 -0
  6. python_entsoe-0.3.0/examples/generation_per_plant.ipynb +4588 -0
  7. python_entsoe-0.3.0/examples/load.ipynb +4656 -0
  8. python_entsoe-0.3.0/examples/prices.ipynb +6715 -0
  9. python_entsoe-0.3.0/examples/transmission.ipynb +5728 -0
  10. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/pyproject.toml +1 -1
  11. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/scripts/generate_notebooks.py +205 -37
  12. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/__init__.py +6 -1
  13. python_entsoe-0.3.0/src/entsoe/_mappings.py +354 -0
  14. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/_xml.py +16 -5
  15. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/generation.py +14 -13
  16. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_generation.py +2 -2
  17. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/uv.lock +2 -2
  18. python_entsoe-0.2.0/examples/balancing.ipynb +0 -166
  19. python_entsoe-0.2.0/examples/generation.ipynb +0 -207
  20. python_entsoe-0.2.0/examples/load.ipynb +0 -174
  21. python_entsoe-0.2.0/examples/prices.ipynb +0 -164
  22. python_entsoe-0.2.0/examples/transmission.ipynb +0 -219
  23. python_entsoe-0.2.0/src/entsoe/_mappings.py +0 -145
  24. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.gitignore +0 -0
  25. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/.python-version +0 -0
  26. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/README.md +0 -0
  27. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/docs/data-availability.md +0 -0
  28. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/_http.py +0 -0
  29. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/client.py +0 -0
  30. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/exceptions.py +0 -0
  31. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/__init__.py +0 -0
  32. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/_base.py +0 -0
  33. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/balancing.py +0 -0
  34. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/load.py +0 -0
  35. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/prices.py +0 -0
  36. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/namespaces/transmission.py +0 -0
  37. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/src/entsoe/py.typed +0 -0
  38. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/__init__.py +0 -0
  39. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/conftest.py +0 -0
  40. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_balancing.py +0 -0
  41. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_load.py +0 -0
  42. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_prices.py +0 -0
  43. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_transmission.py +0 -0
  44. {python_entsoe-0.2.0 → python_entsoe-0.3.0}/tests/test_validation.py +0 -0
@@ -2,7 +2,7 @@ name: Publish to PyPI
2
2
 
3
3
  on:
4
4
  push:
5
- branches: [main]
5
+ tags: ["v*"]
6
6
 
7
7
  jobs:
8
8
  publish:
@@ -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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: python-entsoe
3
- Version: 0.2.0
3
+ Version: 0.3.0
4
4
  Summary: Python client for the ENTSO-E Transparency Platform API
5
5
  Project-URL: Repository, https://github.com/datons/python-entsoe
6
6
  Author-email: jsulopzs <jesus.lopez@datons.com>