erikhansson-precssious 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Erik Hansson
+
+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.rdoc

@@ -0,0 +1,71 @@
+= precssious
+
+This is just a hack to allow me to write nested CSS. I had trouble finding 
+a CSS preprocessor that actually allowed nested styles without breaking my 
+stylesheets.
+
+Although I am under no illusions of the general applicability of this code
+(the current implementation is very naïve), it appears to do OK with how I 
+write CSS.
+
+See spec/snippets.rb for a quick list of the features it supports.
+
+
+== On performance / configuration
+
+It's probably not a good idea to serve stylesheets using precssious under
+normal conditions. However, caching them in development can be a real drag.
+I've used the following approach.
+
+(1) I add a precssious dependency, and make sure it isn't loaded by default.
+
+/config/environment.rb
+
+  config.gem 'precssious', :lib => false
+
+(2) I add an initializer with the following code, to load precssious in 
+development:
+
+/config/initializers/precssious.rb
+
+  if RAILS_ENV == 'development'
+    require 'precssious'
+    Precssious.start_rails_controller
+  end
+
+This catches requests to "/stylesheets/xxx/xxx.css", and serves the content 
+of all stylesheets in that directory, merged into a single file. The web path 
+("stylesheets") and the source directory ("public/stylesheets") can both be 
+configured.
+
+(3) For production, I don't want Precssious loaded at all -- instead, I
+generate the stylesheets on deploy:
+
+/lib/tasks/precssious.rake
+
+  desc 'Generates the stylesheets as static resources'
+  task :precssious do
+    require 'precssious'
+    Precssious.perform_preprocessing
+  end
+
+/config/deploy.rb
+
+  after "deploy:update_code" do
+    run "cd #{current_path} && rake precssious"
+  end
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Erik Hansson. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "precssious"
+    gem.summary = %Q{Merges CSS files and allows nested declarations}
+    gem.description = %Q{}
+    gem.email = "erik@bits2life.com"
+    gem.homepage = "http://github.com/erikhansson/precssious"
+    gem.authors = ["Erik Hansson"]
+    gem.add_development_dependency "rspec"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "precssious #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/precssious

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'precssious'
+
+puts Precssious.process_files(Dir["#{ARGV[0]}/*.css"])

data/lib/precssious/preprocessor.rb

@@ -0,0 +1,95 @@
+
+module Precssious
+
+  class Preprocessor
+  
+    def initialize(input)
+      @tokens = []
+      
+      Preprocessor.tokenize(Preprocessor.strip_comments(input)) do |t|
+        @tokens << t
+      end
+    end
+  
+  
+    def pull(type = nil) 
+      result = @tokens.shift
+      if type && result.type != type
+        raise 'Unexpected token (#{result}, #{@tokens[0]}, #{@tokens[1]}, #{@tokens[2]}, #{@tokens[3]})' 
+      end
+      result
+    end
+    def peek; @tokens[0]; end
+    def peek2; @tokens[1] if @tokens.length > 1; end
+    def consume(type)
+      t = pull
+      if t.type != type
+        raise "Unexpected token (#{t.data}, #{@tokens[0]}, #{@tokens[1]}, #{@tokens[2]}, #{@tokens[3]}) #{t.type}, expected #{type}"  
+      end
+    end
+  
+  
+    def rules
+      result = []
+      while peek
+        result << rule
+      end
+      result
+    end
+  
+    def rule
+      Rule.new pull(:text).data, rule_value
+    end
+  
+    def rule_value
+      consume :lbrace
+      result = any
+      consume :rbrace
+      result
+    end
+  
+    def any
+      result = []
+      while (peek.type != :rbrace)
+        if peek2 && peek2.type == :lbrace
+          result << rule 
+        else
+          if peek2 && peek2.type == :semicolon
+            result << value 
+          else
+            raise 'Unexpected CSS syntax (missing ;?)'
+          end
+        end
+      end
+      result
+    end
+  
+    def value
+      l = pull(:text)
+      consume(:semicolon)
+      Value.new l.data
+    end
+  
+    def self.tokenize(input)
+      current = []
+      input.each_char do |c|
+        if %W({ } ;).include? c.to_s
+          prev = current.join('').strip
+          current.clear
+
+          yield Token.new(:text, prev) if prev.length > 0
+          yield Token.new(:lbrace, nil) if c.to_s == '{'
+          yield Token.new(:rbrace, nil) if c.to_s == '}'
+          yield Token.new(:semicolon, nil) if c.to_s == ';'
+        else
+          current << c
+        end
+      end
+    end
+    
+    def self.strip_comments(input)
+      input.gsub /\/\*.*?\*\//, ''
+    end
+    
+  end
+end

data/lib/precssious/rails/controller.rb

@@ -0,0 +1,9 @@
+class PrecssiousController < ActionController::Base
+  
+  def show
+    css = Precssious.process_files(Dir["#{Precssious.directory}/#{params[:id]}/*.css"].sort, true)
+    response.content_type = 'text/css'
+    render :text => css
+  end
+      
+end

