aleksi-hassle 0.1.0

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2009, Pedro Belo, Nick Quaranto
+
+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.textile

@@ -0,0 +1,117 @@
+h1. Hassle
+
+Making "SASS":http://sass-lang.com/ less of a hassle on read only filesystems. (like "Heroku":http://heroku.com)
+
+h2. WARNING
+
+This plugin doesn't supports Rails 3 yet.
+
+h2. Install
+
+Get it from "Gemcutter.":http://gemcutter.org
+
+<pre>
+gem install hassle -s http://gemcutter.org
+</pre>
+
+h2. Usage
+
+By default, SASS compiles CSS into the @public/@ directory. On platforms like Heroku, "this won't work.":http://docs.heroku.com/constraints#read-only-filesystem Instead, Hassle compiles the SASS for you into @tmp/@ and serves it up via a @Rack::Static@ middleware.
+
+Hassle assumes a few basic things about your setup: There's going to be a @tmp/@ directory where it can write to, and @public/@ is where you store your css. A simple example:
+
+<pre>
+$ tree
+.
+|-- config.ru
+|-- public
+|   `-- stylesheets
+|       `-- sass
+|           `-- application.sass
+`-- tmp
+    `-- hassle
+        `-- stylesheets
+            `-- application.css
+</pre>
+
+With a basic SASS file in @public/stylesheets/sass/application.sass@, you can include it in your views with:
+
+<pre>
+<link href="/stylesheets/application.css" media="screen" rel="stylesheet" type="text/css" />
+</pre>
+
+Hassle will look at the default sass directory (@public/stylesheets/sass@) and other input directories given in @Sass::Plugin.options[:template_location]@. CSS files are then compiled into @tmp/@ one directory higher than where you specified. Here's a small example of customization:
+
+<pre>
+Sass::Plugin.options[:template_location] = "./public/css/templates"
+</pre>
+
+And after Hassle runs...
+
+<pre>
+$ tree
+.
+|-- config.ru
+|-- public
+|   `-- css
+|       `-- templates
+|           `-- screen.sass
+`-- tmp
+    `-- hassle
+        `-- css
+            `-- screen.css
+</pre>
+
+Include this in your views with:
+
+<pre>
+<link href="/css/screen.css" media="screen" rel="stylesheet" type="text/css" />
+</pre>
+
+h2. Integration
+
+Here's how to integrate it with your favorite web framework:
+
+h3. Rails
+
+For Rails: @script/plugin install git://github.com/pedro/hassle@. Done. Once you're in production mode, Hassle will kick in and prepare your SASS for all to enjoy.
+
+h3. Sinatra
+
+Here's a sample config.ru that's "up and running.":http://hassle-sinatra.heroku.com
+
+<pre>
+require 'sinatra'
+require 'hassle'
+require 'haml'
+
+get '/' do
+  haml <<EOF
+%html
+  %head
+    %link{:rel => 'stylesheet', :href => "stylesheets/application.css"}
+  %body
+    %h1 Hassle!
+EOF
+end
+
+use Hassle
+run Sinatra::Application
+</pre>
+
+And its wonderful SASS file:
+
+<pre>
+$ cat public/stylesheets/sass/application.sass 
+h1
+  font-size: 11em
+  color: purple
+</pre>
+
+h2. Bugs
+
+Found some problems? Post 'em in "Issues":http://github.com/pedro/hassle/issues.
+
+h2. License
+
+Hassle uses the MIT license. Please check the LICENSE file for more details.

data/init.rb

@@ -0,0 +1,3 @@
+if RAILS_ENV == 'production'
+	ActionController::Dispatcher.middleware.use Hassle
+end

data/lib/hassle.rb

