/quantum-core

:watch: Cron-like job scheduler for Elixir

Primary LanguageElixirApache License 2.0Apache-2.0

Quantum

.github/workflows/branch_main.yml Coverage Status Module Version Hex Docs Total Download License Last Updated

This README follows main, which may not be the currently published version. Here are the docs for the latest published version of Quantum.

Cron-like job scheduler for Elixir.

Setup

To use Quantum in your project, edit the mix.exs file and add Quantum to

1. the list of dependencies:

defp deps do
  [
    {:quantum, "~> 3.0"}
  ]
end

2. and create a scheduler for your app:

defmodule Acme.Scheduler do
  use Quantum, otp_app: :your_app
end

3. and your application's supervision tree:

defmodule Acme.Application do
  use Application

  def start(_type, _args) do
    children = [
      # This is the new line
      Acme.Scheduler
    ]

    opts = [strategy: :one_for_one, name: Acme.Supervisor]
    Supervisor.start_link(children, opts)
  end
end

Troubleshooting

To see more transparently what quantum is doing, configure the logger to display :debug messages.

config :logger, level: :debug

If you want do use the logger in debug-level without the messages from quantum:

config :acme, Acme.Scheduler,
  debug_logging: false

If you encounter any problems with quantum, please search if there is already an open issue addressing the problem.

Otherwise feel free to open an issue. Please include debug logs.

Usage

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

config :acme, Acme.Scheduler,
  jobs: [
    # 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, []}}
  ]

More details on the usage can be found in the Documentation

Contribution

This project uses the Collective Code Construction Contract (C4) 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

Copyright and License

Copyright (c) 2015 Constantin Rack

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.