data/lib/precssious/rails/routes.rb

@@ -0,0 +1,4 @@
+
+ActionController::Routing::Routes.draw do |map|
+  map.connect "#{Precssious.web_path}/:id/:filename.css", :controller => 'precssious', :action => 'show'
+end

data/lib/precssious/rule.rb

@@ -0,0 +1,51 @@
+
+module Precssious
+  
+  Rule = Struct.new :selector, :values
+
+  class Rule
+    def to_s(context = nil)
+      @context = context
+      r, v = values.partition { |x| Rule === x }
+    
+      result = []
+      result << "#{selector_string} { #{v.map { |x| x.to_s }.join ' '} }" if v.length > 0
+      
+      r.each do |nested|
+        result << nested.to_s(self)
+      end
+    
+      result.join "\n"
+    end
+  
+    def is_hack?
+      raw_selector_string =~ /\[[a-z0-9]*\]/
+    end
+    
+    def selector_string
+      raw_selector_string.gsub /\[[a-z0-9]*\] /, ''
+    end
+    
+    def raw_selector_string
+      selectors.join(', ').gsub(/\s+-/, '')
+    end
+    
+    def selectors
+      reverse, current = selector.split(',').map { |x| x.strip }.partition { |s| s =~ /<>/ }
+    
+      return current unless @context
+    
+      result = []
+    
+      @context.selectors.map do |cs|
+        current.map { |s| result << "#{cs} #{s}" }
+      end
+      reverse.map do |rs|
+        @context.selectors.map { |cs| result << "#{rs.gsub('<>', '').strip} #{cs}" }
+      end
+    
+      result
+    end
+  end
+  
+end

data/lib/precssious/token.rb

@@ -0,0 +1,12 @@
+
+module Precssious
+
+  Token = Struct.new :type, :data
+
+  class Token
+    def to_s
+      type == :text ? "[#{data}]" : ":#{type}"
+    end
+  end
+  
+end

data/lib/precssious/value.rb

@@ -0,0 +1,12 @@
+
+module Precssious
+  
+  Value = Struct.new :rule
+
+  class Value
+    def to_s
+      "#{rule};"
+    end
+  end
+  
+end

data/lib/precssious.rb

@@ -0,0 +1,69 @@
+
+require File.dirname(__FILE__) + "/precssious/rule"
+require File.dirname(__FILE__) + "/precssious/value"
+require File.dirname(__FILE__) + "/precssious/token"
+require File.dirname(__FILE__) + "/precssious/preprocessor"
+
+
+module Precssious
+  
+  def self.directory=(value); @directory = value; end
+  def self.directory; @directory; end
+  def self.web_path=(value); @web_path = value; end
+  def self.web_path; @web_path; end
+
+
+  ##
+  # Loads the Precssious controller and adds routes to it. This route matches
+  # [directory]/:id/:filename.css, which by default is stylesheets/:id/:filename.css.
+  #
+  def self.start_rails_controller
+    yield self if block_given?
+
+    @directory ||= Rails.root.join('public', 'stylesheets')
+    @web_path ||= 'stylesheets'
+
+    require "precssious/rails/controller"
+    ActionController::Routing::Routes.add_configuration_file(File.join(File.dirname(__FILE__), 'precssious', 'rails', 'routes.rb'))
+  end
+
+  ##
+  # Generates CSS with names matching the directory names from all the CSS files 
+  # included in that directory. By default searches public/stylesheets for directories
+  # to process (set Precssious.directory to change this).
+  #
+  def self.perform_preprocessing
+    yield self if block_given?
+    
+    Dir["#{@directory}/*"].each do |dir|
+      if File.directory?(dir)
+        css = process_files(Dir["#{dir}/*.css"].sort, true)
+        File.open "#{dir}/#{File.basename(dir)}.css", 'w' do |file|
+          file.write css
+        end
+      end
+    end
+  end
+  
+
+  def self.process(input)
+    Preprocessor.new(input).rules.map { |x| x.to_s }.join "\n"
+  end
+
+  def self.process_files(files, zero = false)
+    result = zero ? [zero_css] : []
+    files.each do |filename|
+      File.open filename, 'r' do |file|
+        result << '' << "/* #{File.basename(filename)} */"
+        result << process(file.read)
+      end
+    end
+    result.join "\n"
+  end
+  
+  def self.zero_css
+    "html{color:#000;background:#FFF;}body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,textarea,p,blockquote,th,td{margin:0;padding:0;}table{border-collapse:collapse;border-spacing:0;}fieldset,img{border:0;}address,caption,cite,code,dfn,em,strong,th,var{font-style:normal;font-weight:normal;}li{list-style:none;}caption,th{text-align:left;}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal;}q:before,q:after{content:'';}abbr,acronym {border:0;font-variant:normal;}sup {vertical-align:text-top;}sub {vertical-align:text-bottom;}input,textarea,select{font-family:inherit;font-size:inherit;font-weight:inherit;}input,textarea,select{*font-size:100%;}legend{color:#000;}"  
+  end
+  
+  
+end

