stylist 0.1.0

data/lib/stylist/stylesheet_collection.rb

@@ -0,0 +1,92 @@
+module Stylist
+  class StylesheetCollection
+    attr_reader :collection
+
+    def configuration; ::Stylist.configuration; end
+    
+    def initialize
+      reset!
+    end
+
+    def reset!
+      @collection = ::ActiveSupport::OrderedHash.new { |h, k| h[k] = [] }
+    end
+    
+    def default
+      @collection[configuration.default_media]
+    end
+  
+    def append(*args)
+      options = args.extract_options!.symbolize_keys!
+      media = options.delete(:media) || configuration.default_media
+    
+      @collection[media] |= args.flatten.compact
+      self
+    end
+
+    alias_method :<<, :append
+    alias_method :push, :append
+  
+    def prepend(*args)
+      options = args.extract_options!.symbolize_keys!
+      media = options.delete(:media) || configuration.default_media
+    
+      @collection[media] = args.flatten.compact | @collection[media]
+      self
+    end
+  
+    def remove(*args)
+      options = args.extract_options!.symbolize_keys!
+      media = options.delete(:media) || configuration.default_media
+    
+      @collection[media] -= args
+      self
+    end
+  
+    def manipulate(*args)
+      return self if args.empty?
+      
+      options = args.extract_options!.symbolize_keys!
+      media = options.delete(:media) || configuration.default_media
+    
+      args.flatten.compact.each do |stylesheet|
+        name_as_string = stylesheet.to_s.clone
+        stylesheet = filtered_stylesheet_name(stylesheet)
+      
+        case
+          when name_as_string.starts_with?('+')
+            append(stylesheet, :media => media)
+          when name_as_string.ends_with?('+')
+            prepend(stylesheet, :media => media)
+          when name_as_string.starts_with?('-')
+            remove(stylesheet, :media => media)
+          else
+            append(stylesheet, :media => media)
+        end
+      end
+    
+      self
+    end
+  
+    def filtered_stylesheet_name(stylesheet)
+      name = stylesheet.to_s
+      name.gsub!(/^[+-]*/, '').gsub!(/[+-]*$/, '')
+    
+      return stylesheet.is_a?(Symbol) ? name.to_sym : name
+    end
+  
+    def process!
+      configuration.processors.each { |processor| processor.process!(@collection) }
+    end
+  
+    # by default, route missing methods to the collection hash
+    # otherwise hit the :all array
+    def method_missing(name, *args, &block)
+      if @collection.respond_to? name
+        @collection.send(name, *args, &block)
+      else
+        @collection[:all].send(name, *args, &block)
+      end
+    end
+  end
+end

data/lib/stylist/version.rb

@@ -0,0 +1,9 @@
+module Stylist
+  module VERSION
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/stylist/view_helpers.rb

@@ -0,0 +1,14 @@
+module Stylist
+  module ViewHelpers
+    def render_stylesheets
+      Stylist.stylesheets.process!
+      html = Stylist.stylesheets.inject('') do |html, (media, stylesheets)|
+        html << stylesheet_link_tag(*(stylesheets +
+          [ :media => media.to_s,
+            :recursive => true,
+            :cache => "all-#{stylesheets.hash.to_s}" ]))
+      end
+      html.respond_to?(:html_safe) ? html.html_safe : html
+    end
+  end
+end

data/lib/stylist.rb

