css_dryer 0.0.1

data/.autotest

@@ -0,0 +1,8 @@
+global_autotest_file = File.expand_path('~/.autotest')
+load(global_autotest_file) if File.exists?(global_autotest_file)
+
+class Autotest
+  def tests_for_file(filename)
+    Dir['test/**/*_test.rb']
+  end
+end

data/.gitignore

@@ -0,0 +1,2 @@
+pkg/
+Gemfile.lock

data/CHANGELOG

@@ -0,0 +1,129 @@
+= Change Log
+
+Below is a complete list of changes for each revision of CssDryer.
+
+== 0.4.3
+
+* Rake task to generate CSS from nested stylesheets "off-line".
+
+== 0.4.2
+
+* Rails 2.3.2 and Ruby 1.9 support (thanks David Balatero).
+
+== 0.4.1
+
+* Rack support.
+* Updated test nested stylesheet to render a partial and call a helper.
+
+== 0.4.0
+
+* Refactored file layout so tests run again.
+
+== 0.3.1
+
+* Merged Mina Guib's refactoring of the template handling code.  Partials now work again.  Thanks Mina!
+
+== 0.3.0
+
+* Rails 2.2 compatibility (thanks to Josh Peek for help).
+* The self_clear helper accepts a :clear option.
+
+== 0.2.8
+
+* Fixed bug in Stylesheets Helper affecting ie6 method (thanks to René).
+* Removed code in +render+ method made redundant by Rails 2.1.
+
+== 0.2.7
+
+* Rails 2.1 compatibility (thanks to Pete Yandell).
+
+== 0.2.6
+
+* Added a few browser hacks to StylesheetsHelper (thanks to René for the idea).
+* Add self-clearing to StylesheetsHelper.
+* Added test that reproduces bug where css_dryer forgives missing closing brace.  Just need to make it pass :-)
+* Added section on StylesheetsHelper to README.
+
+== 0.2.5
+
+* Added a generator for convenience.
+
+== 0.2.4
+
+* Fixed README to use proper Markdown syntax for links.
+
+== 0.2.3
+
+* Fixed typo in NcssHandler#render (reported by Ryan Kuykendall).
+
+== 0.2.2
+
+* Removed compilation step because it doesn't allow post-processing.
+
+== 0.2.1
+
+* Fixed typo with name of NcssHandler's compile method.
+* Elaborated README's partials example.
+
+== 0.2.0
+
+* Supports partial templates.
+* Works with Rails's template compilation mechanism.
+* Requires Rails 2.
+
+== 0.1.5
+
+* Achieved compatibility with Markaby by adding filepath paramater to template rendering (NcssHandler#render) method signature (incompatibility reported by Ray Carrasco).
+
+== 0.1.4
+
+* Commas in comments are sometimes replaced with a space to prevent them from being interpreted as selectors (thanks to Adrian Prodan for the bug report).  Yes, this is a shameful hack.
+* Added tests for multiline comments and comments containing blank lines (suggested by Phil Crosby).
+* Added a section on how comments are handled to the README.
+* Removed page_cache_extension line from the StylesheetsController code.  It was unnecessary and forced all cached pages, including HTML ones, to have a .css extension.
+
+== 0.1.3
+
+* Instance and local variables from the controller now available within stylesheets (thanks to Rifraf for prodding me into action).
+
+== 0.1.2
+
+* Incompatible with Rails 1.1.6 and below thanks to the use of <code>:format</code> in a route.  Update to Rails 1.2RC1 :)
+* Caches correctly with <code>.css</code> extension.  Updated the README with the necessary changes to the controller and routes.
+* Works with the <code>stylesheet_link_tag</code> helper.  Updated the README with the changes to make this work.
+
+== 0.1.1
+
+* Fixed bug where comma separated style values, e.g. font families, were misinterpreted as comma separated selectors.
+
+== 0.1.0
+
+* Handles comma separated selectors (suggested by John Nunemaker).
+* No longer outputs nested blank lines (noticed by Adi).
+
+== 0.0.5
+
+* Changed extension from <code>.dcss</code> to <code>.ncss</code> to avoid clashing with Miles Byrne's DCSS stylesheets (suggested by Miles).
+* Clarified the lack of support for nested, multiple, comma separated selectors by adding a paragraph to the README's Which Selectors Are Supported section.
+
+== 0.0.4
+
+* Handles class, pseudo-class, attribute, id, child and adjacent selectors (suggested by Adi and Maxim Kulkin).
+* No longer outputs empty selectors (noticed by Adi).
+* Fixed typo in nesting example in README.
+
+== 0.0.3
+
+* Fixed bug where parameter was passed to the wrong method.
+
+== 0.0.2
+
+* Added support for <code>@media</code> blocks.
+* Fixed bug in handling of non-nested descendant selectors.
+* Handles whitespace consistently, preserving the original as much as possible.
+
+== 0.0.1
+
+* Initial public release.
+* Handles descendant selectors.
+* Handles ERB.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/MIT-LICENCE

