Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
63 lines (39 sloc) 1.53 KB


Homepage | Development | Mailing List

Build Status


Autoreload automatically reloads library files after they have been updated. It is especially useful when testing stateless services such as web applications.

IMPORTANT! Version 1.0+ has a new API. It also works best under Ruby 1.9 or above. Under Ruby 1.8 or older files are reloaded regardless of whether they actually have changed since the last load. Whereas in Ruby 1.9+, they only reload if the mtime on the file is newer than the previous time.


Say we have a library foo.rb in our load path:

def foo

We can then run the following script, example.rb:

require 'autoreload'

autoreload(:interval=>2, :verbose=>true) do
  require 'foo.rb'

loop {
  puts foo
  sleep 2

While that's running we can change foo.rb and the change will take effect in example.rb within two seconds of being made.

Note that autoreload only works with required files. It cannot monitor files that are brought in with #load. This is because $LOADED_FEATURES is used to track which files are monitored.


FreeBSD License

  • Copyright (c) 2003,2007 Kouichirou Eto
  • Copyright (c) 2010 Thomas Sawyer

See COPYING.rdoc for more information.

Jump to Line
Something went wrong with that request. Please try again.