@@ -0,0 +1,33 @@
+require 'stylist/version'
+require 'stylist/configuration'
+require 'stylist/processor'
+require 'stylist/stylesheet_collection'
+require 'stylist/controller_mixin'
+require 'stylist/view_helpers'
+require 'stylist/railtie' if defined?(::Rails) && ::Rails::VERSION::MAJOR >= 3
+
+module Stylist
+  class << self
+    attr_accessor :stylesheets
+  end
+  self.configuration = Configuration.new
+  self.stylesheets = StylesheetCollection.new
+end
+
+
+if defined? ::ActionController && defined? ::ActionView
+  ::ActionController::Base.send :include, ::Stylist::ControllerMixin
+  ::ActionView::Base.send :include, ::Stylist::ViewHelpers
+end
+
+if defined?(::Rails) && ::Rails::VERSION::MAJOR == 2
+  if defined? ::Haml
+    require 'stylist/processors/sass_processor'
+    ::Stylist.configure { |config| config.process_with :sass }
+  end
+
+  if defined? ::Less
+    require 'stylist/processors/less_processor'
+    ::Stylist.configure { |config| config.process_with :less }
+  end
+end

data/rails/init.rb

@@ -0,0 +1,4 @@
+# I know using rails/init.rb is deprecated, but it seems to be the only way to 
+# get Rails 2.x to actually treat the gem as a plugin and not a lazy-loadable library.
+
+require 'stylist'

data/spec/configuration_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'stylist'
+
+describe Stylist::Configuration do
+  before(:each) do
+    @configuration = ::Stylist::Configuration.new
+  end
+  
+  context '#add_configuration_options_for' do
+    it 'should create a new group in the configuration with options passed as a hash' do
+      @configuration.add_option_group :some_group, { :test_option => 'test', :second_option => 'second' }
+      @configuration.some_group.test_option.should == 'test'
+      @configuration.some_group.second_option.should == 'second'
+    end
+  end
+end

data/spec/controllers/controller_mixin_spec.rb

@@ -0,0 +1,22 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+require 'stylist'
+class DummyController < ApplicationController; def index; render :nothing => true; end; end
+ActionController::Routing::Routes.draw { |map| map.resources :dummy } if rails2?
+
+describe Stylist::ControllerMixin do
+  
+  describe DummyController, :type => :controller do
+    it 'should be included in controllers' do
+      get :index
+      included_modules = (class << controller; self; end).send :included_modules
+      included_modules.should include(Stylist::ControllerMixin)
+    end
+  
+    it 'should be able to manipulate the stylesheet collection using the "css" method' do
+      get :index
+      controller.css :home
+      Stylist.stylesheets.default.should include(:home)
+    end
+  end
+end

data/spec/controllers/view_helpers_spec.rb

