Scripticus server

The index service for Scripticus, a package manager and registry for scripts. The server provides manifest-aware search, version and dependency resolution, and the publish path for a Scripticus registry. Installing this package provides the scripticus-svr command.

Running the server

scripticus-svr starts the service, printing its version and address on start-up:

$ scripticus-svr --host 0.0.0.0 --port 8000
scripticus-svr 0.1.0 — serving on http://0.0.0.0:8000 (interactive API docs at http://0.0.0.0:8000/docs)

Both options are optional; the default is 127.0.0.1:8000. The API is self-describing: interactive docs are served at /docs and the OpenAPI spec at /openapi.json.

Health check

GET /health returns 200 with {"status": "ok"} while the service is up. It is deliberately unauthenticated — it's a liveness probe for load balancers and container orchestrators.

Docker

The repository ships a docker-compose.yml running the index service as a single container:

$ docker compose up -d
$ curl http://localhost:8000/health
{"status":"ok"}

The intended v1 deployment pairs the index service with a Gitea instance that provides storage, authentication, and namespace ownership; Gitea integration doesn't exist yet, so the compose file is currently server-only and does not stand up a working registry.

Once Gitea is part of the bundle: accounts and organisations are managed in Gitea; a Scripticus namespace is a Gitea user or organisation, claimed first-come-first-served, and publish rights follow Gitea's own membership and ACLs. The library namespace is reserved.

Licence

MIT

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kchannon from gravatar.com kchannon

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scripticus_server-0.1.0.tar.gz (2.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scripticus_server-0.1.0-py3-none-any.whl (3.9 kB view details)

Uploaded Python 3

File details

Details for the file scripticus_server-0.1.0.tar.gz.

File metadata

  • Download URL: scripticus_server-0.1.0.tar.gz
  • Upload date:
  • Size: 2.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for scripticus_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5bd01ffce3d7d45fe4eb28054803981f0162e3c6a0b309b1c63507d18e913754
MD5 1ebcddb01b6ba5fb2a3433bbd6a62554
BLAKE2b-256 fd9478bd36f8a76e61daf867245b449bcf45ce895e863352283817bc4e2e07a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for scripticus_server-0.1.0.tar.gz:

Publisher: release.yml on kevinchannon/scripticus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scripticus_server-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for scripticus_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 41b60b11032ce342d9b1b4419836817f0706da5f1bb2968b9ce1e3a0664f2be4
MD5 deece7de499ea3ac52e863a99bae62ae
BLAKE2b-256 1af9610197a6c90e8caf98f343a54ad79cc5cf9be4b910e7b737eef1b24795cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for scripticus_server-0.1.0-py3-none-any.whl:

Publisher: release.yml on kevinchannon/scripticus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page