Quantum

Cron-like job scheduler for Elixir.

Hex.pm Version Hex docs Build Status Coverage Status License Inline docs

Setup

To use Quantum in your projects, edit your mix.exs file and add Quantum as a dependency:

defp deps do
  [{:quantum, ">= 1.4.0"}]
end

Then, add Quantum to the list of applications in your mix.exs file:

def application do
  [applications: [:quantum]]
end

Usage

Configure your cronjobs in your config/config.exs like this:

config :quantum, cron: [
    # Every minute
    "* * * * *":      {"Heartbeat", :send},
    # Every 15 minutes
    "*/15 * * * *":   fn -> System.cmd("rm", ["/tmp/tmp_"] end,
    # Runs on 18, 20, 22, 0, 2, 4, 6:
    "0 18-6/2 * * *": fn -> :mnesia.backup('/var/backup/mnesia') end,
    # Runs every midnight:
    "@daily":         &Backup.backup/0
]

or like this:

config :quantum, cron: [
    # Every minute
    "* * * * *": {MyApp.MyModule, :my_method}
]

or you can provide module as a string:

config :quantum, cron: [
    # Every minute
    "* * * * *": {"MyApp.MyModule", :my_method}
]

Or even use cron-like format (useful with conform / exrm / edeliver):

config :quantum, cron: [
    # Every minute
    "* * * * * MyApp.MyModule.my_method"
]

If you want to add jobs on runtime, this is possible, too:

Quantum.add_job("1 * * * *", fn -> :ok end)

Timezone

Please note that Quantum uses UTC timezone and not local timezone by default.

To use local timezone, add the following timezone option to your configuration:

config :quantum,
  cron: [
    # Your cronjobs
  ],
  timezone: :local

Crontab format

FieldAllowed values
—————————————
minute0-59
hour0-23
day of month1-31
month1-12 (or names)
day of week0-6 (0 is Sunday, or use names)

Names can also be used for the month and day of week fields. Use the first three letters of the particular day or month (case does not matter).

Special expressions

Instead of the first five fields, one of these special strings may be used:

StringDescription
—————-—————-
@annuallyRun once a year, same as "0 0 1 1 *" or @yearly
@dailyRun once a day, same as "0 0 * * *" or @midnight
@hourlyRun once an hour, same as "0 * * * *"
@midnightRun once a day, same as "0 0 * * *" or @daily
@monthlyRun once a month, same as "0 0 1 * *"
@rebootRun once, at startup
@weeklyRun once a week, same as "0 0 * * 0"
@yearlyRun once a year, same as "0 0 1 1 *" or @annually

Contribution

This project uses the C4.1 process for all code changes.

“Everyone, without distinction or discrimination, SHALL have an equal right to become a Contributor under the terms of this contract.”

tl;dr

  1. Check for open issues or open a new issue to start a discussion around a problem.
  2. Issues SHALL be named as “Problem: description of the problem“.
  3. Fork the quantum-elixir repository on Github to start making your changes
  4. If possible, write a test which shows that the problem was solved.
  5. Send a pull request.
  6. Pull requests SHALL be named as “Solution: description of your solution
  7. Your pull request is merged and you are added to the list of contributors

License

Apache License, Version 2.0