@@ -0,0 +1,73 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+require 'stylist'
+
+class DummyController < ApplicationController; def index; render :inline => "<%= render_stylesheets %>"; end; end
+
+# Make sure we're not caching any assets
+ActionController::Base.perform_caching = false
+
+describe Stylist::ViewHelpers do
+  describe DummyController, :type => :controller do
+    before(:all) do
+      silence_warnings do
+        ActionView::Helpers::AssetTagHelper.send(
+          :const_set,
+          :STYLESHEETS_DIR,
+          File.dirname(__FILE__) + "/../fixtures/public/stylesheets"
+        )
+
+        ActionView::Helpers::AssetTagHelper.send(
+          :const_set,
+          :ASSETS_DIR,
+          File.dirname(__FILE__) + "/../fixtures/public"
+        )
+        
+        ActionView::DEFAULT_CONFIG = {
+          :assets_dir => File.dirname(__FILE__) + "/../fixtures/public",
+          :javascripts_dir => "#{File.dirname(__FILE__) + "/../fixtures/public"}/javascripts",
+          :stylesheets_dir => "#{File.dirname(__FILE__) + "/../fixtures/public"}/stylesheets",
+        }
+      end
+    end
+  
+    describe '#render_stylesheets' do
+      before(:each) do
+        @collection = Stylist.stylesheets = Stylist::StylesheetCollection.new
+      end
+    
+      context 'when collection is a list of files' do
+        it 'should render the <link> tags for each file' do
+          @collection << ['base', 'home']
+      
+          response = ::ActionView::Base.new.render_stylesheets
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/base.css")]')
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/home.css")]')
+        end
+      end
+    
+      context 'when collection is a list of expansions' do
+        it 'should render the <link> tags for each file in the expansion' do
+          ActionView::Helpers::AssetTagHelper.register_stylesheet_expansion :standard => ['base', 'home']
+          @collection << :standard
+      
+          response = ::ActionView::Base.new.render_stylesheets
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/base.css")]')
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/home.css")]')
+        end
+      end
+
+      context 'when collection is a mix of expansions and filenames' do
+        it 'should render the <link> tags for each file and expansion in the collection' do
+          ActionView::Helpers::AssetTagHelper.register_stylesheet_expansion :standard => ['base', 'home']
+          @collection << [:standard, 'layout', 'typography']
+      
+          response = ::ActionView::Base.new.render_stylesheets
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/base.css")]')
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/home.css")]')
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/layout.css")]')
+          response.should have_xpath('//link[starts-with(@href, "/stylesheets/typography.css")]')
+        end
+      end
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,37 @@
+require 'rubygems'
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'support'))
+
+RAILS_VERSION = (ENV['RAILS_VERSION'] || 2).to_s unless defined? RAILS_VERSION
+if RAILS_VERSION =~ /^3/
+  require 'boot_rails3'
+else
+  require 'boot_rails2'
+end
+
+def rails3?; RAILS_VERSION =~ /^3/ end
+def rails2?; !rails3?; end
+
+# plugin_root = File.join(File.dirname(__FILE__), '..')
+# version = ENV['RAILS_VERSION']
+# version = nil if version and version == ""
+#  
+# # first look for a symlink to a copy of the framework
+# if !version and framework_root = ["#{plugin_root}/rails", "#{plugin_root}/../../rails"].find { |p| File.directory? p }
+#   puts "found framework root: #{framework_root}"
+#   # this allows for a plugin to be tested outside of an app and without Rails gems
+#   # $:.unshift "#{framework_root}"
+#   $:.unshift "#{framework_root}/activesupport/lib", "#{framework_root}/actionpack/lib", "#{framework_root}/railties/lib"
+#   $:.unshift "#{framework_root}/active_support/lib", "#{framework_root}/action_pack/lib", "#{framework_root}/railties/lib"
+# else
+#   # simply use installed gems if available
+#   puts "using Rails#{version ? ' ' + version : nil} gems"
+#   require 'rubygems'
+#   
+#   if version
+#     gem 'rails', version
+#   else
+#     gem 'actionpack'
+#   end
+# end

data/spec/stylesheet_collection_spec.rb

