compass-rails 1.0.0.rc.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+rails-temp/*

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+script: "bundle exec rake appraisal:install test"

data/Appraisals

@@ -0,0 +1,17 @@
+appraise "rails2" do
+  gem "rails", "2.3.14"
+end
+
+appraise "rails3" do
+  gem "rails", "3.0.11"
+end
+
+appraise "rails31" do
+  gem "rails", "3.1.3"
+  gem "sass-rails"
+end
+
+appraise "rails32" do
+  gem "rails", "~> 3.2"
+  gem "sass-rails"
+end

data/Gemfile

@@ -0,0 +1,22 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in compass-rails.gemspec
+gemspec
+
+group :assets do
+  gem 'compass', :git => 'git://github.com/chriseppstein/compass.git', :branch => :master
+  gem 'compass-rails', :path => '.'
+end
+
+group :test do
+  gem 'mocha'
+  gem "appraisal", :git => 'git://github.com/scottdavis/appraisal.git'
+  gem 'rainbow'
+end
+
+unless ENV["CI"]
+  gem 'rb-fsevent', :require => false
+  gem 'ruby_gntp', :require => false
+  gem 'guard'
+  gem 'guard-test'
+end

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :test, :cli => '-v v' do
+  watch(%r{^lib/(.+)\.rb$})     { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^test/.+_test\.rb$})
+  watch('test/test_helper.rb')  { "test" }
+
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011 Scott Davis
+
+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,191 @@
+# CompassRails
+
+Compass rails is an adapter for the [Compass Stylesheet Authoring
+Framework](http://compass-style.org) for [Ruby on Rails](http://http://rubyonrails.org/).
+
+Since Compass v0.12, this adapter is the only way to install compass
+into your rails application.
+
+This adapter supports rails versions 2.3 and greater. Rails 2.3 and 3.0 users
+please read the caviats below.
+
+## Installation
+
+Add the `compass-rails` gem line to a group called `:assets` in your application's Gemfile (Rails 3.1+ users should already have the `:assets` group):
+
+```ruby
+group :assets do
+  gem 'compass-rails'
+end
+```
+
+If you are using any Compass extensions, add them to this group in your
+Gemfile.
+
+And then execute:
+
+    $ bundle
+
+To set up your project with starter stylesheets and a configuration
+file:
+
+    $ bundle exec compass init
+
+If using a compass-based framework (like [susy](http://susy.oddbird.net/) or [blueprint](http://compass-style.org/reference/blueprint/)) then you can use the `--using` option to set thi:
+
+    $ bundle exec compass init --using blueprint
+
+Note that the `compass init` step is optional if you have a project running Rails 3.0 or greater.
+
+## Upgrading existing rails projects using Compass to CompassRails
+
+First and foremost, follow the installation instructions above.
+
+CompassRails uses the rails convention for stylesheet locations even in
+older versions of rails that do not use the assets pipeline.
+If you have your stylesheets already in `app/stylesheets`, you have two choices:
+
+1. Move your stylesheets to `app/assets/stylesheets`.
+2. Configure your project to look in `app/assets/stylesheets` by setting
+   `config.compass.sass_dir = "app/stylesheets"` in your rails
+configuration or by setting `sass_dir = "app/stylesheets"` in your
+compass configuration file.
+
+## Configuration
+
+If you have a compass configuration file (recommended) then you can
+use the [Compass configuration 
+reference](http://compass-style.org/help/tutorials/configuration-reference/)
+as is. If you choose to configure compass from your rails configuration
+files, then you should understand that the compass configuration
+options explained there will be methods and properties on the `config.compass`
+configuration object exposed to rails within any configuration block.
+
+## Usage
+
+### Developing with Rails-based Compilation
+
+By default, your sass files in `app/assets/stylesheets` will be
+automatically compiled by the the [`Sass::Plugin`](http://sass-lang.com/docs/yardoc/Sass/Plugin.html) or the [Rails asset
+pipeline](http://guides.rubyonrails.org/asset_pipeline.html) depending on the version of rails that you use.
+
+When using this approach you will need to reload your webpage in order
+to trigger a recompile of your stylesheets.
+
+### Developing with the Compass watcher
+
+When using the Compass watcher to update your stylesheets, your
+stylesheets are recompiled as soon as you save your Sass files. In this
+mode, compiled stylesheets will be written to your project's public
+folder and therefore will be served directly by your project's web
+server -- superceding the normal rails compilation.
+
+In this mode, rails 3.0 or earlier users will experience a slight
+speed up by disabling the `Sass::Plugin` like so:
+
+```ruby
+config.after_initialize do
+  Sass::Plugin.options[:never_update] = true
+end
+```
+
+To return to using the Rails-based compilation mode, simply delete
+the compiled stylesheets and remove any configuration changes.
+
+### Compiling for Production
+
+If using the Rails asset pipeline run:
+
+    $ rake assets:precompile
+
+If not using the asset pipeline run:
+
+    $ bundle exec compass compile -e production --force
+
+It is suggested that you compile your stylesheets as part of the deploy
+or build process. However, some people choose to check in their compiled
+stylesheets.
+
+### Installing Compass extensions
+
+Step 1: If the extension is a rubygem, Add it to your Gemfile in the
+`:assets` group and run the `bundle` command to install it.
+If the extension is a zip file, unzip it into the
+`vendor/plugins/compass_extensions` directory of your project.
+
+Step 2: Install the extension's assets: `bundle exec compass install 
+<extension/template>`
+
+For example, if you want to use susy.
+
+```ruby
+# Gemfile
+group :assets do
+  gem 'compass-rails'
+  gem 'compass-susy-plugin'
+end
+```
+
+then run:
+
+    $ bundle
+    $ bundle exec compass install susy
+
+### Notes On Sprockets Directives
+
+Sprockets, used by the rails asset pipeline, provides directives for
+doing things like requiring. These **must not** be used with Sass files.
+Instead use the sass `@import` directive. In rails projects, the
+`@import` directive is configured to work with sprockets via `sass-rails`. For more information on importing in rails 3.1 or greater see the [Sass-Rails REAME](https://github.com/rails/sass-rails/blob/master/README.markdown)
+
+## Rails 3.0 Caviats
+
+If you want rails to compile your stylesheets (instead of using the
+compass watcher) you need to edit `config/application.rb` and change:
+
+```ruby
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+```
+
+to this:
+
+```ruby
+Bundler.require(:default, :assets, Rails.env) if defined?(Bundler)
+```
+
+## Rails 2.3 Caviats
+
+Compass requires that your rails 2.3 project is using Bundler to manage
+your rubygems. If you haven't yet set up your rails 2.3 project to use Bundler,
+please do so prior to upgrading. [Bundler installation guide for rails
+2.3](http://gembundler.com/rails23.html).
+
+After following the instructions there, if you want rails to compile
+your stylesheets (instead of using the compass watcher) you need
+edit `config/boot.rb` and change this:
+
+```ruby
+Rails::Initializer.class_eval do
+  def load_gems
+    @bundler_loaded ||= Bundler.require :default, Rails.env
+  end
+end
+```
+
+To this:
+
+```ruby
+Rails::Initializer.class_eval do
+  def load_gems
+    @bundler_loaded ||= Bundler.require :default, :assets, Rails.env
+  end
+end
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,34 @@
+#!/usr/bin/env rake
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+require 'rake/dsl_definition' rescue nil
+
+require "bundler/gem_tasks"
+require 'appraisal'
+require 'compass'
+
+# ----- Default: Testing ------
+
+task :default => [:test, :features]
+
+require 'rake/testtask'
+require 'fileutils'
+
+Rake::TestTask.new :test do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  test_files = FileList['test/**/*_test.rb']
+  test_files.exclude('test/rails/*', 'test/haml/*')
+  t.test_files = test_files
+  t.verbose = true
+end
+
+Rake::TestTask.new :units do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  test_files = FileList['test/units/**/*_test.rb']
+  test_files.exclude('test/rails/*', 'test/haml/*')
+  t.test_files = test_files
+  t.verbose = true
+end