@@ -0,0 +1,68 @@
+require 'rack'
+require 'sass'
+require 'sass/plugin'
+
+class Hassle
+  def initialize(app)
+    compiler = Hassle::Compiler.new
+    compiler.compile
+    @static = Rack::Static.new(app,
+                               :urls => compiler.stylesheets,
+                               :root => compiler.compile_location)
+  end
+
+  def call(env)
+    @static.call(env)
+  end
+end
+
+class Hassle::Compiler
+  def options
+    Sass::Plugin.options
+  end
+
+  def css_location(path)
+    expanded = File.expand_path(path)
+    public_dir = File.join(File.expand_path(Dir.pwd), "public")
+
+    File.expand_path(compile_location(expanded.gsub(public_dir, ''), '..'))
+  end
+
+  def compile_location(*subdirs)
+    File.join(Dir.pwd, "tmp", "hassle", subdirs)
+  end
+
+  def normalize
+    template_location = options[:template_location]
+
+    if template_location.is_a?(Hash) || template_location.is_a?(Array)
+      options[:template_location] = template_location.to_a.map do |input, output|
+        [input, css_location(input)]
+      end
+    else
+      default_location = File.join(options[:css_location], "sass")
+      options[:template_location] = {default_location => css_location(default_location)}
+    end
+  end
+
+  def prepare
+    options.merge!(:cache        => false,
+                   :never_update => false)
+
+    options[:template_location].to_a.each do |location|
+      FileUtils.mkdir_p(location.last)
+    end
+  end
+
+  def stylesheets
+    options[:template_location].to_a.map do |location|
+      Dir[File.join(location.last, "**", "*.css")].map { |css| css.gsub(compile_location, "/") }
+    end.flatten.sort
+  end
+
+  def compile
+    normalize
+    prepare
+    Sass::Plugin.update_stylesheets
+  end
+end

data/spec/base.rb

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'spec'
+require 'rack/test'
+
+require File.dirname(__FILE__) + '/../lib/hassle'
+
+SASS_OPTIONS = Sass::Plugin.options.dup
+
+SASS_DATA = %[
+$blue: #3bbfce
+.col
+  color: $blue
+]
+
+SCSS_DATA = %[
+$blue: #3bbfce;
+.col {
+  color: $blue;
+}
+]
+
+def write_data(location, css_file, format)
+  FileUtils.mkdir_p(location)
+  sass_path = File.join(location, "#{css_file}.#{format}")
+  File.open(sass_path, "w") do |f|
+    f.write(format == :sass ? SASS_DATA : SCSS_DATA)
+  end
+
+  File.join(@hassle.css_location(location), "#{css_file}.css") if @hassle
+end
+
+def write_sass(location, css_file = "screen")
+  write_data(location, css_file, :sass)
+end
+
+def write_scss(location, css_file = "screen")
+  write_data(location, css_file, :scss)
+end
+
+def be_compiled
+  simple_matcher("exist") { |given| File.exists?(given) }
+  simple_matcher("contain compiled sass") { |given| File.read(given) == ".col {\n  color: #3bbfce; }\n" }
+end
+
+def have_tmp_dir_removed(*stylesheets)
+  simple_matcher("remove tmp dir") do |given|
+    given == stylesheets.map { |css| css.gsub(File.join(Dir.pwd, "tmp", "hassle"), "") }
+  end
+end
+
+def have_served_sass
+  simple_matcher("return success") { |given| given.status == 200 }
+  simple_matcher("compiled sass") { |given| given.body.should == ".col {\n  color: #3bbfce; }\n" }
+end
+
+def reset
+  Sass::Plugin.options.clear
+  Sass::Plugin.options = SASS_OPTIONS
+  FileUtils.rm_rf([File.join(Dir.pwd, "public"), File.join(Dir.pwd, "tmp")])
+end

data/spec/hassle_compiler_spec.rb