@@ -0,0 +1,123 @@
+require 'spec_helper'
+require 'stylist/stylesheet_collection'
+
+describe Stylist::StylesheetCollection do
+  before(:each) do
+    @collection = Stylist::StylesheetCollection.new
+  end
+
+  it 'should be able to store stylesheet names' do
+    @collection << :standard
+    @collection.default.should include(:standard)
+  end
+  
+  it 'should automatically flatten arrays if any are passed as an argument' do
+    @collection << [[:standard, [:nested]]]
+    @collection.default.should == [:standard, :nested]
+  end
+  
+  it 'should not add nil values if any are passed as an argument' do
+    @collection << nil
+    @collection.default.should_not include(nil)
+  end
+  
+  it 'should not allow duplicates in stylesheet arrays' do
+    @collection << :standard
+    @collection << :standard
+    @collection.default.should have(1).stylesheet
+  end
+  
+  it 'should be able to chain calls' do
+    @collection.append(:standard, :base).prepend(:home).remove(:standard)
+    @collection.default.should == [:home, :base]
+  end
+  
+  describe '#append' do
+    it 'should add a stylesheet to the end of the array' do
+      @collection.push :home, :base
+      @collection.append :standard
+      @collection.default.last.should == :standard
+    end
+    
+    it 'should add a stylesheet to the specified media array when passed as an argument' do
+      @collection.push :home, :base
+      @collection.append :standard, :media => :print
+      @collection[:print].should == [:standard]
+    end
+  end
+  
+  describe '#prepend' do
+    it 'should add a stylesheet to the beginning of the array' do
+      @collection.push :home, :base
+      @collection.prepend :standard
+      @collection.default.first.should == :standard
+    end
+    
+    it 'should add a stylesheet to the beginning of the specified media array when passed as an argument' do
+      @collection.push :home, :base, :media => :print
+      @collection.prepend :standard, :media => :print
+      @collection[:print].should == [:standard, :home, :base]
+    end
+  end
+  
+  describe '#remove' do 
+    it 'should remove a stylesheet from the default collection when invoked without :media argument' do
+      @collection.append :home, :base
+      @collection.remove :home
+      
+      @collection.default.should == [:base]
+    end
+    
+    it 'should remove a stylesheet only from the specified media array when passed as an argument' do 
+      @collection.append :home, :base, :standard
+      @collection.append :standard, :media => :print
+
+      @collection.remove :standard, :media => :print
+      @collection.default.should == [:home, :base, :standard]
+      @collection[:print].should be_empty
+    end
+  end
+  
+  describe '#manipulate' do
+    it 'should append stylesheets by default' do
+      @collection.manipulate :standard, :home
+      @collection.default.should == [:standard, :home]
+    end
+    
+    it 'should append stylesheets if name is a string that starts with a + sign' do
+      @collection.manipulate '+standard'
+      @collection.default.should == ['standard']
+    end
+
+    it 'should append stylesheets if name is a symbol that starts with a + sign' do
+      @collection.manipulate :'+standard'
+      @collection.default.should == [:standard]
+    end
+    
+    it 'should prepend stylesheets if name is a string that ends with a + sign' do
+      @collection.append :base, :home
+      @collection.manipulate 'standard+'
+      @collection.default.first.should == 'standard'
+    end
+    
+    it 'should prepend stylesheets if name is a symbol that ends with a + sign' do
+      @collection.append :base, :home
+      @collection.manipulate :'standard+'
+      @collection.default.first.should == :standard
+    end
+    
+    it 'should remove stylesheet if name is a string that starts with a - sign' do
+      @collection.append 'base', :home
+      
+      @collection.manipulate '-base'
+      @collection.default.should == [:home]
+    end
+    
+    it 'should remove stylesheet if name is a symbol that starts with a - sign' do
+      @collection.append :base, :home
+      
+      @collection.manipulate :'-base'
+      @collection.default.should == [:home]
+    end
+  end
+end

data/spec/support/application_controller.rb

@@ -0,0 +1,3 @@
+class ApplicationController < ActionController::Base
+  helper :all
+end

data/spec/support/boot_rails2.rb

@@ -0,0 +1,8 @@
+puts "Setting up a Rails 2 environment..."
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}" unless defined?(RAILS_ROOT)
+require 'initializer'
+require 'action_controller'
+require 'spec'
+require 'spec/rails'
+require 'webrat/integrations/rspec-rails'

data/spec/support/boot_rails3.rb

@@ -0,0 +1,7 @@
+puts "Setting up a Rails 3 environment..."
+
+require 'action_controller/railtie'
+require 'active_support/railtie'
+require 'application_controller'
+require 'rspec'
+require 'rspec/rails'

