Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Automatic Library Reloading
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
spec Split specs into two files. [test]
try Fix tryme example. [doc]
work Rewrote API to utilize .
.gitignore Move pages to web. [admin]
.index :admin: Prep for release.
.travis.yml :admin: Last try to get Rubinius working.
.yardopts Format API docs with Tomdoc. [doc]
Assembly Move pages to web. [admin]
Gemfile :admin: Try to get Rubinius testing. :admin: Prep for release.
Indexfile :admin: Prep for release. Hope Eto is okay with simplifying to just BSD-2-Clause license. [admin]
Manifest.txt Update manifest. [admin] Hope Eto is okay with simplifying to just BSD-2-Clause license. [admin]
Rakefile Use Travis CI. [admin]
autoreload.gemspec Just house cleaning. [admin]


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.


The current version of Autoreload is a derviative of Kouichirou Eto's original work which can still be found at

License & Copyrights

Autoreload is released as free software under the BSD-2-Clause license.

  • Copyright 2010 Rubyworks
  • Copyright 2003 Kouichirou Eto

See for details.

Something went wrong with that request. Please try again.