Hugo/token factory api

.github/workflows/python.yml

@@ -0,0 +1,37 @@
+# NOTE: Originally generated by OpenAPI Generator, now hand-maintained.
+# Listed in .openapi-generator-ignore so `make generate` won't clobber it.
+# URL: https://openapi-generator.tech
+#
+# ref: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: saturn_api Python package
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r test-requirements.txt
+      - name: Test with pytest
+        run: |
+          # Exit code 5 = "no tests collected"; the generated client ships no
+          # tests, so treat that as success rather than a CI failure.
+          pytest --cov=saturn_api || [ $? -eq 5 ]

.openapi-generator-ignore

@@ -33,3 +33,6 @@ test/
 git_push.sh
 .travis.yml
 .gitlab-ci.yml
+
+# Hand-maintained CI (pytest passes with no tests); don't let regen clobber it
+.github/workflows/python.yml

.openapi-generator/FILES

@@ -12,15 +12,29 @@ docs/ApiTokenList.md
 docs/ApiTokenUpdate.md
 docs/ApiTokensApi.md
 docs/AppInfo.md
+docs/Artifact.md
+docs/ArtifactCreate.md
+docs/ArtifactKind.md
+docs/ArtifactList.md
+docs/ArtifactStatus.md
+docs/ArtifactUpdate.md
+docs/ArtifactsApi.md
 docs/Auth0Info.md
 docs/AuthorizationApi.md
 docs/AuthorizationCodeGrant.md
 docs/AuthorizationGrant.md
 docs/AuthorizationRefreshGrant.md
 docs/AuthorizationTokenResponse.md
 docs/BuildData.md
+docs/Cluster.md
+docs/ClusterConnectionType.md
+docs/ClusterCreate.md
+docs/ClusterList.md
+docs/ClusterUpdate.md
+docs/ClustersApi.md
 docs/ConcurrencyPolicy.md
 docs/Condition.md
+docs/ConfigFileEntry.md
 docs/ContainerRuntimeSummary.md
 docs/ContainerStatus.md
 docs/CronSchedule.md
@@ -46,6 +60,12 @@ docs/DaskComponents.md
 docs/DaskWorkerRuntimeSummaryList.md
 docs/DaskWorkerSummary.md
 docs/DataPoint.md
+docs/Dataset.md
+docs/DatasetCreate.md
+docs/DatasetImportCreate.md
+docs/DatasetList.md
+docs/DatasetLockCreate.md
+docs/DatasetsApi.md
 docs/DefaultImages.md
 docs/DefaultSizes.md
 docs/Deployment.md
@@ -60,6 +80,7 @@ docs/DeploymentStart.md
 docs/DeploymentStatus.md
 docs/DeploymentUpdate.md
 docs/DeploymentsApi.md
+docs/DiskSpaceOption.md
 docs/ExternalRepo.md
 docs/ExternalRepoAttachment.md
 docs/ExternalRepoAttachmentCreate.md
@@ -77,6 +98,11 @@ docs/ExtraPackagesRecipe.md
 docs/ExtraPackagesRecipeApt.md
 docs/ExtraPackagesRecipeConda.md
 docs/ExtraPackagesRecipePip.md
+docs/FineTuneJobCreate.md
+docs/FineTuneJobList.md
+docs/FineTuneJobSummary.md
+docs/FineTuneJobView.md
+docs/FineTuningJobsApi.md
 docs/Group.md
 docs/GroupCreate.md
 docs/GroupList.md
@@ -88,6 +114,8 @@ docs/GroupsApi.md
 docs/HardwareType.md
 docs/HistoricLog.md
 docs/HistoricLogList.md
+docs/Hyperparameters.md
+docs/Hyperparameters1.md
 docs/Identity.md
 docs/IdentityByGroupId.md
 docs/IdentityByUserId.md
@@ -116,6 +144,11 @@ docs/ImageTagUpdate.md
 docs/ImageTagsApi.md
 docs/ImageUpdate.md
 docs/ImagesApi.md
+docs/InferenceEndpointCreate.md
+docs/InferenceEndpointList.md
+docs/InferenceEndpointSummary.md
+docs/InferenceEndpointView.md
+docs/InferenceEndpointsApi.md
 docs/InfoApi.md
 docs/InstanceSize.md
 docs/Invitation.md
@@ -223,6 +256,7 @@ docs/RouteBySubdomain.md
 docs/RouteCreate.md
 docs/RouteList.md
 docs/RouteReference.md
+docs/RouteState.md
 docs/RouteUpdate.md
 docs/SSHPrivateKey.md
 docs/SSHPrivateKeyCreate.md
@@ -316,15 +350,20 @@ saturn_api/api/__init__.py
 saturn_api/api/active_api.py
 saturn_api/api/api_status_api.py
 saturn_api/api/api_tokens_api.py
+saturn_api/api/artifacts_api.py
 saturn_api/api/authorization_api.py
+saturn_api/api/clusters_api.py
 saturn_api/api/current_user_api.py
 saturn_api/api/dask_clusters_api.py