@@ -0,0 +1,20 @@
+Copyright (c) 2006 Andrew Stewart
+
+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.markdown

@@ -0,0 +1,273 @@
+# CssDryer -- Eliminate Repetition In Your Stylesheets
+
+*Please note I am no longer working on this.  I'm pleased to say it was the first and, for a long time, the only Rails plugin to support nested selectors.  It did the job admirably but now I use [SASS](http://sass-lang.com/) instead.*
+
+
+## Introduction
+
+Cascading style sheets (CSS) are wonderful but repetitive.  [Repetition is bad](http://en.wikipedia.org/wiki/Don't_repeat_yourself), so CssDryer lets you write CSS without repeating yourself.  And you don't need to learn any new syntax.
+
+There are two sources of repetition in CSS:
+
+* nested selectors
+* lack of variables
+
+Nested selectors lead to CSS like this:
+
+    div           { font-family: Verdana; }
+    div#content   { background-color: green; }
+    div#content p { color: red; }
+
+Note the triple repetition of `div` and the double repetition of `#content`.
+
+The lack of variables leads to CSS like this:
+
+    .sidebar { border: 1px solid #fefefe; }
+    .content { color: #fefefe; }
+
+Note the repeated colour `#fefefe`.
+
+CssDryer eliminates both of these.  The examples above become:
+
+    <% dark_grey = '#fefefe' %>
+
+    div {
+      font-family: Verdana;
+      #content {
+        background-color: green;
+        p { color: red; }
+      }
+    }
+
+    .sidebar { border: 1 px solid <%= dark_grey %>; }
+    .content { color: <%= dark_grey %>; }
+
+Note, though, that `@media` blocks are preserved.  For example:
+
+    @media screen, projection {
+      div {font-size:100%;}
+    }
+
+is left unchanged.
+
+The original whitespace is preserved as much as possible.
+
+
+## Which Selectors Are Supported?
+
+CssDryer handles all [CSS 2.1 selectors](http://www.w3.org/TR/CSS21/selector.html): nested descendant, child, adjacent, class, pseudo-class, attribute and id selectors.
+
+Multiple comma separated selectors are also supported.
+
+
+## Comments
+
+Comments on nested selectors do not get 'flattened' or de-nested with their selector.  For example comment B will be left inside the html selector below:
+
+Before:
+
+    /* Comment A */
+    html {
+      /* Comment B */
+      p {
+        color: blue;
+      }
+    }
+
+After:
+
+    /* Comment A */
+    html {
+      /* Comment B */
+    }
+    html p {
+      color: blue;
+    }
+
+This is suboptimal but I hope not too inconvenient.
+
+Please also note that commas in comments will sometimes be replaced with a space.  This is due to a shameful hack in the code that handles comma-separated selectors.
+
+
+## Partials
+
+You may use partial nested stylesheets as you would with normal templates.  For example, assuming your controller(s) set the @user variable and a User has a background colour (red):
+
+app/views/stylesheets/site.css.ncss:
+
+    body {
+      color: blue;
+      <%= render :partial => 'content', :locals => {:background => @user.background} %>
+    }
+
+app/views/stylesheets/_content.css.ncss:
+
+    div#content {
+      background: <%= background %>;
+      margin: 10px;
+    }
+
+And all this would render to `site.css`:
+
+    body {
+      color: blue;
+    }
+    body div#content {
+      background: red;
+      margin: 10px;
+    }
+
+
+## Remember the helper
+
+Browser hacks are an ugly necessity in any non-trivial stylesheet.  They clutter up your stylesheet without actually adding anything.  They make you sad.
+
+So encapsulate them in the StylesheetsHelper instead.  Separate your lovely CSS from the decidely unlovely hacks.  For example:
+
+app/views/stylesheets/site.css.ncss:
+
+    <% ie7 do %>
+      #sidebar {
+        padding: 4px;
+      }
+    <% end %>
+
+This renders to `site.css`:
+
+    *+html #sidebar {
+      padding: 4px;
+    }
+
+In this example the hacky selector, `*+html`, isn't too bad.  However some hacks are pretty long-winded, and soon you'll thank yourself for moving them out of your nested stylesheet.
+
+You don't have to limit yourself to browser hacks.  Consider self-clearing: to make an element clear itself requires 13 lines of CSS, in 3 selector blocks, by my count.  To make a second element clear itself, you need to add the element's selector to each of those three blocks.  It's fiddly.  And your stylesheet gets harder and harder to understand.
+
+We can do better:
+
+app/views/stylesheets/site.css.ncss:
+
+    <%= self_clear 'div.foo', 'div.bar', 'baz' %>
+
+Self-clear as many elements as you like in one easy line.
+
+
+## Installation
+
+### Rails plugin
+
+Pre-requisite: Rails 2.3.
+
+First, install in the usual Rails way.  From your application's directory:
+
+    $ script/plugin install git://github.com/airblade/css_dryer.git
+
+Second, generate the stylesheets controller and helper, and a test nested stylesheet:
+
+    $ script/generate css_dryer
+
+Third, add a named route to your `config/routes.rb`:
+
+    map.stylesheets 'stylesheets/:action.:format', :controller => 'stylesheets'
+
+Verify that everything is working by visiting this URL:
+
+    http://0.0.0.0:3000/stylesheets/test.css
+
+You should see this output:
+
+    body {
+      color: blue;
+    }
+    body p {
+      color: red;
+    }
+    h4 {
+      color: red;
+    }
+    h4 em { font-weight: bold; }
+    * + html h2 {
+      margin-top: 1em;
+    }
+
+If the output looks good, delete `app/views/stylesheets/{test,_foo}.css.ncss`.
+
+### Rack
+
+See the example `config.ru` file.  I'm a beginner with Rack so feedback would be much appreciated.
+    
+
+## Usage
+
+You put your stylesheets, DRY or otherwise, in `app/views/stylesheets/`.  Once rendered they will be cached in `public/stylesheets/`.
+
+DRY stylesheet files should have a `ncss` extension -- think 'n' for nested.  For example, `site.css.ncss`.
+
+Get them in your views with a `css` extension like this:
+
+    <link href='/stylesheets/site.css' rel='Stylesheet' type='text/css'>
+
+or with Rails' `stylesheet_link_tag` helper:
+
+    <%= stylesheet_link_tag 'site' %>
+
+
+## Caching, Rake and Capistrano
+
+By default the CSS rendered from your nested stylesheets is page-cached by Rails when caching is on (in production).  However there are two disadvantages:
+
+* You can't bundle these stylesheets into a single file (`stylesheet_link_tag :all, :cache => true`).
+* Rails' `stylesheet_link_tag` helper won't append a timestamp to the CSS path.  This means you cannot invalidate any browsers' caches of your stylesheet.  If you update your stylesheet, client web browsers will not see the update until they hard-reset their cache.
+
+We can solve both these problems by pre-generating our CSS files from our nested stylesheets every time we deploy.  Rails will then just see normal CSS files and the bundling and cache-busting behaviour will work again.
+
+The rake task `css_dryer:to_css` will convert your nested stylesheets into CSS files.  Use the following Capistrano code to get your servers to do this on each deploy:
+
+    namespace :deploy do
+      task :after_update_code do
+        generate_css
+      end
+
+      task :generate_css, :roles => [:web] do
+        run "cd #{release_path}; RAILS_ROOT=#{release_path} rake css_dryer:to_css"
+      end
+    end
+
+Note: this bypasses Rails so you can't do it if your nested stylesheets use instance variables from your controller.
+
+
+## Alternatives
+
+* [Less CSS][less]: on top of the variables and nested rules that css_dryer offers, Less provides mixins and operations.  This is a popular project under active development.
+
+* [Sass][sass]: variables, nested rules, mixins and more, all using a pared-down syntax.  From the creators of HAML.
+
+
+## Credits
+
+The idea came from John Nunemaker on [Rails Tips][railstips].  John beta-tested the code, provided a test case for @media blocks and suggested the controller's body.  Thanks John!
+
+
+## To Do
+
+* Configuration, e.g. `#implicit_nested_divs = true`
+* Package as a gem as well as a plugin.
+* Replace regexp-based nested-stylesheet parser with a Treetop parser.
+
+
+## Author
+
+[Andrew Stewart][aws], [AirBlade Software Ltd][airblade].
+
+
+## Licence
+
+CssDryer is available under the MIT licence.  See MIT-LICENCE for the details.
+
+Copyright (c) 2006-2010 Andrew Stewart
+
+
+  [less]: http://lesscss.org
+  [sass]: http://sass-lang.com
+  [railstips]: http://railstips.org/2006/12/7/styleaby-css-plugin/
+  [aws]: mailto:boss@airbladesoftware.com
+  [airblade]: http://airbladesoftware.com