@@ -0,0 +1,104 @@
+require File.join(File.dirname(__FILE__), "base")
+
+describe Hassle::Compiler do
+  before do
+    reset
+    @hassle = Hassle::Compiler.new
+  end
+
+  it "dumps css into separate folders" do
+    @hassle.css_location("./public/stylesheets/sass").should ==
+      File.join(Dir.pwd, "tmp", "hassle", "stylesheets")
+
+    @hassle.css_location("./public/css/compiled").should ==
+      File.join(Dir.pwd, "tmp", "hassle", "css")
+
+    @hassle.css_location("./public/styles/posts/sass").should ==
+      File.join(Dir.pwd, "tmp", "hassle", "styles", "posts")
+  end
+
+  describe "compiling sass" do
+    before do
+      @default_location = Sass::Plugin.options[:css_location]
+    end
+
+    it "moves css into tmp directory with default settings" do
+      sass = write_sass(File.join(@default_location, "sass"))
+
+      @hassle.compile
+
+      sass.should be_compiled
+      @hassle.stylesheets.should have_tmp_dir_removed(sass)
+    end
+
+    it "should not create sass cache" do
+      write_sass(File.join(@default_location, "sass"))
+      Sass::Plugin.options[:cache] = true
+
+      @hassle.compile
+
+      File.exists?(".sass-cache").should be_false
+    end
+
+    it "should compile sass even if disabled with never_update" do
+      sass = write_sass(File.join(@default_location, "sass"))
+      Sass::Plugin.options[:never_update] = true
+
+      @hassle.compile
+
+      sass.should be_compiled
+    end
+
+    it "should compile sass if template location is a hash" do
+      new_location = "public/css/sass"
+      Sass::Plugin.options[:template_location] = {new_location => "public/css"}
+      sass = write_sass(new_location)
+
+      @hassle.compile
+
+      sass.should be_compiled
+    end
+
+    it "should compile sass if template location is a hash with multiple locations" do
+      location_one = "public/css/sass"
+      location_two = "public/stylesheets/sass"
+      Sass::Plugin.options[:template_location] = {location_one => "public/css", location_two => "public/css"}
+      sass_one = write_sass(location_one, "one")
+      sass_two = write_sass(location_two, "two")
+
+      @hassle.compile
+
+      sass_one.should be_compiled
+      sass_two.should be_compiled
+      @hassle.stylesheets.should have_tmp_dir_removed(sass_one, sass_two)
+    end
+
+    it "should compile sass if template location is an array with multiple locations" do
+      location_one = "public/css/sass"
+      location_two = "public/stylesheets/sass"
+      Sass::Plugin.options[:template_location] = [[location_one, "public/css"], [location_two, "public/css"]]
+      sass_one = write_sass(location_one, "one")
+      sass_two = write_sass(location_two, "two")
+
+      @hassle.compile
+
+      sass_one.should be_compiled
+      sass_two.should be_compiled
+      @hassle.stylesheets.should have_tmp_dir_removed(sass_one, sass_two)
+    end
+
+    it "should not overwrite similarly name files in different directories" do
+      location_one = "public/css/sass"
+      location_two = "public/stylesheets/sass"
+      Sass::Plugin.options[:template_location] = {location_one => "public/css", location_two => "public/css"}
+      sass_one = write_sass(location_one, "screen")
+      sass_two = write_sass(location_two, "screen")
+
+      @hassle.compile
+
+      sass_one.should be_compiled
+      sass_two.should be_compiled
+      @hassle.stylesheets.should have_tmp_dir_removed(sass_one, sass_two)
+    end
+  end
+end

data/spec/hassle_spec.rb

@@ -0,0 +1,65 @@
+require File.dirname(__FILE__) + '/base'
+
+describe Hassle do
+  include Rack::Test::Methods
+
+  def app
+    Rack::Builder.new do
+      use Hassle
+      run Proc.new {|env| [200, {"Content-Type" => "text/html"}, "hello!"]}
+    end
+  end
+
+  before do
+    reset
+  end
+
+  it "sends through basic responses" do
+    get '/'
+    last_response.status.should == 200
+    last_response.body.should =~ /hello!/
+  end
+
+  describe "a basic setup" do
+    before do
+      write_sass("./public/stylesheets/sass")
+    end
+
+    it "serves up some sass" do
+      get '/stylesheets/screen.css'
+      last_response.should have_served_sass
+    end
+  end
+
+  describe "a basic setup with SCSS" do
+    before do
+      write_scss("./public/stylesheets/sass")
+    end
+
+    it "serves up some sass" do
+      get '/stylesheets/screen.css'
+      last_response.should have_served_sass
+    end
+  end
+
+  describe "a slightly more complex setup" do
+    before do
+      @location_one = "./public/css/sass"
+      @location_two = "./public/stylesheets/sass"
+      Sass::Plugin.options[:template_location] = { @location_one => "public/css",
+                                                   @location_two => "public/css"}
+      write_sass(@location_one, "style")
+      write_sass(@location_two, "application")
+    end
+
+    it "serves up some sass from the normal location" do
+      get '/stylesheets/application.css'
+      last_response.should have_served_sass
+    end
+
+    it "serves up some sass from a different location" do
+      get '/css/style.css'
+      last_response.should have_served_sass
+    end
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification 
+name: aleksi-hassle
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Pedro Belo
+- Nick Quaranto
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-13 00:00:00 +04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: haml
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: Makes SASS less of a hassle on read-only filesystems by compiling and serving it up for you.
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+files: 
+- LICENSE
+- README.textile
+- init.rb
+- lib/hassle.rb
+- spec/base.rb
+- spec/hassle_compiler_spec.rb
+- spec/hassle_spec.rb
+has_rdoc: true
+homepage: http://github.com/AlekSi/hassle
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 17
+      segments: 
+      - 1
+      - 3
+      - 5
+      version: 1.3.5
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Make SASS less of a hassle. Supports Sass 3 / SCSS.
+test_files: 
+- spec/base.rb
+- spec/hassle_compiler_spec.rb
+- spec/hassle_spec.rb