up

src/Sdk/StellaOps.Sdk.Generator/python/README.md

@@ -0,0 +1,19 @@
+# Python SDK (SDKGEN-63-002)
+
+Deterministic generator settings for the Python SDK (asyncio library).
+
+## Prereqs
+- `STELLA_OAS_FILE` pointing to the frozen OpenAPI spec.
+- OpenAPI Generator CLI 7.4.0 jar at `tools/openapi-generator-cli-7.4.0.jar` (override with `STELLA_OPENAPI_GENERATOR_JAR`).
+- JDK 21 available on PATH (vendored at `../tools/jdk-21.0.1+12`; set `JAVA_HOME` if needed).
+
+## Generate
+```bash
+cd src/Sdk/StellaOps.Sdk.Generator
+STELLA_OAS_FILE=ts/fixtures/ping.yaml \
+STELLA_SDK_OUT=$(mktemp -d) \
+python/generate-python.sh
+```
+
+Outputs land in `out/python/` and are post-processed to normalize whitespace, inject the banner, and copy shared helpers (`sdk_hooks.py`).
+Override `STELLA_SDK_OUT` to keep the repo clean during local runs.

src/Sdk/StellaOps.Sdk.Generator/python/config.yaml

@@ -0,0 +1,19 @@
+# OpenAPI Generator config for the StellaOps Python SDK (alpha)
+generatorName: python
+outputDir: out/python
+additionalProperties:
+  packageName: stellaops_sdk
+  projectName: stellaops-sdk
+  packageVersion: "0.0.0a0"
+  hideGenerationTimestamp: true
+  generateSourceCodeOnly: true
+  useOneOfDiscriminatorLookup: true
+  enumClassPrefix: true
+  httpUserAgent: "stellaops-sdk/0.0.0a0"
+  library: asyncio
+
+globalProperty:
+  apiDocs: false
+  modelDocs: false
+  apiTests: false
+  modelTests: false

src/Sdk/StellaOps.Sdk.Generator/python/generate-python.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root_dir="$(cd -- "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+config="$root_dir/python/config.yaml"
+spec="${STELLA_OAS_FILE:-}"
+
+if [ -z "$spec" ]; then
+  echo "STELLA_OAS_FILE is required (path to OpenAPI spec)" >&2
+  exit 1
+fi
+
+output_dir="${STELLA_SDK_OUT:-$root_dir/out/python}"
+mkdir -p "$output_dir"
+
+export STELLA_POSTPROCESS_ROOT="$output_dir"
+export STELLA_POSTPROCESS_LANG="python"
+
+jar="${STELLA_OPENAPI_GENERATOR_JAR:-$root_dir/tools/openapi-generator-cli-7.4.0.jar}"
+if [ ! -f "$jar" ]; then
+  echo "OpenAPI Generator CLI jar not found at $jar" >&2
+  exit 1
+fi
+
+JAVA_OPTS="${JAVA_OPTS:-} -Dorg.openapitools.codegen.utils.postProcessFile=$root_dir/postprocess/postprocess.sh"
+export JAVA_OPTS
+
+java -jar "$jar" generate \
+  -i "$spec" \
+  -g python \
+  -c "$config" \
+  --skip-validate-spec \
+  --enable-post-process-file \
+  --global-property models,apis,supportingFiles \
+  -o "$output_dir"
+
+echo "Python SDK generated at $output_dir"

src/Sdk/StellaOps.Sdk.Generator/python/test_generate_python.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root_dir="$(cd -- "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+script="$root_dir/python/generate-python.sh"
+spec="$root_dir/ts/fixtures/ping.yaml"
+jar_default="$root_dir/tools/openapi-generator-cli-7.4.0.jar"
+jar="${STELLA_OPENAPI_GENERATOR_JAR:-$jar_default}"
+
+if [ ! -f "$jar" ]; then
+  echo "SKIP: generator jar not found at $jar" >&2
+  exit 0
+fi
+
+if ! command -v java >/dev/null 2>&1; then
+  echo "SKIP: java not on PATH; set JAVA_HOME to run this smoke." >&2
+  exit 0
+fi
+
+out_dir="$(mktemp -d)"
+trap 'rm -rf "$out_dir"' EXIT
+
+STELLA_OAS_FILE="$spec" \
+STELLA_SDK_OUT="$out_dir" \
+STELLA_OPENAPI_GENERATOR_JAR="$jar" \
+"$script"
+
+test -f "$out_dir/stellaops_sdk/__init__.py" || { echo "missing generated package" >&2; exit 1; }
+test -f "$out_dir/sdk_hooks.py" || { echo "missing helper copy" >&2; exit 1; }
+
+echo "Python generator smoke test passed"