data/Rakefile

@@ -0,0 +1,23 @@
+require 'bundler/gem_tasks'
+require 'rake'
+require 'rake/testtask'
+require 'rdoc/task'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the css_dryer plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the css_dryer plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'CssDryer'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/config.ru

@@ -0,0 +1,14 @@
+# An example Rackup file.
+
+require 'rubygems'
+require 'rack'
+require 'lib/rack/css_dryer'
+
+use Rack::CssDryer
+
+theapp = Proc.new { |env|
+  content = '<h1>Hi!</h1>'
+  [200, {'Content-Type' => 'text/html', 'Content-Length' => content.length.to_s}, content]
+}
+
+run theapp

data/css_dryer.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name          = "css_dryer"
+  gem.version       = "0.0.1"
+  gem.authors       = ["Andrew Stewart", "Peter Suschlik"]
+  gem.email         = ["boss@airbladesoftware.com", "ps@neopoly.de"]
+  gem.description   = %q{[Deprecated] The first CSS pre-processor for Rails 2.3}
+  gem.summary       = %q{Cascading style sheets (CSS) are wonderful but repetitive. Repetition is bad, so CssDryer lets you write CSS without repeating yourself. And you don't need to learn any new syntax.}
+  gem.homepage      = "https://github.com/neopoly/css_drayer"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rdoc'
+end

data/generators/css_dryer/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Generates the supporting code for your nested stylesheets, and a test nested stylesheet.
+
+Example:
+    ./script/generate css_dryer
+
+    This will create:
+        app/controllers/stylesheets_controller.rb
+        app/helpers/stylesheets_helper.rb
+        app/views/test.css.ncss
+        app/views/_foo.css.ncss

data/generators/css_dryer/css_dryer_generator.rb

@@ -0,0 +1,23 @@
+class CssDryerGenerator < Rails::Generator::Base
+  def manifest
+    record do |m|
+      m.file 'stylesheets_controller.rb',
+             'app/controllers/stylesheets_controller.rb',
+             :chmod => 0644,
+             :collision => :ask
+      m.file 'stylesheets_helper.rb',
+             'app/helpers/stylesheets_helper.rb',
+             :chmod => 0644,
+             :collision => :skip
+      m.directory 'app/views/stylesheets'
+      m.file 'test.css.ncss',
+             'app/views/stylesheets/test.css.ncss',
+             :chmod => 0644,
+             :collision => :skip
+      m.file '_foo.css.ncss',
+             'app/views/stylesheets/_foo.css.ncss',
+             :chmod => 0644,
+             :collision => :skip
+    end
+  end
+end

data/generators/css_dryer/templates/_foo.css.ncss

@@ -0,0 +1,4 @@
+h4 {
+  color: <%= bar %>;
+  em { font-weight: bold; }
+}

data/generators/css_dryer/templates/stylesheets_controller.rb

@@ -0,0 +1,11 @@
+class StylesheetsController < ApplicationController
+  before_filter :set_headers
+  after_filter { |controller| controller.cache_page }
+  layout nil
+
+  private
+
+  def set_headers
+    headers['Content-Type'] = 'text/css; charset=utf-8'
+  end
+end

data/generators/css_dryer/templates/stylesheets_helper.rb

@@ -0,0 +1,63 @@
+module StylesheetsHelper
+
+  # Internet Exploder hacks.
+
+  # <% ie6 do %>
+  #   css for ie6 here
+  # <% end %>
+  def ie6(&block)
+    wrap '* html', &block
+  end
+
+  # <% ie7 do %>
+  #   css for ie7 here
+  # <% end %>
+  def ie7(&block)
+    wrap '* + html', &block
+  end
+
+  # Self-clearing.  For example:
+  #
+  # <%= self_clear 'div#foo', 'img.bar', 'p ul' %>
+  #
+  # You can pass a hash as the final argument with these options:
+  #   :clear => 'left' | 'right' | 'both' (default)
+  def self_clear(*selectors)
+    options = selectors.extract_options!
+    clear = options[:clear] || 'both'
+
+    selector_template = lambda { |proc| selectors.map{ |s| proc.call s }.join ', ' }
+
+    p = lambda { |selector| "#{selector}:after" }
+    q = lambda { |selector| "* html #{selector}" }
+    r = lambda { |selector| "*:first-child+html #{selector}" }
+
+    <<-END
+    #{selector_template.call p} {
+      content: ".";
+      display: block;
+      height: 0;
+      clear: #{clear};
+      visibility: hidden;
+    }
+    #{selector_template.call q} {
+      height: 1%;
+    }
+    #{selector_template.call r} {
+      min-height: 1px;
+    }
+    END
+  end
+
+
+  private
+
+  # Wraps the block's output with +with+ and braces.
+  # css_dryer will then de-nest the result when it
+  # post-processes the result of the ERB evaluation.
+  def wrap(with, &block)
+    @output_buffer << "#{with} {"
+    yield
+    @output_buffer << '}'
+  end
+end

