compass-rails31 0.12.0.alpha.0.91a748a

data/lib/compass/commands/default.rb

@@ -0,0 +1,50 @@
+module Compass
+  module Commands
+    module DefaultOptionsParser
+      def set_options(opts)
+        opts.on("--trace") do
+          self.options[:trace] = true
+        end
+        opts.on("-?", "-h", "--help") do
+          self.options[:command] = Proc.new do
+            Help.new(working_path, options.merge(:help_command => "help"))
+          end
+        end
+        opts.on("-q", "--quiet") do
+          self.options[:quiet] = true
+        end
+        opts.on("-v", "--version") do
+          self.options[:command] = Proc.new do
+            PrintVersion.new(working_path, options)
+          end
+        end
+        super
+      end
+    end
+    class Default < Base
+      
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(DefaultOptionsParser)
+        end
+        # def usage
+        #   $stderr.puts caller.join("\n")
+        #   "XXX"
+        # end
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parser.options[:command] ||= Proc.new do
+            Help.new(working_path, options.merge(:help_command => "help"))
+          end
+          parser.options
+        end
+      end
+
+      def execute
+        instance_eval(&options[:command]).execute
+      end
+    end
+  end
+end

data/lib/compass/commands/generate_grid_background.rb

@@ -0,0 +1,96 @@
+require 'compass/commands/project_base'
+require 'compass/commands/update_project'
+require 'compass/grid_builder'
+
+module Compass
+  module Commands
+    module GridBackgroundOptionsParser
+      def set_options(opts)
+        banner = %Q{Usage: compass grid-img W+GxH [path/to/grid.png]
+
+Description:
+  Generates a background image that can be used to check grid alignment.
+
+  Height is optional and defaults to 20px
+
+  By default, the image generated will be named "grid.png"
+  and be found in the images directory.
+
+  Unless you need to check layouts in legacy browsers, it's preferable
+  to use the pure CSS3-based grid background mixin:
+
+  http://compass-style.org/reference/compass/layout/grid_background/
+
+Examples:
+
+  compass grid-img 40+10 # 40px column, 10px gutter, 20px height
+  compass grid-img 40+20x28 # 40px column, 20px gutter, 28px height
+  compass grid-img 60+20x28 images/wide_grid.png
+
+Options:
+}
+        opts.banner = banner
+
+        super
+      end
+    end
+    class GenerateGridBackground < ProjectBase
+
+      include Actions
+
+      register :"grid-img"
+
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+          parser.extend(GridBackgroundOptionsParser)
+        end
+
+        def usage
+          option_parser([]).to_s
+        end
+
+        def description(command)
+          "Generates a grid background image."
+        end
+
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          if arguments.size == 0
+            raise OptionParser::ParseError, "Please specify the grid dimensions."
+          end
+          parser.options[:grid_dimensions] = arguments.shift
+          parser.options[:grid_filename] = arguments.shift
+          parser.options
+        end
+      end
+      def initialize(working_path, options)
+        super
+        assert_project_directory_exists!
+        Compass.add_configuration(options, 'command_line')
+      end
+
+      def perform
+        unless options[:grid_dimensions] =~ /^(\d+)\+(\d+)(?:x(\d+))?$/
+          puts "ERROR: '#{options[:grid_dimensions]}' is not valid."
+          puts "Dimensions should be specified like: 30+10x20"
+          puts "where 30 is the column width, 10 is the gutter width, and 20 is the (optional) height."
+          return
+        end
+        logger.yellow do
+          $stderr.puts "Unless you need to check layouts in legacy browsers, it's preferable"
+          $stderr.puts "to use the pure CSS3-based grid background mixin:"
+          $stderr.puts
+          $stderr.puts "http://compass-style.org/reference/compass/layout/grid_background/"
+        end
+        column_width = $1.to_i
+        gutter_width = $2.to_i
+        height = $3.to_i if $3
+        filename = options[:grid_filename] || projectize("#{project_images_subdirectory}/grid.png")
+        GridBuilder.new(options.merge(:column_width => column_width, :gutter_width => gutter_width, :height => height, :filename => filename, :working_path => self.working_path)).generate!
+      end
+    end
+  end
+end

data/lib/compass/commands/help.rb

