Geoprocessing job lifecycle¶
Server contract first¶
HonuaGeoprocessing operates registered OGC API Processes. It does not upload
or execute arbitrary Python code.
| Item | Contract |
|---|---|
| Capability | process.ogc-api-processes |
| Submit | POST /ogc/processes/processes/{processId}/execution |
| Status | GET /ogc/processes/jobs/{jobId} |
| Results | GET /ogc/processes/jobs/{jobId}/results |
| Cancel | DELETE /ogc/processes/jobs/{jobId} (best effort) |
| Auth | HonuaClient API key, bearer token, or refreshable auth provider |
| Fixture | honua-samples/jobs/geoprocessing-job-lifecycle.json#job-page-fixture:geometry-buffer-v1 |
| Maturity | Source preview; not yet published to PyPI |
Inspect the process description before constructing inputs; those schemas are
defined by the registered server process. The focused example therefore takes
an explicit process id and JSON input object rather than embedding a payload
that only works for one deployment:
python examples/geoprocessing_job_lifecycle.py \
--process-id geometry.buffer \
--inputs-json '{"inputGeoJson":"{}","distance":100}'
That command belongs to the example script. The product honua CLI currently
has no process/job subcommands.
The example calls the real
HonuaGeoprocessing.submit_inputs,
wait, and
results
methods. The wait has a deadline and performs a best-effort dismiss on timeout.
Use dismiss(job_id) only from an explicit operator cancellation action.
The shared, server-first JS/Python/.NET task contract, expected status sequence,
and semantic assertion live in honua-samples/jobs/geoprocessing-job-lifecycle.json.
Custom Python batch jobs¶
Custom-code authoring is a separate production project. The current server
contract is AWS-Batch-only and pins runtime, allowlisted repository, full commit
SHA, module:function entrypoint, dependency manifest, declared scope, and a
server-assigned output prefix. The Python SDK has no custom-code authoring or
submission API, and no current Studio Python editor/publish flow is admitted.
Do not substitute submit_inputs() for that missing product surface.