aignostics 0.0.1__py3-none-any.whl

aignostics/__init__.py

@@ -0,0 +1,15 @@
+"""Python SDK providing access to Aignostics AI services."""
+
+from .constants import (
+    __project_name__,
+    __project_path__,
+    __version__,
+)
+from .service import Service
+
+__all__ = [
+    "Service",
+    "__project_name__",
+    "__project_path__",
+    "__version__",
+]

aignostics/api.py

@@ -0,0 +1,239 @@
+"""Webservice API of Aignostics Python SDK.
+
+This module provides a webservice API with several endpoints:
+- A health/healthz endpoint that returns the health status of the service
+- A hello-world endpoint that returns a greeting message
+- An echo endpoint that echoes back the provided text
+
+The endpoints use Pydantic models for request and response validation.
+"""
+
+import os
+from collections.abc import Generator
+from enum import StrEnum
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, Response, status
+from pydantic import BaseModel, Field
+
+from aignostics import Service
+
+TITLE = "Aignostics Python SDK"
+HELLO_WORLD_EXAMPLE = "Hello, world!"
+UVICORN_HOST = os.environ.get("UVICORN_HOST", "127.0.0.1")
+UVICORN_PORT = os.environ.get("UVICORN_PORT", "8000")
+CONTACT_NAME = "Aignostics GmbH"
+CONTACT_EMAIL = "support@aignostics.com"
+CONTACT_URL = "https://github.com/aignostics"
+TERMS_OF_SERVICE_URL = "https://aignostics.readthedocs.io/en/latest/"
+
+
+def get_service() -> Generator[Service, None, None]:
+    """Get the service instance.
+
+    Yields:
+        Service: The service instance.
+    """
+    service = Service()
+    try:
+        yield service
+    finally:
+        # Cleanup code if needed
+        pass
+
+
+api = FastAPI(
+    root_path="/api",
+    title=TITLE,
+    contact={
+        "name": CONTACT_NAME,
+        "email": CONTACT_EMAIL,
+        "url": CONTACT_URL,
+    },
+    terms_of_service=TERMS_OF_SERVICE_URL,
+    openapi_tags=[
+        {
+            "name": "v1",
+            "description": "API version 1, check link on the right",
+            "externalDocs": {
+                "description": "sub-docs",
+                "url": f"http://{UVICORN_HOST}:{UVICORN_PORT}/api/v1/docs",
+            },
+        },
+        {
+            "name": "v2",
+            "description": "API version 2, check link on the right",
+            "externalDocs": {
+                "description": "sub-docs",
+                "url": f"http://{UVICORN_HOST}:{UVICORN_PORT}/api/v2/docs",
+            },
+        },
+    ],
+)
+
+api_v1 = FastAPI(
+    version="1.0.0",
+    title=TITLE,
+    contact={
+        "name": CONTACT_NAME,
+        "email": CONTACT_EMAIL,
+        "url": CONTACT_URL,
+    },
+    terms_of_service=TERMS_OF_SERVICE_URL,
+)
+
+api_v2 = FastAPI(
+    version="2.0.0",
+    title=TITLE,
+    contact={
+        "name": CONTACT_NAME,
+        "email": CONTACT_EMAIL,
+        "url": CONTACT_URL,
+    },
+    terms_of_service=TERMS_OF_SERVICE_URL,
+)
+
+
+class _HealthStatus(StrEnum):
+    """Health status enumeration."""
+
+    UP = "UP"
+    DOWN = "DOWN"
+
+
+class Health(BaseModel):
+    """Health status model."""
+
+    status: _HealthStatus
+    reason: str | None = None
+
+
+class HealthResponse(BaseModel):
+    """Response model for health endpoint."""
+
+    health: str = Field(
+        ...,
+        description="The hello world message",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@api_v1.get("/healthz", tags=["Observability"])
+@api_v1.get("/health", tags=["Observability"])
+@api_v2.get("/healthz", tags=["Observability"])
+@api_v2.get("/health", tags=["Observability"])
+async def health(service: Annotated[Service, Depends(get_service)], response: Response) -> Health:
+    """Check the health of the service.
+
+    This endpoint returns the health status of the service.
+    The health status can be either UP or DOWN.
+    If the service is healthy, the status will be UP.
+    If the service is unhealthy, the status will be DOWN and a reason will be provided.
+    The response will have a 200 OK status code if the service is healthy,
+    and a 500 Internal Server Error status code if the service is unhealthy.
+
+    Returns:
+        Health: The health status of the service.
+    """
+    if service.healthy():
+        health_result = Health(status=_HealthStatus.UP)
+    else:
+        health_result = Health(status=_HealthStatus.DOWN, reason="Service is unhealthy")
+
+    if health_result.status == _HealthStatus.DOWN:
+        response.status_code = status.HTTP_500_INTERNAL_SERVER_ERROR
+
+    return health_result
+
+
+class HelloWorldResponse(BaseModel):
+    """Response model for hello-world endpoint."""
+
+    message: str = Field(
+        ...,
+        description="The hello world message",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@api_v1.get("/hello-world", tags=["Basics"])
+@api_v2.get("/hello-world", tags=["Basics"])
+async def hello_world() -> HelloWorldResponse:
+    """
+    Return a hello world message.
+
+    Returns:
+        HelloWorldResponse: A response containing the hello world message.
+    """
+    return HelloWorldResponse(message=Service.get_hello_world())
+
+
+class EchoResponse(BaseModel):
+    """Response model for echo endpoint."""
+
+    message: str = Field(
+        ...,
+        min_length=1,
+        description="The message content",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+class EchoRequest(BaseModel):
+    """Request model for echo endpoint."""
+
+    text: str = Field(
+        ...,
+        min_length=1,
+        description="The text to echo back",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@api_v1.post("/echo", tags=["Basics"])
+async def echo(request: EchoRequest) -> EchoResponse:
+    """
+    Echo back the provided text.
+
+    Args:
+        request (EchoRequest): The request containing the text to echo back.
+
+    Returns:
+        EchoResponse: A response containing the echoed text.
+
+    Raises:
+        422 Unprocessable Entity: If text is not provided or empty.
+    """
+    return EchoResponse(message=request.text)
+
+
+class Utterance(BaseModel):
+    """Request model for echo endpoint."""
+
+    utterance: str = Field(
+        ...,
+        min_length=1,
+        description="The utterance to echo back",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@api_v2.post("/echo", tags=["Basics"])
+async def echo_v2(request: Utterance) -> EchoResponse:
+    """
+    Echo back the provided utterance.
+
+    Args:
+        request (Utterance): The request containing the utterance to echo back.
+
+    Returns:
+        EchoResponse: A response containing the echoed utterance.
+
+    Raises:
+        422 Unprocessable Entity: If utterance is not provided or empty.
+    """
+    return EchoResponse(message=request.utterance)
+
+
+api.mount("/v1", api_v1)
+api.mount("/v2", api_v2)

aignostics/cli.py

@@ -0,0 +1,133 @@
+"""CLI (Command Line Interface) of Aignostics Python SDK."""
+
+import os
+from enum import StrEnum
+from typing import Annotated
+
+import typer
+import uvicorn
+import yaml
+from rich.console import Console
+
+from aignostics import Service, __version__
+from aignostics.api import api_v1, api_v2
+
+console = Console()
+
+cli = typer.Typer(name="Command Line Interface of Aignostics Python SDK")
+
+
+@cli.command()
+def echo(
+    text: Annotated[
+        str, typer.Argument(help="The text to echo")
+    ] = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
+    json: Annotated[
+        bool,
+        typer.Option(
+            help=("Print as JSON"),
+        ),
+    ] = False,
+) -> None:
+    """Echo the text."""
+    if json:
+        console.print_json(data={"text": text})
+    else:
+        console.print(text)
+
+
+@cli.command()
+def hello_world() -> None:
+    """Print hello world message and what's in the environment variable THE_VAR."""
+    console.print(Service.get_hello_world())
+
+
+@cli.command()
+def serve(
+    host: Annotated[str, typer.Option(help="Host to bind the server to")] = "127.0.0.1",
+    port: Annotated[int, typer.Option(help="Port to bind the server to")] = 8000,
+    watch: Annotated[bool, typer.Option(help="Enable auto-reload")] = True,
+) -> None:
+    """Start the API server."""
+    console.print(f"Starting API server at http://{host}:{port}")
+    os.environ["UVICORN_HOST"] = host
+    os.environ["UVICORN_PORT"] = str(port)
+    uvicorn.run(
+        "aignostics.api:api",
+        host=host,
+        port=port,
+        reload=watch,
+    )
+
+
+class APIVersion(StrEnum):
+    """
+    Enum representing the API versions.
+
+    This enum defines the supported API verions:
+    - V1: Output doc for v1 API
+    - V2: Output doc for v2 API
+
+    Usage:
+        version = APIVersion.V1
+        print(f"Using {version} version")
+
+    """
+
+    V1 = "v1"
+    V2 = "v2"
+
+
+class OutputFormat(StrEnum):
+    """
+    Enum representing the supported output formats.
+
+    This enum defines the possible formats for output data:
+    - YAML: Output data in YAML format
+    - JSON: Output data in JSON format
+
+    Usage:
+        format = OutputFormat.YAML
+        print(f"Using {format} format")
+    """
+
+    YAML = "yaml"
+    JSON = "json"
+
+
+@cli.command()
+def openapi(
+    api_version: Annotated[APIVersion, typer.Option(help="API Version", case_sensitive=False)] = APIVersion.V1,
+    output_format: Annotated[
+        OutputFormat, typer.Option(help="Output format", case_sensitive=False)
+    ] = OutputFormat.YAML,
+) -> None:
+    """Dump the OpenAPI specification to stdout (YAML by default)."""
+    match api_version:
+        case APIVersion.V1:
+            schema = api_v1.openapi()
+        case APIVersion.V2:
+            schema = api_v2.openapi()
+    match output_format:
+        case OutputFormat.JSON:
+            console.print_json(data=schema)
+        case OutputFormat.YAML:
+            console.print(yaml.dump(schema, default_flow_style=False), end="")
+
+
+def _apply_cli_settings(cli: typer.Typer, epilog: str) -> None:
+    """Add epilog to all typers in the tree and configure default behavior."""
+    cli.info.epilog = epilog
+    cli.info.no_args_is_help = True
+    for command in cli.registered_commands:
+        command.epilog = cli.info.epilog
+
+
+_apply_cli_settings(
+    cli,
+    f"🔬 Aignostics Python SDK v{__version__} - built with love in Berlin 🐻",
+)
+
+
+if __name__ == "__main__":
+    cli()

aignostics/constants.py

@@ -0,0 +1,10 @@
+"""Constants used throughout Aignostics Python SDK's codebase ."""
+
+import importlib.metadata
+import pathlib
+
+__project_name__ = __name__.split(".")[0]
+__project_path__ = str(pathlib.Path(__file__).parent.parent.parent)
+__version__ = importlib.metadata.version(__project_name__)
+
+LOREM_IPSUM = "Lorem ipsum dolor sit amet, consectetur adipiscing elit."

aignostics/service.py

@@ -0,0 +1,35 @@
+"""Service of Aignostics Python SDK."""
+
+import os
+
+from dotenv import load_dotenv
+
+load_dotenv()
+THE_VAR = os.getenv("THE_VAR", "not defined")
+
+
+class Service:
+    """Service of Aignostics Python SDK."""
+
+    def __init__(self) -> None:
+        """Initialize service."""
+        self.is_healthy = True
+
+    @staticmethod
+    def get_hello_world() -> str:
+        """
+        Get a hello world message.
+
+        Returns:
+            str: Hello world message.
+        """
+        return f"Hello, world! The value of THE_VAR is {THE_VAR}"
+
+    def healthy(self) -> bool:
+        """
+        Check if the service is healthy.
+
+        Returns:
+            bool: True if the service is healthy, False otherwise.
+        """
+        return self.is_healthy

aignostics-0.0.1.dist-info/METADATA

@@ -0,0 +1,428 @@
+Metadata-Version: 2.4
+Name: aignostics
+Version: 0.0.1
+Summary: 🔬 Python SDK providing access to Aignostics AI services.
+Project-URL: Homepage, https://aignostics.readthedocs.io/en/latest/
+Project-URL: Documentation, https://aignostics.readthedocs.io/en/latest/
+Project-URL: Source, https://github.com/aignostics/python-sdk
+Project-URL: Changelog, https://github.com/aignostics/python-sdk/releases
+Project-URL: Issues, https://github.com/aignostics/python-sdk/issues
+Author-email: Helmut Hoffer von Ankershoffen <helmut@aignostics.com>
+License: MIT License
+        
+        Copyright (c) [2025] [Aignostics GmbH (support@aignostics.com)]
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: act,aignostics,codecov,copier,cyclonedx,detect-secrets,devcontainer,docker,git-cliff,jupyter,marimo,mypy,nox,oe-python-template,pip-audit,pip-licenses,pre-commit,pydantic,pypi,pytest,python,readthedocs,ruff,sonarcloud,sonarqube,sphinx,streamlit,typer,uv
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.11
+Requires-Dist: fastapi[all,standard]>=0.115.11
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: typer>=0.15.1
+Provides-Extra: examples
+Requires-Dist: jinja2>=3.1.6; extra == 'examples'
+Requires-Dist: jupyter>=1.1.1; extra == 'examples'
+Requires-Dist: marimo>=0.11.19; extra == 'examples'
+Requires-Dist: streamlit>=1.43.2; extra == 'examples'
+Description-Content-Type: text/markdown
+
+
+[//]: # (README.md generated from docs/partials/README_*.md)
+
+# 🔬 Aignostics Python SDK
+
+[![License](https://img.shields.io/github/license/aignostics/python-sdk?logo=opensourceinitiative&logoColor=3DA639&labelColor=414042&color=A41831)
+](https://github.com/aignostics/python-sdk/blob/main/LICENSE)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/aignostics.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/aignostics/python-sdk/blob/main/noxfile.py)
+[![CI](https://github.com/aignostics/python-sdk/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/aignostics/python-sdk/actions/workflows/test-and-report.yml)
+[![Read the Docs](https://img.shields.io/readthedocs/aignostics)](https://aignostics.readthedocs.io/en/latest/)
+[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=aignostics_python-sdk&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk)
+[![Security](https://sonarcloud.io/api/project_badges/measure?project=aignostics_python-sdk&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk)
+[![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=aignostics_python-sdk&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk)
+[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=aignostics_python-sdk&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk)
+[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=aignostics_python-sdk&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk)
+[![CodeQL](https://github.com/aignostics/python-sdk/actions/workflows/codeql.yml/badge.svg)](https://github.com/aignostics/python-sdk/security/code-scanning)
+[![Dependabot](https://img.shields.io/badge/dependabot-active-brightgreen?style=flat-square&logo=dependabot)](https://github.com/aignostics/python-sdk/security/dependabot)
+[![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://github.com/aignostics/python-sdk/issues?q=is%3Aissue%20state%3Aopen%20Dependency%20Dashboard)
+[![Coverage](https://codecov.io/gh/aignostics/python-sdk/graph/badge.svg?token=SX34YRP30E)](https://codecov.io/gh/aignostics/python-sdk)
+[![Ruff](https://img.shields.io/badge/style-Ruff-blue?color=D6FF65)](https://github.com/aignostics/python-sdk/blob/main/noxfile.py)
+[![MyPy](https://img.shields.io/badge/mypy-checked-blue)](https://github.com/aignostics/python-sdk/blob/main/noxfile.py)
+[![GitHub - Version](https://img.shields.io/github/v/release/aignostics/python-sdk?label=GitHub&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)](https://github.com/aignostics/python-sdk/releases)
+[![GitHub - Commits](https://img.shields.io/github/commit-activity/m/aignostics/python-sdk/main?label=commits&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)](https://github.com/aignostics/python-sdk/commits/main/)
+[![PyPI - Version](https://img.shields.io/pypi/v/aignostics.svg?label=PyPI&logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/aignostics)
+[![PyPI - Status](https://img.shields.io/pypi/status/aignostics?logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/aignostics)
+[![Docker - Version](https://img.shields.io/docker/v/helmuthva/aignostics-python-sdk?sort=semver&label=Docker&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/aignostics-python-sdk/tags)
+[![Docker - Size](https://img.shields.io/docker/image-size/helmuthva/aignostics-python-sdk?sort=semver&arch=arm64&label=image&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/aignostics-python-sdk/)
+[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
+[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTE3IDE2VjdsLTYgNU0yIDlWOGwxLTFoMWw0IDMgOC04aDFsNCAyIDEgMXYxNGwtMSAxLTQgMmgtMWwtOC04LTQgM0gzbC0xLTF2LTFsMy0zIi8+PC9zdmc+)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/aignostics/python-sdk)
+[![Open in GitHub Codespaces](https://img.shields.io/static/v1?label=GitHub%20Codespaces&message=Open&color=blue&logo=github)](https://github.com/codespaces/new/aignostics/python-sdk)
+
+<!---
+[![ghcr.io - Version](https://ghcr-badge.egpl.dev/aignostics/python-sdk/tags?color=%2344cc11&ignore=0.0%2C0%2Clatest&n=3&label=ghcr.io&trim=)](https://github.com/aignostics/python-sdk/pkgs/container/python-sdk)
+[![ghcr.io - Sze](https://ghcr-badge.egpl.dev/aignostics/python-sdk/size?color=%2344cc11&tag=latest&label=size&trim=)](https://github.com/aignostics/python-sdk/pkgs/container/python-sdk)
+-->
+
+> [!TIP]
+> 📚 [Online documentation](https://aignostics.readthedocs.io/en/latest/) - 📖 [PDF Manual](https://aignostics.readthedocs.io/_/downloads/en/latest/pdf/)
+
+> [!NOTE]
+> 🧠 This project was scaffolded using the template [oe-python-template](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template) with [copier](https://copier.readthedocs.io/).
+
+---
+
+
+Python SDK providing access to Aignostics AI services.
+
+This [Copier](https://copier.readthedocs.io/en/stable/) template enables you to quickly generate a Python package with fully functioning build and test automation.
+Projects generated from this template can be [easily updated](https://copier.readthedocs.io/en/stable/updating/) to benefit from improvements and new features of the template.
+
+Features:
+1. Package management with [uv](https://github.com/astral-sh/uv)
+2. Code formatting with [Ruff](https://github.com/astral-sh/ruff)
+3. Linting with [Ruff](https://github.com/astral-sh/ruff)
+4. Static type checking with [mypy](https://mypy.readthedocs.io/en/stable/)
+5. Complete set of [pre-commit](https://pre-commit.com/) hooks including [detect-secrets](https://github.com/Yelp/detect-secrets) and [pygrep](https://github.com/pre-commit/pygrep-hooks)
+6. Unit and E2E testing with [pytest](https://docs.pytest.org/en/stable/) including parallel test execution
+7. Matrix testing in multiple environments with [nox](https://nox.thea.codes/en/stable/)
+8. Test coverage reported with [Codecov](https://codecov.io/) and published as release artifact
+9. CI/CD pipeline automated with [GitHub Actions](https://github.com/features/actions)
+10. CI/CD pipeline can be run locally with [act](https://github.com/nektos/act)
+11. Code quality and security checks with [SonarQube](https://www.sonarsource.com/products/sonarcloud) and [GitHub CodeQL](https://codeql.github.com/)
+12. Dependency monitoring with [pip-audit](https://pypi.org/project/pip-audit/), [Renovate](https://github.com/renovatebot/renovate), and [GitHub Dependabot](https://docs.github.com/en/code-security/getting-started/dependabot-quickstart-guide)
+13. Licenses of dependencies extracted with [pip-licenses](https://pypi.org/project/pip-licenses/) and published as release artifacts in CSV and JSON format for compliance checks
+14. Software Bill of Materials (SBOM) generated with [cyclonedx-python](https://github.com/CycloneDX/cyclonedx-python) and published as release artifact
+15. Version and release management with [bump-my-version](https://callowayproject.github.io/bump-my-version/)
+16. Changelog and release notes generated with [git-cliff](https://git-cliff.org/)
+17. Documentation generated with [Sphinx](https://www.sphinx-doc.org/en/master/) including reference documentation and PDF export
+18. Documentation published to [Read The Docs](https://readthedocs.org/)
+19. Interactive OpenAPI specification with [Swagger](https://swagger.io/)
+20. Python package published to [PyPI](https://pypi.org/)
+21. Docker images published to [Docker.io](https://hub.docker.com/) and [GitHub Container Registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry) with [artifact attestations](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds)
+22. One-click development environments with [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) and [GitHub Codespaces](https://github.com/features/codespaces)
+23. Settings for use with [VSCode](https://code.visualstudio.com/)
+24. Settings and custom instructions for use with [GitHub Copilot](https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)
+
+The generated project includes code, documentation and configuration of a fully functioning demo-application and service, which can be used as a starting point for your own project.
+1. Service architecture suitable for use as shared library
+2. Validation with [pydantic](https://docs.pydantic.dev/)
+3. Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
+4. Versioned Web API with [FastAPI](https://fastapi.tiangolo.com/)
+5. [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
+6. Simple Web UI with [Streamlit](https://streamlit.io/)
+7. Configuration to run the CLI and API in a Docker container including setup for [Docker Compose](https://docs.docker.com/get-started/docker-concepts/the-basics/what-is-docker-compose/)
+8. Documentation including badges, setup instructions, contribution guide and security policy
+
+Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
+
+## Generate a new project
+
+This template is designed to be used with the [copier](https://copier.readthedocs.io/en/stable/) project generator. It allows you to create a new project based on this template and customize it according to your needs.
+To generate a new project, follow these steps:
+
+**Step 1**: Install uv package manager and copier. Copy the following code into your terminal and execute it.
+```shell
+if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
+  if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  fi
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then            # Install dependencies for Linux
+  sudo apt-get update -y && sudo apt-get install curl -y # Install curl
+fi
+if ! command -v uvx &> /dev/null; then                # Install uv package manager if not present
+  curl -LsSf https://astral.sh/uv/install.sh | sh
+  source $HOME/.local/bin/env
+fi
+uv tool install copier                                # Install copier as global tool
+```
+
+**Step 2**: [Create an empty repository on GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository), clone to your local machine, and change into it's directory.
+
+**Step 3**: Generate the project. Copy
+```shell
+copier copy --trust gh:helmut-hoffer-von-ankershoffen/oe-python-template .
+```
+
+**Step 4**: Perform initial commit and push. Copy the following code into your terminal and execute it.
+```shell
+git add .
+git commit -m "feat: Initial commit"
+git push
+```
+
+Visit your GitHub repository and check the Actions tab. The CI workflow should already be running! The workflow will fail at the SonarQube step, as this external service is not yet configured for our new repository.
+
+**Step 5**: Follow the [instructions](SERVICE_CONNECTIONS.md) to wire up
+external services such as CloudCov, SonarQube Cloud, Read The Docs, Docker.io, and Streamlit Community Cloud.
+
+**Step 6**: Release the first versions
+```shell
+./n bump
+```
+Notes:
+1. You can remove this section post having successfully generated your project.
+2. The following sections refer to the dummy application and service provided by this template.
+   Use them as inspiration and adapt them to your own project.
+
+## Overview
+
+Adding Aignostics Python SDK to your project as a dependency is easy. See below for usage examples.
+
+```shell
+uv add aignostics             # add dependency to your project
+```
+
+If you don't have uv installed follow [these instructions](https://docs.astral.sh/uv/getting-started/installation/). If you still prefer pip over the modern and fast package manager [uv](https://github.com/astral-sh/uv), you can install the library like this:
+
+
+```shell
+pip install aignostics        # add dependency to your project
+```
+
+Executing the command line interface (CLI) in an isolated Python environment is just as easy:
+
+```shell
+uvx aignostics hello-world       # prints "Hello, world! [..]"
+uvx aignostics serve             # serves web API
+uvx aignostics serve --port=4711 # serves web API on port 4711
+```
+
+Notes:
+1. The API is versioned, mounted at `/api/v1` resp. `/api/v2`
+2. While serving the web API go to [http://127.0.0.1:8000/api/v1/hello-world](http://127.0.0.1:8000/api/v1/hello-world) to see the respons of the `hello-world` operation.
+3. Interactive documentation is provided at [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
+
+
+The CLI provides extensive help:
+
+```shell
+uvx aignostics --help                # all CLI commands
+uvx aignostics hello-world --help    # help for specific command
+uvx aignostics echo --help
+uvx aignostics openapi --help
+uvx aignostics serve --help
+```
+
+
+## Operational Excellence
+
+This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
+
+1. Various examples demonstrating usage:
+  a. [Simple Python script](https://github.com/aignostics/python-sdk/blob/main/examples/script.py)
+  b. [Streamlit web application](https://aignostics.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
+  c. [Jupyter](https://github.com/aignostics/python-sdk/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/aignostics/python-sdk/blob/main/examples/notebook.py) notebook
+2. [Complete reference documentation](https://aignostics.readthedocs.io/en/latest/reference.html) on Read the Docs
+3. [Transparent test coverage](https://app.codecov.io/gh/aignostics/python-sdk) including unit and E2E tests (reported on Codecov)
+4. Matrix tested with [multiple python versions](https://github.com/aignostics/python-sdk/blob/main/noxfile.py) to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
+5. Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
+6. Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate) and [Dependabot](https://github.com/aignostics/python-sdk/security/dependabot))
+7. [A-grade code quality](https://sonarcloud.io/summary/new_code?id=aignostics_python-sdk) in security, maintainability, and reliability with low technical debt and codesmell (verified by SonarQube)
+8. Additional code security checks using [CodeQL](https://github.com/aignostics/python-sdk/security/code-scanning)
+9. [Security Policy](SECURITY.md)
+10. [License](LICENSE) compliant with the Open Source Initiative (OSI)
+11. 1-liner for installation and execution of command line interface (CLI) via [uv(x)](https://github.com/astral-sh/uv) or [Docker](https://hub.docker.com/r/helmuthva/aignostics-python-sdk/tags)
+12. Setup for developing inside a [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers) included (supports VSCode and GitHub Codespaces)
+
+
+## Usage Examples
+
+The following examples run from source - clone this repository using
+`git clone git@github.com:aignostics/python-sdk.git`.
+
+### Minimal Python Script:
+
+```python
+"""Example script demonstrating the usage of the service provided by Aignostics Python SDK."""
+
+from dotenv import load_dotenv
+from rich.console import Console
+
+from aignostics import Service
+
+console = Console()
+
+load_dotenv()
+
+message = Service.get_hello_world()
+console.print(f"[blue]{message}[/blue]")
+```
+
+[Show script code](https://github.com/aignostics/python-sdk/blob/main/examples/script.py) - [Read the reference documentation](https://aignostics.readthedocs.io/en/latest/reference.html)
+
+### Streamlit App
+
+Serve the functionality provided by Aignostics Python SDK in the web by easily integrating the service into a Streamlit application.
+
+[Try it out!](https://aignostics.streamlit.app) - [Show the code](https://github.com/aignostics/python-sdk/blob/main/examples/streamlit.py)
+
+... or serve the app locally
+```shell
+uv sync --all-extras                                # Install streamlit dependency part of the examples extra, see pyproject.toml
+uv run streamlit run examples/streamlit.py          # Serve on localhost:8501, opens browser
+```
+
+## Notebooks
+
+### Jupyter
+
+[Show the Jupyter code](https://github.com/aignostics/python-sdk/blob/main/examples/notebook.ipynb)
+
+... or run within VSCode
+
+```shell
+uv sync --all-extras                                # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
+```
+Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
+
+Click on `examples/notebook.ipynb` in VSCode and run it.
+
+### Marimo
+
+[Show the marimo code](https://github.com/aignostics/python-sdk/blob/main/examples/notebook.py)
+
+Execute the notebook as a WASM based web app
+
+```shell
+uv sync --all-extras                                # Install ipykernel dependency part of the examples extra, see pyproject.toml
+uv run marimo run examples/notebook.py --watch      # Serve on localhost:2718, opens browser
+```
+
+or edit interactively in your browser
+
+```shell
+uv sync --all-extras                                # Install ipykernel dependency part of the examples extra, see pyproject.toml
+uv run marimo edit examples/notebook.py --watch     # Edit on localhost:2718, opens browser
+```
+
+... or edit interactively within VSCode
+
+Install the [Marimo extension for VSCode](https://marketplace.visualstudio.com/items?itemName=marimo-team.vscode-marimo)
+
+Click on `examples/notebook.py` in VSCode and click on the caret next to the Run icon above the code (looks like a pencil) > "Start in marimo editor" (edit).
+
+## Command Line Interface (CLI)
+
+### Run with [uvx](https://docs.astral.sh/uv/guides/tools/)
+
+Show available commands:
+
+```shell
+uvx aignostics --help
+```
+
+Execute commands:
+
+```shell
+uvx aignostics hello-world
+uvx aignostics echo --help
+uvx aignostics echo "Lorem"
+uvx aignostics echo "Lorem" --json
+uvx aignostics openapi
+uvx aignostics openapi --output-format=json
+uvx aignostics serve
+```
+
+### Environment
+
+The service loads environment variables including support for .env files.
+
+```shell
+cp .env.example .env              # copy example file
+echo "THE_VAR=MY_VALUE" > .env    # overwrite with your values
+```
+
+Now run the usage examples again.
+
+### Run with Docker
+
+You can as well run the CLI within Docker.
+
+```shell
+docker run helmuthva/aignostics-python-sdk --help
+docker run helmuthva/aignostics-python-sdk hello-world
+docker run helmuthva/aignostics-python-sdk echo --help
+docker run helmuthva/aignostics-python-sdk echo "Lorem"
+docker run helmuthva/aignostics-python-sdk echo "Lorem" --json
+docker run helmuthva/aignostics-python-sdk openapi
+docker run helmuthva/aignostics-python-sdk openapi --output-format=json
+docker run helmuthva/aignostics-python-sdk serve
+```
+
+Execute command:
+
+```shell
+docker run --env THE_VAR=MY_VALUE helmuthva/aignostics-python-sdk echo "Lorem Ipsum"
+```
+
+Or use docker compose
+
+The .env is passed through from the host to the Docker container.
+
+```shell
+docker compose run aignostics --help
+docker compose run aignostics hello-world
+docker compose run aignostics echo --help
+docker compose run aignostics echo "Lorem"
+docker compose run aignostics echo "Lorem" --json
+docker compose run aignostics openapi
+docker compose run aignostics openapi --output-format=json
+docker compose up
+curl http://127.0.0.1:8000/api/v1/hello-world
+curl http://127.0.0.1:8000/api/v1/docs
+curl http://127.0.0.1:8000/api/v2/hello-world
+curl http://127.0.0.1:8000/api/v2/docs
+```
+
+## Extra: Lorem Ipsum
+
+Dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam.
+
+
+## Further Reading
+
+* Check out the [reference](https://aignostics.readthedocs.io/en/latest/reference.html) with detailed documentation of public classes and functions.
+* Our [release notes](https://aignostics.readthedocs.io/en/latest/release-notes.html) provide a complete log of recent improvements and changes.
+* In case you want to help us improve 🔬 Aignostics Python SDK: The [contribution guidelines](https://aignostics.readthedocs.io/en/latest/contributing.html) explain how to setup your development environment and create pull requests.
+
+## Star History
+
+<a href="https://star-history.com/#aignostics/python-sdk">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=aignostics/python-sdk&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=aignostics/python-sdk&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=aignostics/python-sdk&type=Date" />
+ </picture>
+</a>

aignostics-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+aignostics/__init__.py,sha256=iAqIfmcFS5DkiQyJQCSkLqSlglrIDB2t-_2gAkHlqbs,276
+aignostics/api.py,sha256=_eoVpxfH6WPudnCad21IgdE-7zThJ6fNjtbSU3hSMMM,6217
+aignostics/cli.py,sha256=ex4ywnJG-YtQjEFj1keqXEsfaPSgm70wiFad0NutIMw,3411
+aignostics/constants.py,sha256=7kqUdabmtRqxal_ZIx_0wVhzVHI4dicOVoHQ9h4P3qk,353
+aignostics/service.py,sha256=vF9TeIMGeOrOdPYoMzaEFlFUlRV1_TXtCJOSMUwErkk,750
+aignostics-0.0.1.dist-info/METADATA,sha256=0WLqG0B2LbvYbKw5HRES9Mj_BB9TiSgobDX-BEtfDEY,24969
+aignostics-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aignostics-0.0.1.dist-info/entry_points.txt,sha256=wjAm-SIqSt9_1YU6UodhOpduT0OGvohSEJp5FbuUMqk,50
+aignostics-0.0.1.dist-info/licenses/LICENSE,sha256=-M3GfV1uL55s46W22-zcZMDRT5SRGij3RDbn4xDp0gQ,1101
+aignostics-0.0.1.dist-info/RECORD,,

aignostics-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aignostics-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aignostics = aignostics.cli:cli

aignostics-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [Aignostics GmbH (support@aignostics.com)]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.