data/stylist.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{stylist}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tisho Georgiev"]
+  s.date = %q{2010-03-30}
+  s.description = %q{Stylist provides powerful stylesheet management for your Rails app. You can organize your CSS files by media, add, remove or prepend stylesheets in the stylesheets stack from your controllers and views, and process them using Less or Sass. And as if that wasn't awesome enough, you can even minify them using YUI Compressor and bundle them into completely incomprehensible, but bandwidth-friendly mega-stylesheets.}
+  s.email = %q{tihomir.georgiev@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "init.rb",
+     "lib/stylist.rb",
+     "lib/stylist/configuration.rb",
+     "lib/stylist/controller_mixin.rb",
+     "lib/stylist/processor.rb",
+     "lib/stylist/processors/less_processor.rb",
+     "lib/stylist/processors/sass_processor.rb",
+     "lib/stylist/processors/yui_compressor_processor.rb",
+     "lib/stylist/railtie.rb",
+     "lib/stylist/stylesheet_collection.rb",
+     "lib/stylist/version.rb",
+     "lib/stylist/view_helpers.rb",
+     "rails/init.rb",
+     "spec/configuration_spec.rb",
+     "spec/controllers/controller_mixin_spec.rb",
+     "spec/controllers/view_helpers_spec.rb",
+     "spec/fixtures/public/stylesheets/base.css",
+     "spec/fixtures/public/stylesheets/home.css",
+     "spec/fixtures/public/stylesheets/layout.css",
+     "spec/fixtures/public/stylesheets/typography.css",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/stylesheet_collection_spec.rb",
+     "spec/support/application_controller.rb",
+     "spec/support/boot_rails2.rb",
+     "spec/support/boot_rails3.rb",
+     "stylist.gemspec"
+  ]
+  s.homepage = %q{http://github.com/tisho/stylist}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Powerful stylesheet management for your Rails app.}
+  s.test_files = [
+    "spec/configuration_spec.rb",
+     "spec/controllers/controller_mixin_spec.rb",
+     "spec/controllers/view_helpers_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/stylesheet_collection_spec.rb",
+     "spec/support/application_controller.rb",
+     "spec/support/boot_rails2.rb",
+     "spec/support/boot_rails3.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<rails>, [">= 2.3"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<rails>, [">= 2.3"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<rails>, [">= 2.3"])
+  end
+end
+

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification 
+name: stylist
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tisho Georgiev
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-30 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        version: "2.3"
+  type: :development
+  version_requirements: *id002
+description: Stylist provides powerful stylesheet management for your Rails app. You can organize your CSS files by media, add, remove or prepend stylesheets in the stylesheets stack from your controllers and views, and process them using Less or Sass. And as if that wasn't awesome enough, you can even minify them using YUI Compressor and bundle them into completely incomprehensible, but bandwidth-friendly mega-stylesheets.
+email: tihomir.georgiev@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.md
+- Rakefile
+- init.rb
+- lib/stylist.rb
+- lib/stylist/configuration.rb
+- lib/stylist/controller_mixin.rb
+- lib/stylist/processor.rb
+- lib/stylist/processors/less_processor.rb
+- lib/stylist/processors/sass_processor.rb
+- lib/stylist/processors/yui_compressor_processor.rb
+- lib/stylist/railtie.rb
+- lib/stylist/stylesheet_collection.rb
+- lib/stylist/version.rb
+- lib/stylist/view_helpers.rb
+- rails/init.rb
+- spec/configuration_spec.rb
+- spec/controllers/controller_mixin_spec.rb
+- spec/controllers/view_helpers_spec.rb
+- spec/fixtures/public/stylesheets/base.css
+- spec/fixtures/public/stylesheets/home.css
+- spec/fixtures/public/stylesheets/layout.css
+- spec/fixtures/public/stylesheets/typography.css
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/stylesheet_collection_spec.rb
+- spec/support/application_controller.rb
+- spec/support/boot_rails2.rb
+- spec/support/boot_rails3.rb
+- stylist.gemspec
+has_rdoc: true
+homepage: http://github.com/tisho/stylist
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Powerful stylesheet management for your Rails app.
+test_files: 
+- spec/configuration_spec.rb
+- spec/controllers/controller_mixin_spec.rb
+- spec/controllers/view_helpers_spec.rb
+- spec/spec_helper.rb
+- spec/stylesheet_collection_spec.rb
+- spec/support/application_controller.rb
+- spec/support/boot_rails2.rb
+- spec/support/boot_rails3.rb