data/precssious.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{precssious}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Erik Hansson"]
+  s.date = %q{2009-08-22}
+  s.default_executable = %q{precssious}
+  s.description = %q{}
+  s.email = %q{erik@bits2life.com}
+  s.executables = ["precssious"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "bin/precssious",
+     "lib/precssious.rb",
+     "lib/precssious/preprocessor.rb",
+     "lib/precssious/rails/controller.rb",
+     "lib/precssious/rails/routes.rb",
+     "lib/precssious/rule.rb",
+     "lib/precssious/token.rb",
+     "lib/precssious/value.rb",
+     "precssious.gemspec",
+     "spec/precssious_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/erikhansson/precssious}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Merges CSS files and allows nested declarations}
+  s.test_files = [
+    "spec/precssious_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end

data/spec/precssious_spec.rb

@@ -0,0 +1,117 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Precssious do
+  describe :process do
+    it "should handle regular styles" do
+      Precssious.process(%Q(
+        a { 
+          color: black;
+          text-decoration: none;
+        }
+      )).should == "a { color: black; text-decoration: none; }"
+    end
+  
+    it "should handle nested styles" do
+      Precssious.process(%Q(
+        a {
+          b {
+            color: blue;
+          }
+        }
+      )).should == "a b { color: blue; }"
+    end
+  
+    it "should handle mixed nested and regular styles" do
+      Precssious.process(%Q(
+        a {
+          color: black;
+        
+          b { color: blue; }
+        }
+      )).should == "a { color: black; }\na b { color: blue; }"
+    end
+  
+    it "should handle listed (comma delimited) styles" do
+      Precssious.process(%Q(
+        a, b {
+          c {
+            font-weight: bold;
+          }
+        }
+      )).should == "a c, b c { font-weight: bold; }"
+    end
+  
+    it "should handle nested listed styles" do
+      Precssious.process(%Q(
+        a, b {
+          c, d {
+            font-weight: bold;
+          }
+        }
+      )).should == "a c, a d, b c, b d { font-weight: bold; }"
+    end
+  
+    it "should provide a reverse-order nesting using <>" do
+      Precssious.process(%Q(
+        a {
+          .outer <> { color: red; }
+        }
+      )).should == ".outer a { color: red; }"
+    end
+  
+    it "should handle pseudoclasses" do
+      Precssious.process(%Q(
+        a { .to_movie1:hover { background-position: 0 -96px; } }
+      )).should == "a .to_movie1:hover { background-position: 0 -96px; }"
+    end
+  
+    it "should handle regular listed classes" do
+      Precssious.process(%Q(
+        html, body { height: 100%; background: #c0c0c0; text-aling: center; }
+      )).should == "html, body { height: 100%; background: #c0c0c0; text-aling: center; }"
+    end
+  
+    it "should allow for nested pseudoclass selectors" do
+      Precssious.process(%Q(
+        a { -:hover { text-decoration: underline; } }
+      )).should == "a:hover { text-decoration: underline; }"
+    end
+  
+    it "should allow nesting on arbitrary 'same-selector' basis" do
+      Precssious.process(%Q(
+        img {
+          -.mood1 { background-position: 0 0; }
+          -.mood2 { background-position: -70px 0; }
+        }
+      )).should == "img.mood1 { background-position: 0 0; }\nimg.mood2 { background-position: -70px 0; }"
+    end
+
+    it "should allow nesting on arbitrary 'same-selector' basis, with nesting" do
+      Precssious.process(%Q(
+        img, p {
+          -.mood1 { background-position: 0 0; }
+          -.mood2 { background-position: -70px 0; }
+        }
+      )).should == "img.mood1, p.mood1 { background-position: 0 0; }\nimg.mood2, p.mood2 { background-position: -70px 0; }"
+    end
+  
+    it "should ignore CSS comments" do
+      Precssious.process(%Q(
+        /* Prestyle comment. */
+        a { 
+          color: black; /* One in here, too */
+          text-decoration: none;
+        }
+      )).should == "a { color: black; text-decoration: none; }"
+    end
+  
+    it "should allow a special [ie6] selector" do
+      Precssious.process(%Q(
+        [ie6] a { 
+          color: black;
+          text-decoration: none;
+        }
+      )).should == "a { color: black; text-decoration: none; }"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'precssious'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: erikhansson-precssious
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Erik Hansson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-22 00:00:00 -07:00
+default_executable: precssious
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: ""
+email: erik@bits2life.com
+executables: 
+- precssious
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/precssious
+- lib/precssious.rb
+- lib/precssious/preprocessor.rb
+- lib/precssious/rails/controller.rb
+- lib/precssious/rails/routes.rb
+- lib/precssious/rule.rb
+- lib/precssious/token.rb
+- lib/precssious/value.rb
+- precssious.gemspec
+- spec/precssious_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/erikhansson/precssious
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: Merges CSS files and allows nested declarations
+test_files: 
+- spec/precssious_spec.rb
+- spec/spec_helper.rb