rocketry 2.2.0

Advanced scheduling framework

Rocketry

The engine to power your Python apps

---

What is it?

Rocketry is a modern scheduling framework for Python applications. It is simple, clean and extensive. It is the automation engine that sets your Python programs alive.

The library is minimal on the surface but large and highly customizable underneath. The syntax very clean:

from rocketry import Rocketry

app = Rocketry()

@app.task('daily')
def do_daily():
    ...

if __name__ == '__main__':
    app.run()

Dislike the string syntax?

There is also a condition API which is almost identical to the string syntax:

from rocketry import Rocketry
from rocketry.conds import daily

app = Rocketry()

@app.task(daily)
def do_daily():
    ...

if __name__ == '__main__':
    app.run()

Compared to alternatives, Rocketry has the most elegant syntax and is the most productive. It offers more features than Crontab or APScheduler but is much easier to work with than Airflow. It does not make assumptions of your project.

Core functionalities:

• Powerful scheduling syntax
• A lot of built-in scheduling options
• Task parallelization
• Task parametrization
• Task pipelining
• Modifiable session also in runtime
• Async support

Links:

• Documentation: https://rocketry.readthedocs.io
• Source code: https://github.com/Miksus/rocketry
• Releases: https://pypi.org/project/rocketry/

Installation

Install Rocketry from PyPI:

pip install rocketry

More Examples

Here are some more examples of what it can do.

Scheduling:

@app.task("every 10 seconds")
def do_continuously():
    ...

@app.task("daily after 07:00")
def do_daily_after_seven():
    ...

@app.task("hourly & time of day between 22:00 and 06:00")
def do_hourly_at_night():
    ...

@app.task("(weekly on Monday | weekly on Saturday) & time of day after 10:00")
def do_twice_a_week_after_ten():
    ...

Same with condition API

from rocketry.conds import every, daily, hourly, time_of_day, weekly

@app.task(every("10 seconds"))
def do_continuously():
    ...

@app.task(daily.after("07:00"))
def do_daily_after_seven():
    ...

@app.task(hourly & time_of_day.between("22:00", "06:00"))
def do_hourly_at_night():
    ...

@app.task((weekly.on("Monday") | weekly.on("Saturday")) & time_of_day.after("10:00"))
def do_twice_a_week_after_ten():
    ...

Pipelining tasks:

from rocketry.args import Return

@app.task("daily after 07:00")
def do_first():
    ...
    return 'Hello World'

@app.task("after task 'do_first'")
def do_second(arg=Return('do_first')):
    # arg contains the value of the task do_first's return
    ...
    return 'Hello Python'

Same with condition API

from rocketry.conds import daily, after_success
from rocketry.args import Return

@app.task(daily.after("07:00"))
def do_first():
    ...
    return 'Hello World'

@app.task(after_success(do_first))
def do_second(arg=Return(do_first)):
    # arg contains the value of the task do_first's return
    ...
    return 'Hello Python'

Parallelizing tasks:

@app.task("daily", execution="main")
def do_unparallel():
    ...

@app.task("daily", execution="async")
async def do_async():
    ...

@app.task("daily", execution="thread")
def do_on_separate_thread():
    ...

@app.task("daily", execution="process")
def do_on_separate_process():
    ...

---

Interested?

Read more from the documentation.

About Library

• Author: Mikael Koli (Miksus) - [e-mail]
• License: MIT