data/compass-rails.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/compass-rails/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Scott Davis", "Chris Eppstein"]
+  gem.email         = ["jetviper21@gmail.com", "chris@eppsteins.net"]
+  gem.description   = %q{Integrate Compass into Rails 2.3 and up.}
+  gem.summary       = %q{Integrate Compass into Rails 2.3 and up.}
+  gem.homepage      = "https://github.com/Compass/compass-rails"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "compass-rails"
+  gem.require_paths = ["lib"]
+  gem.version       = CompassRails::VERSION
+
+  gem.add_dependency 'rails'
+  gem.add_dependency 'compass', '~> 0.12.rc.0'
+
+end

data/gemfiles/rails2.gemfile

@@ -0,0 +1,21 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rb-fsevent", :require=>false
+gem "ruby_gntp", :require=>false
+gem "guard"
+gem "guard-test"
+gem "rails", "2.3.14"
+
+group :assets do
+  gem "compass", :git=>"git://github.com/chriseppstein/compass.git", :branch=>:master
+  gem "compass-rails", :path=>".."
+end
+group :test do
+  gem "mocha"
+  gem "appraisal", :git=>"git://github.com/scottdavis/appraisal.git"
+  gem "rainbow"
+end
+
+gemspec :path=>"../"

data/gemfiles/rails2.gemfile.lock