data/generators/css_dryer/templates/test.css.ncss

@@ -0,0 +1,12 @@
+body {
+  color: blue;
+  p {
+    color: red;
+  }
+}
+<%= render :partial => 'foo', :locals => {:bar => 'red'} %>
+<% ie7 do %>
+h2 {
+  margin-top: 1em;
+}
+<% end %>

data/init.rb

@@ -0,0 +1,5 @@
+require 'css_dryer/processor'
+require 'css_dryer/ncss_handler'
+
+# Register our template handler with Rails.
+ActionView::Template.register_template_handler :ncss, CssDryer::NcssHandler

data/install.rb

@@ -0,0 +1,3 @@
+# Print installation section of README.
+readme = IO.read(File.join(File.dirname(__FILE__), 'README.markdown'))
+puts readme[/(## Installation.*?)##/m, 1]

data/lib/css_dryer/ncss_handler.rb

@@ -0,0 +1,18 @@
+# Handler for DRY stylesheets which can be registered with Rails
+# as a new templating system.
+#
+# DRY stylesheets are piped through ERB and then CssDryer#process.
+module CssDryer
+
+  class NcssHandler < ActionView::TemplateHandlers::ERB
+    include CssDryer::Processor
+    # In case user doesn't have helper or hasn't run generator yet.
+    include StylesheetsHelper rescue nil
+
+    def compile(template)
+      temp = super
+      temp + "; @output_buffer = CssDryer::NcssHandler.new.process(@output_buffer)"
+    end
+  end
+
+end