decidalo-client 0.0.2

An async Python client for the decidalo V3 Import API

decidalo_client.py

An async Python client for the decidalo V3 Import API (Swagger UI)

[!IMPORTANT] This is a community project and is NOT an official decidalo client. It is not affiliated with or endorsed by Data Assessment Solutions GmbH.

Installation

pip install decidalo-client

Usage

import asyncio
from decidalo_client import DecidaloClient, DecidaloAPIError, DecidaloAuthenticationError

async def main() -> None:
    async with DecidaloClient(api_key="your-api-key") as client:
        # Get all users
        users = await client.get_users()
        for user in users:
            print(f"{user.displayName} ({user.email})")

        # Get all projects
        projects = await client.get_all_projects()
        for project in projects:
            print(f"{project.properties.name.value}")

if __name__ == "__main__":
    asyncio.run(main())

Error Handling

import asyncio
from decidalo_client import DecidaloClient, DecidaloAPIError, DecidaloAuthenticationError

async def main() -> None:
    async with DecidaloClient(api_key="your-api-key") as client:
        try:
            users = await client.get_users()
        except DecidaloAuthenticationError as e:
            print(f"Authentication failed: {e.message}")
        except DecidaloAPIError as e:
            print(f"API error {e.status_code}: {e.message}")

if __name__ == "__main__":
    asyncio.run(main())

Features

• Async HTTP client built on aiohttp
• Type-safe request/response models using pydantic
• All major API endpoints:
  • Users - Get users, import users (sync/async), check import status
  • Teams - Get teams, import teams (sync/async), check import status
  • Companies - Get companies, import companies
  • Projects - Get projects, get all projects, import projects, check existence
  • Bookings - Get bookings, get bookings by project, import bookings
  • Absences - Get absences, import absences
  • Resource Requests - Get resource requests, import resource requests
  • Roles - Import roles
  • Working Time Patterns - Get working time patterns, import working time patterns

Development

Clone the repository and install the development environment:

git clone https://github.com/Hochfrequenz/decidalo_client.py.git
cd decidalo_client.py
tox -e dev

To regenerate the Pydantic models from the OpenAPI spec:

tox -e codegen

For detailed information on the development setup (tox configuration, IDE setup, etc.), see the Hochfrequenz Python Template Repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.