Guard::Compass

Gem Version Build Status Dependency Status Code Climate Coverage Status

Guard::Compass allows to automatically run Compass whenever a stylesheet file is modified.

  • Tested against Ruby 1.8.7, 1.9.3, 2.0.0, JRuby (1.8 mode & 1.9 mode) & Rubinius (1.8 mode & 1.9 mode).

Install

Please be sure to have Guard installed before continue.

The simplest way to install Guard::Compass is to use Bundler.

Add Guard::Compass to your Gemfile:

group :development do
  gem 'guard-compass'
end

and install it by running Bundler:

$ bundle

Add guard definition to your Guardfile by running the following command:

guard init compass

Usage

Please read Guard usage doc

Configure Guard::Compass plug-in

The default configuration generated by 'guard init compass' looks like this

guard :compass

Options

List of available options

:project_path => '../foo/bar'                 # path to the compass project directory (from guard working directory)
:configuration_file => '../compass_config.rb' # path to your compass configuration file (from guard working directory)

By default, the project path is equal to the guard working directory (the folder from where you start Guard). Compass will look into some default location for the config file from there.

The configuration_file is computed by compass. You don't need to define watchers like in other Guard plug-in because they are generated from the Compass configuration files, cool!

For the complete list of options, please refer to the Compass documentation.

Development

Pull requests are very welcome! Please try to follow these simple rules if applicable:

  • Please create a topic branch for every separate change you make.
  • Make sure your patches are well tested. All specs run by Travis CI must pass.
  • Update the README.
  • Please do not change the version number.

For questions please join us in our Google group or on #guard (irc.freenode.net).

Maintainer

Rémy Coutable (@rymai, rymai.me)

Author

Olivier Amblet