Marmot is a scheduler, use it to schedule tasks.
The most detailled documentation is the api doc.
-
Add the dependency to your
shard.yml:dependencies: marmot: github: erdnaxeli/marmot
-
Run
shards install
require "marmot"
# This task will repeat every 15 minutes.
repeat_task = Marmot.every(15.minutes) { puts Time.local }
# This task will run every day at 15:28:43, and will cancel the previous task.
Marmot.every(:day, hour: 15, minute: 28, second: 43) do
puts "It is 15:28:43: #{Time.local}"
repeat_task.cancel
end
times = 0
channel = Channel(String).new
# This task will run every 10 seconds and will cancel itself after 10 runs.
Marmot.every(10.seconds) do |task|
times += 1
channel.send("#{times} times")
if times == 10
task.cancel
channel.close
end
end
Marmot.on(channel) do |task|
if value = task.as(Marmot::OnChannelTask).value
puts value
else
puts "The task was canceled"
end
end
# Start the scheduler.
Marmot.runYou can set the env var MARMOT_DEBUG to any value to make marmot outputs debug logs.
Don't forget to run the test.
As they deal with timing, they could fail if your computer is busy. Do not hesitate to run then many times if that happens.
- Fork it (https://github.com/erdnaxeli/marmot/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
- erdnaxeli - creator and maintainer