Project

sass_paths

0.0
No release in over 3 years
Low commit activity in last 3 years
This gem provides helper methods for appending directories, and gems to the SASS_PATH environment variable
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6
>= 0
>= 0

Runtime

~> 3.2
 Project Readme

SassPaths

This gem provides helper methods for appending directories and gems to the SASS_PATH environment variable. This enables you to load projects that do not themselves register with SASS.

Installation

Add this line to your application's Gemfile:

gem 'sass_paths'

And then execute:

$ bundle

Or install it yourself as:

$ gem install sass_paths

Usage

Directories

To append a directory, simply call append with your list of directories that you'd like appended.

SassPaths.append('/my/first/sass/path', '/my/second/sass/path', ...)

Gems

In order to append a gem, call append_gem_path with the name of the gem as well as the directory within the gem that contains the Sass files.

SassPaths.append_gem_path(gem_name, directory)

Temporary Replacements

Sometimes it can be fun to change the Sass paths for the duration of a block. For example, this would swap out using Neat versions.

replacements = {
  "/gems/neat-1.8.0/app/assets/stylesheets" => "/gems/neat-2.0.0/core"
}
SassPaths.with_replacements(replacements) do
  options = { load_paths: Sass.load_paths }
  Sass::Engine.new(template, options).render
end

The with_replacements takes no responsiblity for knowing about the paths passed in as being valid or not.

Rails

Create an initializer and utilize the above methods.

Not Rails

Use the above methods in some part of your application's boot process.

Testing

  • Run bundle install to install development dependencies.
  • Run rake test to run all tests.