feat: adds @cron task decorator

[mikeshultz]

What I did

Adds the @cron task decorator so we can execute arbitrary tasks according to a crontab schedule.

How I did it

Adds an event loop to the runner that checks if cron tasks should be executes. If true, it will kiq the tasks off.

How to verify it

@app.cron("*/5 * * * *")
def every_five_minutes():
    return {"crontime": datetime.utcnow()}

Checklist

• Passes all linting checks (pre-commit and CI jobs)
• New test cases have been added and are passing
• Documentation has been updated
• PR title follows Conventional Commit standard (will be automatically included in the changelog)

[johnson2427]

what happens if the cronjob is scheduled to be less than 15 seconds apart?

[mikeshultz]

Cron has a resolution of 1 minute.

[fubuloubu]

I reduced his to 5 just to be a little more accurate

Can do like a drift sort of logic to make it loosely align with :00 +/- 1 sec (as clock drift may occur)

[fubuloubu]

Upgraded this, but need to figure out why crons aren't triggering

---

Edit: figured out it was due to an internal failure 7a93ab3, which weren't getting displayed properly b77e718

[fubuloubu]

p.s. this website had some good test cases: https://crontab.guru/

[fubuloubu]

I should actually test this...

[mikeshultz]

I can't even approve this because it's technically mine. May as well just have created a replacement PR for this one.

[mikeshultz]

suggestion: make this debug. bit verbose and not really useful unless you're debugging.

[fubuloubu]

I was actually thinking this could be really useful to see for endusers, because they would have some live logging being created in scenarios where they are solely doing event log monitoring and nothing is really happening. Also very useful to know what the bot's local time is vs. the blockchain's, to see if there is some drift occuring.