sass_paths 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDdjODBmYmU2NGRmYjRmMDk5Mjc3ZWNjZTgxZWNmYzk5MzA5NDgwNg==
+  data.tar.gz: !binary |-
+    ZmUwYzEyY2M4Y2IzYmExMGFiNThmYzBhYmIzNThkNzA5YWViOTUzMA==
+SHA512:
+  metadata.gz: !binary |-
+    OWQwYTliMWMwY2U2NzZlNWUwNjBhN2VkNGJiMzZlMWE5YWMxOTg5ZWFlOWI1
+    YjRjNDZmMGUyMjNjYWM3NDRhYzIzNjJmNGE4YzQ0ZmU4NjgwZmJjOTk2MGFj
+    MzllZDYwYjA3NTZkYjY0YTQyMjk3ZjYzN2FmYmU4ZjA5ZjFiODg=
+  data.tar.gz: !binary |-
+    ZTY5OTc0NzIxZmQ2OWJmOGNlZTdhMWZhOGM2NTBmYzAxZWQ2YzQ4YmQ0MjM3
+    NGIxZjRhNzBiM2NmZTVkMGE0ZjNmNjIyNzMyZTI4NmI2MWNmNmE2Yjg5N2Fj
+    NTY3NzNiYTc3NDA1ZGU2YzQzYzE4N2E4ZjYwOTJkYWI4OTQzNGY=

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+test/bower_components

