Skip to main content

A convenience job scheduler based on APScheduler, FastAPI, Pydantic, SQLAlchemy, and uv.

Project description

Supertask

CI Coverage License Downloads per month

Supported Python versions Status Package version Release Notes

» Documentation | Changelog | PyPI | Issues | Source code | License | Community Forum

About

Supertask is a convenience task runner for programming recurrent or otherwise scheduled jobs, based on the excellent APScheduler, FastAPI, Pydantic, SQLAlchemy, and uv packages, amongst others.

You can use Supertask to invoke time-driven actions like the venerable cron daemon and the contemporary systemd timers are doing it. It can be used both as a standalone program/service, and as a library.

Features

  • Store jobs in databases supported by SQLAlchemy.
  • Supertask aims for DWIM-like usefulness and UX, and provides CLI-, HTTP-, and other interfaces.
  • Optionally, jobs can be pre-seeded from a JSON file config.json, either from the local filesystem, or from a wide range of remote locations. When using the filesystem, a watchdog monitors the file for changes, in order to keep the schedules up to date.

Status

Please note that Supertask is alpha software and a work in progress. Contributions of all kinds are much welcome, in order to make it more solid, and to add features.

Breaking changes should be expected until a 1.0 release, so applying version pinning is strongly recommended when consuming the package.

Installation

See Supertask Installation.

Usage

See Supertask Handbook.

Contribute

See Supertask Sandbox.

Supported by

JetBrains logo.

Special thanks to the people at JetBrains s.r.o. for supporting us with excellent development tooling.

Download files

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

Source Distribution

supertask-0.0.0.tar.gz (20.6 kB view details)

Uploaded Source

Built Distribution

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

supertask-0.0.0-py3-none-any.whl (16.6 kB view details)

Uploaded Python 3

File details

Details for the file supertask-0.0.0.tar.gz.

File metadata

  • Download URL: supertask-0.0.0.tar.gz
  • Upload date:
  • Size: 20.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for supertask-0.0.0.tar.gz
Algorithm Hash digest
SHA256 0daabc7294d68b6a68b06e01dab7a21ffe2f05cbafefce5ae3ef2fd694c496fb
MD5 06b70f627ef20ae126cc094739021a72
BLAKE2b-256 f36f3ba1d30e773adf211eff86c1f9c55fe23f454fd9cb5409a9cb7156cab872

See more details on using hashes here.

File details

Details for the file supertask-0.0.0-py3-none-any.whl.

File metadata

  • Download URL: supertask-0.0.0-py3-none-any.whl
  • Upload date:
  • Size: 16.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for supertask-0.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1f0d661e55cac31e5a3d8a9f82b45b5f3833c33b9d9ceb6ad7088176c2ed1c20
MD5 ae098af9256eb413409ac99c5ae04be3
BLAKE2b-256 1cc8e1a1023bd2431faa3c476492547e24f6c5d3f9514c218b48702765007a9e

See more details on using hashes here.

Supported by

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