netzooe-eservice-api 1.0.0__tar.gz

netzooe_eservice_api-1.0.0/.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+[{*.css,*.md,*.yml,*.yaml}]
+indent_size = 2

netzooe_eservice_api-1.0.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

netzooe_eservice_api-1.0.0/.github/actions/setup-project/action.yml

@@ -0,0 +1,17 @@
+name: Set up project
+inputs:
+  python-version:
+    description: Python version
+
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+    - name: Install the project
+      run: uv sync --all-extras --dev
+      shell: bash

netzooe_eservice_api-1.0.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

netzooe_eservice_api-1.0.0/.github/environments.json

@@ -0,0 +1,3 @@
+{
+    "python-version": ["3.13", "3.14"]
+}

netzooe_eservice_api-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,215 @@
+name: CI
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  workflow_dispatch:
+    inputs:
+      build-python-package:
+        description: Build python package
+        type: boolean
+  pull_request:
+  push:
+    branches:
+      - main
+      - develop
+    tags:
+      - v*
+
+jobs:
+  configure:
+    name: Configure
+    uses: ./.github/workflows/configure.yml
+
+  code-analysis:
+    name: Code analysis using Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    needs: configure
+    strategy:
+      fail-fast: False
+      matrix:
+        python-version: ${{ fromJson(needs.configure.outputs.environments).python-version }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Lint python files with black
+        run: uv run black --diff --check $(git ls-files '*.py')
+      - name: Lint python files with mypy
+        run: uv run mypy $(git ls-files '*.py')
+      - name: Lint python files with ruff
+        run: uv run ruff check $(git ls-files '*.py')
+      - name: Lint YAML files
+        run: uv run yamllint $(git ls-files '*.yml' '*.yaml')
+      - name: Lint Markdown files
+        run: uv run rumdl check $(git ls-files '*.md')
+
+  security:
+    name: Security
+    uses: ./.github/workflows/security.yml
+    needs: configure
+    with:
+      environments: ${{ needs.configure.outputs.environments }}
+
+  tests:
+    name: Tests using Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    needs: configure
+    strategy:
+      fail-fast: False
+      matrix:
+        python-version: ${{ fromJson(needs.configure.outputs.environments).python-version }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run tests
+        run: uv run pytest -n auto
+      - name: Upload coverage
+        uses: actions/upload-artifact@v6
+        with:
+          name: coverage-xml-${{ matrix.python-version }}
+          path: reports/coverage.xml
+          if-no-files-found: error
+          overwrite: True
+
+  coverage:
+    name: Generate coverage badge
+    runs-on: ubuntu-latest
+    if: github.ref_type != 'tag'
+    needs:
+      - configure
+      - tests
+    permissions:
+      contents: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ fromJson(needs.configure.outputs.environments).python-version[0] }}
+      - name: Download coverage
+        uses: actions/download-artifact@v7
+        with:
+          name: coverage-xml-${{ fromJson(needs.configure.outputs.environments).python-version[0] }}
+          path: reports
+      - name: Create coverage badge
+        run: uv run genbadge coverage --input-file reports/coverage.xml
+      - name: Verify coverage badge changed
+        uses: tj-actions/verify-changed-files@v20
+        id: changed-files
+        with:
+          files: coverage-badge.svg
+      - name: Commit coverage badge
+        if: steps.changed-files.outputs.files_changed == 'true'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add coverage-badge.svg
+          git commit -m "Updated coverage-badge.svg"
+      - name: Push changes
+        if: steps.changed-files.outputs.files_changed == 'true'
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: ${{ github.ref }}
+
+  build-python-package:
+    name: Build python package
+    runs-on: ubuntu-latest
+    if: |
+      github.ref_type == 'tag'
+      || (
+        github.ref_type == 'branch'
+        && inputs.build-python-package
+      )
+      && !endsWith(github.ref_name, '/merge')
+    needs:
+      - configure
+      - code-analysis
+      - security
+      - tests
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ fromJson(needs.configure.outputs.environments).python-version[0] }}
+      - name: Build package
+        run: uv run python -m build
+      - name: Upload package files
+        uses: actions/upload-artifact@v6
+        with:
+          name: python-package
+          path: dist
+          if-no-files-found: error
+
+  release:
+    name: Release on GitHub
+    runs-on: ubuntu-latest
+    if: github.ref_type == 'tag'
+    needs:
+      - configure
+      - build-python-package
+    permissions:
+      contents: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ fromJson(needs.configure.outputs.environments).python-version[0] }}
+      - name: Download files
+        uses: actions/download-artifact@v7
+        with:
+          name: python-package
+          path: dist
+      - name: Check if prerelease
+        id: check_prerelease
+        run: |
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          echo "Tag: $TAG_NAME"
+
+          if [[ "$TAG_NAME" =~ ^v[0-9]+\.[0-9]+\.[0-9]+b[0-9]+$ ]]; then
+            echo "🟡 Pre-release detected"
+            echo "prerelease=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "🟢 Regular release"
+            echo "prerelease=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Release on GitHub
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*.tar.gz
+            dist/*.whl
+          prerelease: ${{ steps.check_prerelease.outputs.prerelease }}
+
+  publish-on-pypi:
+    name: Publish
+    runs-on: ubuntu-latest
+    if: github.ref_type == 'tag'
+    needs:
+      - release
+    steps:
+      - name: Download files
+        uses: actions/download-artifact@v7
+        with:
+          name: python-package
+          path: dist
+      - name: Publish on PyPi
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages-dir: dist

netzooe_eservice_api-1.0.0/.github/workflows/configure.yml

@@ -0,0 +1,24 @@
+name: Configure
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  workflow_call:
+    outputs:
+      environments:
+        value: ${{ jobs.configure.outputs.environments }}
+
+jobs:
+  configure:
+    name: Configure
+    runs-on: ubuntu-latest
+    outputs:
+      environments: ${{ steps.set-environments.outputs.environments }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set environments
+        id: set-environments
+        run: echo "environments=$(jq -c . < ./.github/environments.json)" >> $GITHUB_OUTPUT

netzooe_eservice_api-1.0.0/.github/workflows/schedule-ci.yml

@@ -0,0 +1,21 @@
+name: Schedule CI
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  schedule:
+    - cron: 30 5 * * *
+
+jobs:
+  configure:
+    name: Configure
+    uses: ./.github/workflows/configure.yml
+
+  security:
+    name: Security
+    uses: ./.github/workflows/security.yml
+    needs: configure
+    with:
+      environments: ${{ needs.configure.outputs.environments }}

netzooe_eservice_api-1.0.0/.github/workflows/security.yml

@@ -0,0 +1,33 @@
+name: Security
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  workflow_call:
+    inputs:
+      environments:
+        required: True
+        type: string
+
+jobs:
+  security:
+    name: Audit packages using Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    continue-on-error: True
+    strategy:
+      fail-fast: False
+      matrix:
+        python-version: ${{ fromJson(inputs.environments).python-version }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up project
+        uses: ./.github/actions/setup-project
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Create requirements.txt
+        run: uv export --quiet --locked --all-extras --dev --no-hashes --no-editable --output-file=requirements.txt
+      - name: Audit python packages
+        run: uv run pip-audit --requirement=requirements.txt

netzooe_eservice_api-1.0.0/.gitignore

@@ -0,0 +1,33 @@
+# OS generated files
+.DS_Store
+._*
+*.swp
+
+# cache
+*.pyc
+
+# virtualenv
+.venv
+
+# GitHub Action
+output/
+
+# checks
+.ruff_cache
+.mypy_cache
+.pytest_cache
+.rumdl_cache
+
+# reports
+reports/
+.coverage
+
+# build package
+*.egg
+*.egg-info
+build/
+dist/
+netzooe_eservice_api/version.py
+
+# others
+netzooe_eservice_api/test.py

netzooe_eservice_api-1.0.0/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

netzooe_eservice_api-1.0.0/.idea/.name

@@ -0,0 +1 @@
+NetzOOE-eService-API

netzooe_eservice_api-1.0.0/.idea/NetzOOE-eService-API.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="uv (netzooe_eservice_api)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

netzooe_eservice_api-1.0.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,12 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyUnresolvedReferencesInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredIdentifiers">
+        <list>
+          <option value="str.*" />
+        </list>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

netzooe_eservice_api-1.0.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

netzooe_eservice_api-1.0.0/.idea/misc.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="enabledOnReformat" value="true" />
+    <option name="enabledOnSave" value="true" />
+    <option name="sdkName" value="uv (netzooe_eservice_api)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="uv (netzooe_eservice_api)" project-jdk-type="Python SDK" />
+</project>

netzooe_eservice_api-1.0.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/NetzOOE-eService-API.iml" filepath="$PROJECT_DIR$/.idea/NetzOOE-eService-API.iml" />
+    </modules>
+  </component>
+</project>

netzooe_eservice_api-1.0.0/.idea/runConfigurations/tests.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="tests" type="tests" factoryName="Autodetect">
+    <module name="NetzOOE-eService-API" />
+    <option name="ENV_FILES" value="" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="PARENT_ENVS" value="true" />
+    <option name="SDK_HOME" value="" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/tests" />
+    <option name="IS_MODULE_SDK" value="true" />
+    <option name="ADD_CONTENT_ROOTS" value="true" />
+    <option name="ADD_SOURCE_ROOTS" value="true" />
+    <option name="_new_additionalArguments" value="&quot;&quot;" />
+    <option name="_new_target" value="&quot;$PROJECT_DIR$/tests&quot;" />
+    <option name="_new_targetType" value="&quot;PATH&quot;" />
+    <method v="2" />
+  </configuration>
+</component>

netzooe_eservice_api-1.0.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

netzooe_eservice_api-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,41 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-shebang-scripts-are-executable
+      - id: check-symlinks
+      - id: check-yaml
+      - id: check-toml
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: local
+    hooks:
+      - id: black
+        name: black
+        entry: uv run black --check
+        language: system
+        types:
+          - python
+      - id: ruff
+        name: ruff
+        entry: uv run ruff check
+        language: system
+        types:
+          - python
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        types:
+          - python
+      - id: rumdl
+        name: rumdl
+        entry: uv run rumdl check
+        language: system
+        files: \.md$
+      - id: yamllint
+        name: yamllint
+        entry: uv run yamllint
+        language: system
+        files: \.ya?ml$

netzooe_eservice_api-1.0.0/.yamllint.yml

@@ -0,0 +1,31 @@
+extends: default
+
+ignore-from-file: .gitignore
+
+rules:
+  document-start: disable
+  truthy:
+    allowed-values: ['True', 'False', 'yes', 'no', 'on', 'off']  # yamllint disable rule:brackets
+  line-length:
+    max: 140
+    allow-non-breakable-words: True
+    allow-non-breakable-inline-mappings: True
+  quoted-strings:
+    quote-type: single
+    required: only-when-needed
+  empty-lines:
+    max: 1
+    max-start: 0
+    max-end: 0
+  braces:
+    forbid: non-empty
+    min-spaces-inside: 0
+    max-spaces-inside: 0
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1
+  brackets:
+    forbid: non-empty
+    min-spaces-inside: 0
+    max-spaces-inside: 0
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1

netzooe_eservice_api-1.0.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-02-14
+
+Initial release

netzooe_eservice_api-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing
+
+<!--start-contributing-->
+
+## Guidelines
+
+Contributing to this project should be as easy and transparent as possible, whether it's:
+
+- Reporting a bug
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+
+## Getting started
+
+Set up the project with `./scripts/setup.sh`.
+
+## GitHub is used for everything
+
+GitHub is used to host code, to track issues and feature requests, as well as accept pull requests.
+
+Pull requests are the best way to propose changes to the codebase.
+
+1. Fork the repo and create your branch from `main`
+2. If you've changed something, update the documentation.
+3. Make sure your code lints with `./scripts/lint.sh`.
+4. Test you contribution.
+5. Issue that pull request!
+
+## Report bugs using Github's [issues](https://github.com/superbox-dev/netzooe_eservice_api/issues)
+
+GitHub issues are used to track public bugs.
+Report a bug by [opening a new issue](https://github.com/superbox-dev/netzooe_eservice_api/issues/new/choose);
+it's that easy!
+
+## Write bug reports with detail, background, and sample code
+
+**Great Bug Reports** tend to have:
+
+- A quick summary and/or background
+- Steps to reproduce
+  - Be specific!
+  - Give sample code if you can
+- What you expected would happen
+- What actually happens
+- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
+
+People *love* thorough bug reports. I'm not even kidding.
+
+## Use a Consistent Coding Style
+
+Use [black](https://github.com/ambv/black) to make sure the code follows the style.
+
+```bash
+uv run black .
+```
+
+## Test your code modification
+
+To test the code we use [pytest](https://docs.pytest.org):
+
+```bash
+uv run pytest -n auto
+```
+
+## License
+
+By contributing, you agree that your contributions will be licensed under its [Apache License][license].
+
+[license]: https://github.com/superbox-dev/keba_keenergy/blob/main/LICENSE
+
+<!--end-contributing-->