data/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+## Contributing
+
+1. Fork it ( https://github.com/customink/sass_paths/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in sass_paths.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Stafford Brunk
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,70 @@
+# SassPaths
+
+This gem provides helper methods for appending directories, gems, and bower
+extensions 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:
+
+
+```ruby
+gem 'sass_paths'
+```
+
+And then execute:
+
+```shell
+$ bundle
+```
+
+Or install it yourself as:
+
+```shell
+$ gem install sass_paths
+```
+
+## Usage
+
+#### Directories
+
+To append a directory, simply call `append` with your list of directories that
+you'd like appended.
+
+```ruby
+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.
+
+```ruby
+SassPaths.append_gem_path(gem_name, directory)
+```
+
+#### Bower Components
+
+In order to append the Sass files within a bower components directory, call
+`append_bower_components` with the name of the directory where the components
+are installed.
+
+```ruby
+SassPaths.append_bower_components('directory')
+```
+
+### 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 `bower install` from `test/` to install bower components for testing.
+* Run `rake test` to run all tests.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.pattern = "test/**/*_test.rb"
+end
+

data/lib/sass_paths.rb

@@ -0,0 +1,42 @@
+require "sass_paths/gem"
+require "sass_paths/bower"
+require "sass_paths/version"
+require 'sass'
+
+module SassPaths
+  class << self
+    include Gem
+    include Bower
+
+    def append(*paths)
+      existing_paths = paths.select { |path| Dir.exists? path }
+      new_paths = [env_path.split(File::PATH_SEPARATOR), existing_paths].flatten
+                                                                        .compact
+                                                                        .uniq
+      ENV["SASS_PATH"] = new_paths.join(File::PATH_SEPARATOR)
+    end
+
+    def append_gem_path(gem, path)
+      append(gem_sass_path(gem, path))
+    end
+
+    def append_bower_components(relative_bower_path)
+      sass_paths = get_bower_sass_paths(relative_bower_path)
+      append(*sass_paths)
+    end
+
+    def env_path
+      ENV["SASS_PATH"] || ""
+    end
+
+    def reload_paths!
+      append(*Sass.load_paths)
+      Sass.instance_variable_set('@load_paths', nil)
+      Sass.load_paths
+    end
+  end
+end
+
+if defined?(Rails)
+  require 'sass_paths/rails/engine'
+end

data/lib/sass_paths/bower.rb

@@ -0,0 +1,39 @@
+require 'json'
+
+module SassPaths
+  module Bower
+
+    private
+
+    PERMITTED_FILE_EXTENSIONS = ['.scss', '.sass'].freeze
+
+    def get_bower_sass_paths(bower_path)
+      sass_paths = []
+      Dir["#{bower_path}/**/.bower.json"].each do |f|
+        get_main_paths(f).each do |path|
+          sass_paths << path
+        end
+      end
+      sass_paths
+    end
+
+    def get_main_paths(file_name)
+      base_directory = File.dirname(file_name)
+      bower_json = JSON.parse(File.read(file_name))
+
+      main_files = wrap_in_array(bower_json['main'])
+        .select { |main_file| PERMITTED_FILE_EXTENSIONS.include? File.extname(main_file) }
+        .map { |main_file| "#{base_directory}/#{File.dirname(main_file)}" }
+    end
+
+    def wrap_in_array(object)
+      if object.nil?
+        []
+      elsif object.respond_to?(:to_ary)
+        object.to_ary || [object]
+      else
+        [object]
+      end
+    end
+  end
+end

data/lib/sass_paths/gem.rb

@@ -0,0 +1,14 @@
+module SassPaths
+  module Gem
+    private
+
+    def gem_sass_path(gem, directory)
+      require gem
+      File.join(gem_path(gem), directory)
+    end
+
+    def gem_path(gem)
+      ::Gem::Specification.find_all_by_name(gem).first.full_gem_path
+    end
+  end
+end

data/lib/sass_paths/rails/engine.rb

@@ -0,0 +1,7 @@
+module SassPaths
+  class Engine < ::Rails::Engine
+    config.after_initialize do
+      ::SassPaths.reload_paths!
+    end
+  end
+end

data/lib/sass_paths/version.rb

@@ -0,0 +1,3 @@
+module SassPaths
+  VERSION = "1.0.0"
+end

data/sass_paths.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sass_paths/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "sass_paths"
+  spec.version       = SassPaths::VERSION
+  spec.authors       = ["Stafford Brunk", "Jonathan Lehman"]
+  spec.email         = ["sbrunk@customink.com", "jlehman@customink.com"]
+  spec.summary       = %q{Helper methods to append directories to the SASS_PATH ENV variable}
+  spec.description   = %q{This gem provides helper methods for appending directories, gems, and bower extensions to the SASS_PATH environment variable}
+  spec.homepage      = "https://github.com/customink/sass_paths"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "susy"
+
+  spec.add_dependency "sass"
+end

data/test/.bowerrc

@@ -0,0 +1,3 @@
+{
+  "directory": "bower_components"
+}

data/test/bower.json

@@ -0,0 +1,22 @@
+{
+  "name": "sass_paths",
+  "version": "0.0.0",
+  "homepage": "https://github.com/customink/sass-paths",
+  "authors": [
+    "Jonathan Lehman <jonathan.lehman91@gmail.com>"
+  ],
+  "license": "MIT",
+  "ignore": [
+    "**/.*",
+    "node_modules",
+    "bower_components",
+    "app/bower_components",
+    "test",
+    "tests"
+  ],
+  "devDependencies": {
+    "susy": "~2.1.3",
+    "sassy-maps": "~0.4.0",
+    "jquery": "~2.1.1"
+  }
+}

data/test/sass_paths/sass_paths_test.rb

@@ -0,0 +1,66 @@
+require 'test_helper'
+
+module SassPaths
+  describe '#append' do
+    it 'appends path to SASS_PATH ENV with existing paths' do
+      ENV['SASS_PATH'] = 'lib:lib/sass_paths'
+      SassPaths.append('lib/sass_paths/rails')
+      assert_equal 'lib:lib/sass_paths:lib/sass_paths/rails', ENV['SASS_PATH']
+    end
+
+    it 'appends without duplicates' do
+      ENV['SASS_PATH'] = 'lib:lib/sass_paths'
+      SassPaths.append('lib/sass_paths')
+      assert_equal 'lib:lib/sass_paths', ENV['SASS_PATH']
+    end
+
+    it 'appends to empty SASS_PATH ENV' do
+      ENV['SASS_PATH'] = ''
+      SassPaths.append('lib/sass_paths')
+      assert_equal 'lib/sass_paths', ENV['SASS_PATH']
+    end
+
+    it "won't append a path that does not exist" do
+      ENV['SASS_PATH'] = ''
+      SassPaths.append('this/is/not/a/real/path12321')
+      assert_equal '', ENV['SASS_PATH']
+    end
+  end
+
+  describe '#append_gem_path' do
+    it 'appends gem path to SASS_PATH ENV' do
+      ENV['SASS_PATH'] = 'lib/sass_paths:lib'
+      SassPaths.append_gem_path('susy', 'sass')
+      assert ENV['SASS_PATH'].include? 'lib/sass_paths:lib'
+      assert ENV['SASS_PATH'].match /gems\/susy-[\d\.]+\/sass/
+    end
+  end
+
+  describe '#append_bower_components' do
+    it 'appends bower paths to SASS_PATH ENV' do
+      ENV['SASS_PATH'] = 'lib/sass_paths:lib'
+      SassPaths.append_bower_components('.')
+      assert ENV['SASS_PATH'].include? 'lib/sass_paths:lib'
+      assert ENV['SASS_PATH'].match /bower_components\/susy\/sass/
+      assert ENV['SASS_PATH'].match /bower_components\/sassy-maps\/sass/
+      refute ENV['SASS_PATH'].match /bower_components\/jquery/
+    end
+  end
+
+  describe '#env_path' do
+    it 'returns SASS_PATH ENV' do
+      ENV['SASS_PATH'] = 'lib/sass_paths'
+      assert_equal 'lib/sass_paths', SassPaths.env_path
+    end
+  end
+
+  describe '#reload_paths!' do
+    it 'reloads the SASS_PATH' do
+      ENV['SASS_PATH'] = 'lib:lib/sass_paths'
+      SassPaths.reload_paths!
+      assert_equal ['lib', 'lib/sass_paths'], Sass.load_paths
+      assert_equal 'lib:lib/sass_paths', ENV['SASS_PATH']
+    end
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'bundler'
+require 'minitest/autorun'
+require 'sass_paths'

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: sass_paths
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Stafford Brunk
+- Jonathan Lehman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: susy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem provides helper methods for appending directories, gems, and
+  bower extensions to the SASS_PATH environment variable
+email:
+- sbrunk@customink.com
+- jlehman@customink.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/sass_paths.rb
+- lib/sass_paths/bower.rb
+- lib/sass_paths/gem.rb
+- lib/sass_paths/rails/engine.rb
+- lib/sass_paths/version.rb
+- sass_paths.gemspec
+- test/.bowerrc
+- test/bower.json
+- test/sass_paths/sass_paths_test.rb
+- test/test_helper.rb
+homepage: https://github.com/customink/sass_paths
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.1
+signing_key: 
+specification_version: 4
+summary: Helper methods to append directories to the SASS_PATH ENV variable
+test_files:
+- test/.bowerrc
+- test/bower.json
+- test/sass_paths/sass_paths_test.rb
+- test/test_helper.rb