jobify 0.1.2

A modern, lightweight and robust task manager with a user-friendly interface and a wide range of features, using the low-level asyncio API and more.

Jobify

Robust task manager. Documentation: https://theseriff.github.io/jobify/

---

---

Jobify is a robust solution that was built from the ground up to handle asynchronous tasks. It offers a clean and modern API that is inspired by leading frameworks.

Key features

• Routing: There are routers like in fastAPI/Starlette/Aiogram.
• Schedule: For cron, add two extra optional fields, * * * * * * *, for the second interval.
• Lifespan: The lifespan of the application is similar to that of FastAPI/Starlette.
• Middleware: Middleware such as fastAPI/Starlette/Aiogram.
• Exception Handling: Exception handling using fastAPI/Starlette.

---

Quick Start

Install Jobify from PyPI:

pip install jobify

Here is a simple example of how to schedule and run a job:

import asyncio
from datetime import datetime, timezone
from zoneinfo import ZoneInfo

from jobify import Jobify


UTC = ZoneInfo("UTC")
# 1. Initialize Jobify
app = Jobify(tz=UTC)


@app.task(cron="* * * * * * *")  # Runs every seconds
async def my_cron() -> None:
    print("Hello! cron running every seconds")


@app.task
def my_job(name: str) -> None:
    now = datetime.now(tz=UTC)
    print(f"Hello, {name}! job running at: {now!r}")


async def main() -> None:
    # 4. Run the Jobify application context
    async with app:
        run_next_day = datetime.now(tz=UTC) + timedelta(days=1)
        job_at = await my_job.schedule("Connor").at(run_next_day)
        job_delay = await my_job.schedule("Sara").delay(20)

        await job_at.wait()
        await job_delay.wait()

        # Or
        # It is blocked indefinitely because the cron has infinite planning.
        # await app.wait_all()


if __name__ == "__main__":
    asyncio.run(main())