@@ -0,0 +1,85 @@
+module Compass
+  module Commands
+    module HelpOptionsParser
+      def set_options(opts)
+        banner = %Q{Usage: compass help [command]
+
+Description:
+  The Compass Stylesheet Authoring Framework helps you
+  build and maintain your stylesheets and makes it easy
+  for you to use stylesheet libraries provided by others.
+
+Donating:
+  Compass is charityware. If you find it useful please make
+  a tax deductable donation: http://umdf.org/compass
+
+To get help on a particular command please specify the command.
+
+}
+        
+        primary_commands = Compass::Commands.all.select do |c|
+          cmd = Compass::Commands[c]
+          cmd.respond_to?(:primary) && cmd.primary
+        end
+        other_commands = Compass::Commands.all - primary_commands
+
+        banner << command_list("Primary Commands:", primary_commands)
+        banner << command_list("Other Commands:", other_commands)
+ 
+        banner << "\nAvailable Frameworks & Patterns:\n\n"
+        banner << Compass::Frameworks.pretty_print
+        banner << "\nGlobal Options:\n"
+        opts.banner = banner
+
+        super
+      end
+
+      def command_list(header, commands)
+        list = "#{header}\n"
+        commands.sort_by{|c| c.to_s}.each do |command|
+          list << "  * #{command}"
+          if Compass::Commands[command].respond_to? :description
+            list << "\t- #{Compass::Commands[command].description(command)}"
+          end
+          list << "\n"
+        end
+        list
+      end
+    end
+    class Help < Base
+      register :help
+      
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+          parser.extend(HelpOptionsParser)
+        end
+        def usage
+          option_parser([]).to_s
+        end
+        def description(command)
+          "Get help on a compass command or extension"
+        end
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parser.options[:help_command] = arguments.shift || 'help'
+          parser.options
+        end
+      end
+
+      def execute
+        if Compass::Commands.command_exists? options[:help_command]
+          $command = options[:help_command]
+          puts Compass::Commands[options[:help_command]].usage
+          $command = "help"
+        elsif Compass::Frameworks.template_exists? options[:help_command]
+          puts Compass::Frameworks.template_usage(options[:help_command])
+        else
+          raise OptionParser::ParseError, "No such command: #{options[:help_command]}"
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/imports.rb

@@ -0,0 +1,35 @@
+module Compass
+  module Commands
+    class Imports < ProjectBase
+      attr_accessor :options
+      register :imports
+      def initialize(working_path, options)
+        super
+      end
+  
+      def execute
+        print ::Compass::Frameworks::ALL.map{|f|
+                  "-I #{f.stylesheets_directory}"
+                }.join(' ')
+      end
+      class << self
+        def description(command)
+          "Emit an imports suitable for passing to the sass command-line."
+        end
+        def usage
+          "Usage: compass imports\n\n" +
+          "Prints out the imports known to compass.\n"+
+          "Useful for passing imports to the sass command line:\n" +
+          "  sass -r compass `compass imports` a_file_using_compass.sass"
+        end
+        def parse!(arguments)
+          if arguments.join("").strip.size > 0
+            raise OptionParser::ParseError, "This command takes no options or arguments."
+          else
+            {}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/installer_command.rb

@@ -0,0 +1,32 @@
+require 'compass/installers'
+
+module Compass
+  module Commands
+    module InstallerCommand
+      include Compass::Installers
+
+      def configure!
+        add_project_configuration
+        Compass.add_configuration(options, 'command_line')
+        Compass.discover_extensions!
+        Compass.add_configuration(installer.completed_configuration, 'installer')
+      end
+
+      def app
+        @app ||= Compass::AppIntegration.lookup(Compass.configuration.project_type)
+      end
+
+      def installer
+        @installer ||= if options[:bare]
+          Compass::Installers::BareInstaller.new(*installer_args)
+        else
+          app.installer(*installer_args)
+        end
+      end
+
+      def installer_args
+        [template_directory(options[:pattern] || "project"), project_directory, options]
+      end
+    end
+  end
+end

data/lib/compass/commands/interactive.rb