@@ -0,0 +1,87 @@
+GIT
+  remote: git://github.com/chriseppstein/compass.git
+  revision: addbc94716e95a7e6f200baa980b48c7e7a1a568
+  branch: master
+  specs:
+    compass (0.12.rc.4.addbc94)
+      chunky_png (~> 1.2)
+      fssm (>= 0.2.7)
+      sass (~> 3.1)
+
+GIT
+  remote: git://github.com/scottdavis/appraisal.git
+  revision: b39ce49f69e330ccd5a1cb48e690f00e800a45d3
+  specs:
+    appraisal (0.4.0)
+      bundler
+      rake
+
+PATH
+  remote: ..
+  specs:
+    compass-rails (1.0.0.rc.0)
+      compass (~> 0.12.rc.0)
+      rails
+
+PATH
+  remote: ..
+  specs:
+    compass-rails (1.0.0.rc.0)
+      compass (~> 0.12.rc.0)
+      rails
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (2.3.14)
+      actionpack (= 2.3.14)
+    actionpack (2.3.14)
+      activesupport (= 2.3.14)
+      rack (~> 1.1.0)
+    activerecord (2.3.14)
+      activesupport (= 2.3.14)
+    activeresource (2.3.14)
+      activesupport (= 2.3.14)
+    activesupport (2.3.14)
+    chunky_png (1.2.5)
+    ffi (1.0.11)
+    fssm (0.2.8.1)
+    guard (1.0.0)
+      ffi (>= 0.5.0)
+      thor (~> 0.14.6)
+    guard-test (0.4.3)
+      guard (>= 0.4)
+      test-unit (~> 2.2)
+    metaclass (0.0.1)
+    mocha (0.10.3)
+      metaclass (~> 0.0.1)
+    rack (1.1.3)
+    rails (2.3.14)
+      actionmailer (= 2.3.14)
+      actionpack (= 2.3.14)
+      activerecord (= 2.3.14)
+      activeresource (= 2.3.14)
+      activesupport (= 2.3.14)
+      rake (>= 0.8.3)
+    rainbow (1.1.3)
+    rake (0.9.2.2)
+    rb-fsevent (0.9.0)
+    ruby_gntp (0.3.4)
+    sass (3.1.12)
+    test-unit (2.4.5)
+    thor (0.14.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal!
+  compass!
+  compass-rails!
+  guard
+  guard-test
+  mocha
+  rails (= 2.3.14)
+  rainbow
+  rb-fsevent
+  ruby_gntp