+saturn_api/api/datasets_api.py
 saturn_api/api/deployments_api.py
 saturn_api/api/external_repo_attachments_api.py
 saturn_api/api/external_repos_api.py
+saturn_api/api/fine_tuning_jobs_api.py
 saturn_api/api/groups_api.py
 saturn_api/api/image_tags_api.py
 saturn_api/api/images_api.py
+saturn_api/api/inference_endpoints_api.py
 saturn_api/api/info_api.py
 saturn_api/api/invitations_api.py
 saturn_api/api/jobs_api.py
@@ -356,14 +395,26 @@ saturn_api/models/api_token_info.py
 saturn_api/models/api_token_list.py
 saturn_api/models/api_token_update.py
 saturn_api/models/app_info.py
+saturn_api/models/artifact.py
+saturn_api/models/artifact_create.py
+saturn_api/models/artifact_kind.py
+saturn_api/models/artifact_list.py
+saturn_api/models/artifact_status.py
+saturn_api/models/artifact_update.py
 saturn_api/models/auth0_info.py
 saturn_api/models/authorization_code_grant.py
 saturn_api/models/authorization_grant.py
 saturn_api/models/authorization_refresh_grant.py
 saturn_api/models/authorization_token_response.py
 saturn_api/models/build_data.py
+saturn_api/models/cluster.py
+saturn_api/models/cluster_connection_type.py
+saturn_api/models/cluster_create.py
+saturn_api/models/cluster_list.py
+saturn_api/models/cluster_update.py
 saturn_api/models/concurrency_policy.py
 saturn_api/models/condition.py
+saturn_api/models/config_file_entry.py
 saturn_api/models/container_runtime_summary.py
 saturn_api/models/container_status.py
 saturn_api/models/cron_schedule.py
@@ -387,6 +438,11 @@ saturn_api/models/dask_components.py
 saturn_api/models/dask_worker_runtime_summary_list.py
 saturn_api/models/dask_worker_summary.py
 saturn_api/models/data_point.py
+saturn_api/models/dataset.py
+saturn_api/models/dataset_create.py
+saturn_api/models/dataset_import_create.py
+saturn_api/models/dataset_list.py
+saturn_api/models/dataset_lock_create.py
 saturn_api/models/default_images.py
 saturn_api/models/default_sizes.py
 saturn_api/models/deployment.py
@@ -400,6 +456,7 @@ saturn_api/models/deployment_spec.py
 saturn_api/models/deployment_start.py
 saturn_api/models/deployment_status.py
 saturn_api/models/deployment_update.py
+saturn_api/models/disk_space_option.py
 saturn_api/models/external_repo.py
 saturn_api/models/external_repo_attachment.py
 saturn_api/models/external_repo_attachment_create.py
@@ -415,6 +472,10 @@ saturn_api/models/extra_packages_recipe.py
 saturn_api/models/extra_packages_recipe_apt.py
 saturn_api/models/extra_packages_recipe_conda.py
 saturn_api/models/extra_packages_recipe_pip.py
+saturn_api/models/fine_tune_job_create.py
+saturn_api/models/fine_tune_job_list.py
+saturn_api/models/fine_tune_job_summary.py
+saturn_api/models/fine_tune_job_view.py
 saturn_api/models/group.py
 saturn_api/models/group_create.py
 saturn_api/models/group_list.py
@@ -425,6 +486,8 @@ saturn_api/models/group_update.py
 saturn_api/models/hardware_type.py
 saturn_api/models/historic_log.py
 saturn_api/models/historic_log_list.py
+saturn_api/models/hyperparameters.py
+saturn_api/models/hyperparameters1.py
 saturn_api/models/identity.py
 saturn_api/models/identity_by_group_id.py
 saturn_api/models/identity_by_user_id.py
@@ -451,6 +514,10 @@ saturn_api/models/image_tag_reference.py
 saturn_api/models/image_tag_state.py
 saturn_api/models/image_tag_update.py
 saturn_api/models/image_update.py
+saturn_api/models/inference_endpoint_create.py
+saturn_api/models/inference_endpoint_list.py
+saturn_api/models/inference_endpoint_summary.py
+saturn_api/models/inference_endpoint_view.py
 saturn_api/models/instance_size.py
 saturn_api/models/invitation.py
 saturn_api/models/invitation_create.py
@@ -550,6 +617,7 @@ saturn_api/models/route_by_subdomain.py
 saturn_api/models/route_create.py
 saturn_api/models/route_list.py
 saturn_api/models/route_reference.py
+saturn_api/models/route_state.py
 saturn_api/models/route_update.py
 saturn_api/models/secret.py
 saturn_api/models/secret_access_level.py

.openapi-generator/VERSION

@@ -1 +1 @@
-7.17.0
+7.22.0

Makefile

@@ -10,6 +10,7 @@ update: copy-client-yaml generate format
 .PHONY: generate
 generate:
 	openapi-generator-cli generate -g python -i client.yaml -c openapi-generator-config.yaml --remove-operation-id-prefix -t templates/python
+	@sed -i 's/^httpx = ">= \(.*\)"$$/httpx >= \1/' requirements.txt
 
 .PHONY: format
 format: