All notable changes to PythonScriptRunner are documented in this file. The format is based on
Keep a Changelog, and the project follows
Semantic Versioning. The NuGet packages and the container images share one
version; the psrunner SDK has its own version on PyPI.
- Guides in English and Portuguese (
guides/): getting started and the ways to use the library, stages, pipelines, the Python SDK, persistence, queue and scheduling, the dashboard, hosting, a configuration reference and how it works.
- The README covers every capability with short examples and links to the guides. The
psrunnerREADME, the PyPI page, is now a complete reference of the SDK. psrunner0.1.1 publishes that README on PyPI. The code is the same as 0.1.0.
- Dashboard: in the field builder of the stage editor, the label of the "required" switch no longer breaks into syllables in the narrow side panel.
0.1.0 - 2026-10-21
The first release.
- Core runner (
PythonScriptRunner.Core,PythonScriptRunner.Abstractions):- stages with typed inputs and outputs (12 field types, including
table,fileandlist<T>), defined instage.jsonor in C#; - each attempt runs in an isolated process: a clean environment, its own work folder, a timeout and a memory limit
(Job Object on Windows; cgroup v2 when it can be delegated on Linux, otherwise
RLIMIT_ASwithThreadsPerProcess); - secrets reach only the stages that declare them, and are masked in the captured output;
- Python environments created and cached by uv, one per set of dependencies.
- stages with typed inputs and outputs (12 field types, including
- Pipelines:
- steps bound to the pipeline's inputs, to earlier steps' outputs or to constants;
- types and bindings validated when the catalog loads;
- defined in
*.pipeline.jsonor in C#.
psrunner0.1.0, the Python SDK:@stage,Context,FileandStageError;psrunner.testing.run_stage, to test stages with pytest without .NET.
- Persistence (
PythonScriptRunner.EntityFrameworkCore, PostgreSQL 16+):- a versioned catalog (draft, published, archived), with dependencies locked by hash on publish and zip import and export;
- the full history of runs, attempts, logs and files;
- idempotency keys, an audit log and partitioned retention.
- Queue (
PythonScriptRunner.RabbitMQ, RabbitMQ 3.13+):- queued runs through a transactional outbox;
- the public
StartPipelineRuncommand,run.*andstep.*events, and subscriptions for event handlers.
- Worker (
PythonScriptRunner.Worker):- leases, retries with exponential backoff, recovery of lost workers and cancellation;
- concurrency limits per worker and per pipeline;
- cron schedules with IANA time zones and catch-up runs.
- Dashboard (
PythonScriptRunner.Dashboard):- an embeddable dashboard with an internal API and real-time updates (SignalR);
- a Vue UI to edit, test and publish stages and pipelines, follow runs live, and manage schedules, the audit log and administration;
- four cumulative roles, and access by fixed login, a custom filter, host authentication or local requests.
psrtool (PythonScriptRunner.Tool):psr hash-passwordgenerates the password hashes for fixed login.- Hosts and images:
WorkerHostandDashboardHost, configured by environment variables, with health checks, JSON logs, OpenTelemetry and optional migrations at startup (PSR_AUTO_MIGRATE). The DashboardHost also supports OpenID Connect;- multi-arch images
ghcr.io/scriptrunnerkit/psr-workerandghcr.io/scriptrunnerkit/psr-dashboard: non-root, read-only root file system, with an SBOM and provenance.
- Local environment: a .NET Aspire AppHost with PostgreSQL, RabbitMQ, Mailpit, both hosts and the UI in development
mode.
aspire publishgenerates a Docker Compose file from it.
| PythonScriptRunner (NuGet and images) | .NET | Protocol | psrunner |
Python |
|---|---|---|---|---|
| 0.1.0 | 10 | 1 | 0.1.x | 3.10–3.13 |