Calycopis-openapi

OpenAPI schema and generated client/server packages for the IVOA ExecutionBroker web service (formerly known as Calycopis-schema).

This project is named after the trebula groundstreak (Calycopis_trebula) butterfly.

Current work on this project is being developed as part of the SKA SRCNet and UKSRC programs.

What this project provides

The IVOA ExecutionBroker OpenAPI 3.1.0 schema under schema/v1.0/, with execution-broker.yaml as the top-level entry point.
An isobeon schema pre-processor (git submodule) that resolves $ref references and merges the multi-file schema into a single YAML file for the code generators.
Generated packages, all built with the openapi-generator-maven-plugin:
- Java Spring Boot server — calycopis-openapi-spring
- Java client — calycopis-openapi-client
- Python client — calycopis_openapi_client (including a hand-written wrappers/ layer with the higher-level ExecutionBrokerClient)

See AGENTS.md for the full project structure, build process, code generation details, and CI/CD workflows.