Skip to main content

Schedule async tasks and manage them using a REST API or WEB UI

Project description


Join the chat at PyPI - Python Version PyPI PyPI - License GitHub last commit

Schedule and run asyncio coroutines and manage them from a web interface or programmatically using the rest api.

Requires python >= 3.6

How to install

pip3 install aiocronjob

Usage example

# examples/

import asyncio

from aiocronjob import manager, Job
from aiocronjob import run_app

async def first_task():
    for i in range(20):
        print("first task log", i)
        await asyncio.sleep(1)

async def second_task():
    for i in range(10):
        await asyncio.sleep(1.5)
        print("second task log", i)
    raise Exception("second task exception")

manager.register(first_task, name="First task", crontab="22 * * * *")

manager.register(second_task, name="Second task", crontab="23 * * * *")

async def on_job_exception(job: Job, exc: BaseException):
    print(f"An exception occurred for job {}: {exc}")

async def on_job_cancelled(job: Job):
    print(f"{} was cancelled...")

async def on_startup():
    print("The app started.")

async def on_shutdown():
    print("The app stopped.")


if __name__ == "__main__":

After running the app, the FastAPI server runs at localhost:5000.

Web Interface

Open localhost:5000 in your browser:

screenshot-actionmenu screenshot-all

Rest API

Open localhost:5000/docs for endpoints docs.


curl example:

$ curl
    "name": "First task",
    "next_run_in": "3481.906931",
    "last_status": "pending",
    "enabled": "True",
    "crontab": "22 * * * *",
    "created_at": "2020-06-06T10:20:25.118630+00:00",
    "started_at": null,
    "stopped_at": null
    "name": "Second task",
    "next_run_in": "3541.904723",
    "last_status": "error",
    "enabled": "True",
    "crontab": "23 * * * *",
    "created_at": "2020-06-06T10:20:25.118661+00:00",
    "started_at": "2020-06-06T10:23:00.000906+00:00",
    "stopped_at": "2020-06-06T10:23:15.004351+00:00"

Project details

Download files

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

Files for aiocronjob, version 0.2.4
Filename, size File type Python version Upload date Hashes
Filename, size aiocronjob-0.2.4-py3-none-any.whl (1.5 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aiocronjob-0.2.4.tar.gz (740.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page