Warning

The v4.0 series is provided as a pre-release and may change in a backwards incompatible fashion without any migration pathway, so do NOT use this release in production!

Advanced Python Scheduler (APScheduler) is a task scheduler and task queue system for Python. It can be used solely as a job queuing system if you have no need for task scheduling. It scales both up and down, and is suitable for both trivial, single-process use cases as well as large deployments spanning multiple nodes. Multiple schedulers and workers can be deployed to use a shared data store to provide both a degree of high availability and horizontal scaling.

APScheduler comes in both synchronous and asynchronous flavors, making it a good fit for both traditional, thread-based applications, and asynchronous (asyncio or Trio) applications. Documentation and examples are provided for integrating with either WSGI or ASGI compatible web applications.

Support is provided for persistent storage of schedules and jobs. This means that they can be shared among multiple scheduler/worker instances and will survive process and node restarts.

The built-in persistent data store back-ends are:

• PostgreSQL
• MySQL and derivatives
• SQLite
• MongoDB

The built-in event brokers (needed in scenarios with multiple schedulers and/or workers):

• PostgreSQL
• Redis
• MQTT

The built-in scheduling mechanisms (triggers) are:

• Cron-style scheduling
• Interval-based scheduling (runs tasks on even intervals)
• Calendar-based scheduling (runs tasks on intervals of X years/months/weeks/days, always at the same time of day)
• One-off scheduling (runs a task once, at a specific date/time)

Different scheduling mechanisms can even be combined with so-called combining triggers (see the documentation for details).

You can also implement your custom scheduling logic by building your own trigger class. These will be treated no differently than the built-in ones.

Other notable features include:

• You can limit the maximum number of simultaneous jobs for a given task (function)
• You can limit the amount of time a job is allowed to start late
• Jitter (adjustable, random delays added to the run time of each scheduled job)

Documentation

Documentation can be found here.

Source

The source can be browsed at Github.

Reporting bugs

A bug tracker is provided by GitHub.

Getting help

If you have problems or other questions, you can either:

• Ask in the apscheduler room on Gitter
• Post a question on GitHub discussions, or
• Post a question on StackOverflow and add the apscheduler tag