@@ -0,0 +1,61 @@
+
+require 'compass/commands/project_base'
+require 'compass/commands/update_project'
+
+module Compass
+  module Commands
+    module InteractiveOptionsParser
+      def set_options(opts)
+        opts.banner = %Q{
+          Usage: compass interactive [path/to/project] [options]
+
+          Description:
+            Interactively evaluate SassScript
+
+          Options:
+        }.strip.split("\n").map{|l| l.gsub(/^ {0,10}/,'')}.join("\n")
+
+        super
+      end
+    end
+    class Interactive < ProjectBase
+
+      register :interactive
+
+      def initialize(working_path, options)
+        super
+      end
+
+      def perform
+        require 'sass/repl'
+        Sass::Repl.new.run
+      end
+
+      class << self
+
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+          parser.extend(Compass::Exec::ProjectOptionsParser)
+          parser.extend(InteractiveOptionsParser)
+        end
+
+        def usage
+          option_parser([]).to_s
+        end
+
+        def description(command)
+          "Interactively evaluate SassScript"
+        end
+
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parser.options
+        end
+
+      end
+
+    end
+  end
+end

data/lib/compass/commands/list_frameworks.rb

@@ -0,0 +1,39 @@
+module Compass
+  module Commands
+    class ListFrameworks < ProjectBase
+      attr_accessor :options
+      register :frameworks
+      def initialize(working_path, options)
+        super
+      end
+  
+      def execute
+        if options[:quiet]
+          Compass::Frameworks::ALL.each do |framework|
+            puts framework.name unless framework.name =~ /^_/
+          end
+        else
+          puts "Available Frameworks & Patterns:\n\n"
+          puts Compass::Frameworks.pretty_print
+        end
+      end
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(Compass::Exec::GlobalOptionsParser)
+        end
+        def usage
+          option_parser([]).to_s
+        end
+        def description(command)
+          "List the available frameworks"
+        end
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parser.options
+        end
+      end
+    end
+  end
+end

data/lib/compass/commands/print_version.rb

@@ -0,0 +1,99 @@
+module Compass
+  module Commands
+    module VersionOptionsParser
+      def set_options(opts)
+        opts.banner = %Q{Usage: compass version [options]
+
+Options:
+}
+        opts.on_tail("-?", "-h", "--help", "Print out this message.") do
+          puts opts
+          exit
+        end
+        opts.on("-q", "--quiet", "Just print the version string.") do
+          self.options[:quiet] = true
+        end
+        opts.on("--major", "Print the major version number") do
+          self.options[:major] = true
+          self.options[:custom] = true
+        end
+        opts.on("--minor", "Print up to the minor version number") do
+          self.options[:major] = true
+          self.options[:minor] = true
+          self.options[:custom] = true
+        end
+        opts.on("--patch", "Print up to the patch version number") do
+          self.options[:major] = true
+          self.options[:minor] = true
+          self.options[:patch] = true
+          self.options[:custom] = true
+        end
+        opts.on("--revision", "Include the source control revision") do
+          self.options[:revision] = true
+          self.options[:custom] = true
+        end
+      end
+    end
+
+    class PrintVersion < Base
+      register :version
+
+      class << self
+        def option_parser(arguments)
+          parser = Compass::Exec::CommandOptionParser.new(arguments)
+          parser.extend(VersionOptionsParser)
+        end
+        def usage
+          option_parser([]).to_s
+        end
+        def description(command)
+          "Print out version information"
+        end
+        def parse!(arguments)
+          parser = option_parser(arguments)
+          parser.parse!
+          parser.options
+        end
+        def long_output_string
+          lines = []
+          lines << "Compass #{::Compass.version[:string]}"
+          if name = ::Compass.version[:name]
+            lines.last << " (#{name})"
+          end
+          lines << "Copyright (c) 2008-#{Time.now.year} Chris Eppstein"
+          lines << "Released under the MIT License."
+          lines << "Compass is charityware."
+          lines << "Please make a tax deductable donation for a worthy cause: http://umdf.org/compass"
+          lines.join("\n")
+        end
+      end
+
+      attr_accessor :options
+
+      def initialize(working_path, options)
+        self.options = options
+      end
+  
+      def execute
+        if options[:custom]
+          version = ""
+          version << "#{Compass.version[:major]}" if options[:major]
+          version << ".#{Compass.version[:minor]}" if options[:minor]
+          version << ".#{Compass.version[:teeny]}" if options[:patch]
+          if options[:revision]
+            if version.size > 0
+              version << " [#{Compass.version[:rev][0..6]}]"
+            else
+              version << Compass.version[:rev]
+            end
+          end
+          puts version
+        elsif options[:quiet]
+          puts ::Compass.version[:string]
+        else
+          puts self.class.long_output_string
+        end
+      end
+    end
+  end
+end