Add api client generation

Author: aman

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.gitignore

@@ -39,3 +39,8 @@ htmlcov/
 # OS
 .DS_Store
 Thumbs.db
+
+## API generator
+.ruff_cache/
+openapi.json
+openapi.codegen.json

README.md

@@ -50,6 +50,14 @@ The release / publish workflow is defined as:
 - Create a new GitHub release based on that tag, baptize the release identical to the tag and add release notes.
 - Triggered by the release creation the GitHub Action `publish.yml` will build the package and publish it to PyPi.
 
+Update the API client
+
+The API generator <https://pypi.org/project/openapi-python-client/> is used.
+
+```bash
+./generate_api_client.sh <ip_or_hostname_of_my_bodyloop_instance>
+```
+
 ## License
 
 See [LICENSE](LICENSE)

generate-api-client.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+HOSTNAME=${1:-bodyloop-control-pc}
+
+curl -kO https://${HOSTNAME}/api/v2/openapi.json
+
+# Optionally beautify the JSON file with jq
+mv openapi.json openapi_tmp.json && jq . openapi_tmp.json > openapi.json && rm openapi_tmp.json
+
+# Generate the API client code
+mkdir -p src/bodyloop_sdk/api
+
+# Normalize OpenAPI for openapi-python-client compatibility
+uv run python scripts/prepare_openapi_for_codegen.py --input openapi.json --output openapi.codegen.json
+
+uv run --with openapi-python-client python -m openapi_python_client generate --overwrite --config generate-api-client.yml --path openapi.codegen.json --output-path src/bodyloop_sdk
+
+mv src/bodyloop_sdk/README.md src/bodyloop_sdk/client/
+
+rm src/bodyloop_sdk/.gitignore
+rm src/bodyloop_sdk/pyproject.toml
+rm -rf src/bodyloop_sdk/client/.ruff_cache/

generate-api-client.yml

@@ -0,0 +1,9 @@
+project_name_override: client
+package_name_override: client
+class_overrides:
+  _PrivateInternalLongName:
+    class_name: ShortName
+    module_name: short_name
+docstrings_on_attributes: true
+literal_enums: true
+generate_all_tags: true