Project

scheduled

0.0
Low commit activity in last 3 years
A long-lived project that still receives updates
A very lightweight clock process with minimal dependencies and no magic.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Scheduled

A simple task scheduler, akin to ClockWork or Rufus Scheduler.

Project Goals

  • Absolutely no dependency on ActiveSupport
  • Very small dependency tree
  • Framework agnostic
  • No built-in daemonization
  • No scheduling DSL

Installation

Add this line to your application's Gemfile:

gem "scheduled"

And then execute:

$ bundle

Or install it yourself as:

$ gem install scheduled

Usage

Defining tasks

Tasks are defined by calling Scheduled.every with an interval and a block to execute. The interval can be a basic Integer to represent seconds, or a callable object that receives the current Job.

If the callable object returns a truthy value, the block is executed.

require "scheduled"

# Called every 60 seconds
Scheduled.every(60) { do_work } # Perform some job

# Using a cronline
Scheduled.every("* * * * *") { do_work }

two_hours_from_last_run = ->(job) do
  Time.now - job.last_run >= 60*60*2
end
Scheduled.every(two_hours_from_last_run) { puts "Updating" }

# Run the scheduler
Scheduled.wait

Running the scheduler

Provided your schedule file ends with a call to Scheduled.wait, just run it as any other Ruby script.

ruby schedule.rb

Quick Returning Tasks

Scheduled works best if you schedule the tasks into a long-running queue, such as Backburner or Sidekiq.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/adam12/scheduled.

I love pull requests! If you fork this project and modify it, please ping me to see if your changes can be incorporated back into this project.

That said, if your feature idea is nontrivial, you should probably open an issue to discuss it before attempting a pull request.

License

The gem is available as open source under the terms of the MIT License.