compass 0.8.17 → 0.10.0.pre1

data/lib/compass/exec/switch_ui.rb

@@ -0,0 +1,166 @@
+require 'compass/exec/global_options_parser'
+require 'compass/exec/project_options_parser'
+
+module Compass::Exec
+  class SwitchUI
+    include GlobalOptionsParser
+    include ProjectOptionsParser
+    attr_accessor :args, :options, :opts
+
+    def initialize(args)
+      self.args = args
+      self.options = {}
+      parse!
+    end
+
+    def run!
+      begin
+        perform!
+      rescue Exception => e
+        raise e if e.is_a? SystemExit
+        if e.is_a?(::Compass::Error) || e.is_a?(OptionParser::ParseError)
+          $stderr.puts e.message
+        else
+          ::Compass::Exec::Helpers.report_error(e, @options)
+        end
+        return 1
+      end
+      return 0
+    end
+    
+    protected
+    
+    def perform!
+      if options[:command]
+        do_command(options[:command])
+      else
+        puts self.opts
+      end
+    end
+    
+    def parse!
+      self.opts = OptionParser.new(&method(:set_opts))
+      self.opts.parse!(self.args)    
+      if self.args.size > 0
+        self.options[:project_name] = trim_trailing_separator(self.args.shift)
+      end
+      self.options[:command] ||= self.options[:project_name] ? :create_project : :update_project
+      self.options[:framework] ||= :compass
+    end
+
+    def trim_trailing_separator(path)
+      path[-1..-1] == File::SEPARATOR ? path[0..-2] : path
+    end
+
+    def set_opts(opts)
+      opts.banner = <<END
+Usage: compass [options] [project]
+
+Description:
+The compass command line tool will help you create and manage the stylesheets for your project.
+
+To get started on a stand-alone project based on blueprint:
+
+  compass -f blueprint my_compass_project
+
+When you change any sass files, you must recompile your project using --update or --watch.
+END
+      opts.separator ''
+      opts.separator 'Mode Options(only specify one):'
+
+      opts.on('-i', '--install', :NONE, "Create a new compass project.",
+                                        "  The default mode when a project is provided.") do
+        self.options[:command] = :create_project
+      end
+
+      opts.on('-u', '--update', :NONE, 'Update the current project.',
+                                       '  This is the default when no project is provided.') do
+        self.options[:command] = :update_project
+      end
+
+      opts.on('-w', '--watch', :NONE, 'Monitor the current project for changes and update') do
+        self.options[:command] = :watch_project
+        self.options[:quiet] = true
+      end
+
+      opts.on('-p', '--pattern PATTERN', 'Stamp out a pattern into the current project.',
+                                         '  Must be used with -f.') do |pattern|
+        self.options[:command] = :stamp_pattern
+        self.options[:pattern] = pattern
+      end
+
+      opts.on('--write-configuration', "Write the current configuration to the configuration file.") do
+        self.options[:command] = :write_configuration
+      end
+
+      opts.on('--list-frameworks', "List compass frameworks available to use.") do
+        self.options[:command] = :list_frameworks
+      end
+
+      opts.on('--validate', :NONE, 'Validate your project\'s compiled css. Requires Java.') do
+        self.options[:command] = :validate_project
+      end
+
+      opts.on('--grid-img [DIMENSIONS]', 'Generate a background image to test grid alignment.',
+                                         '  Dimension is given as <column_width>+<gutter_width>x<height>.',
+                                         '  Defaults to 30+10x20. Height is optional.') do |dimensions|
+        self.options[:grid_dimensions] = dimensions || "30+10"
+        self.options[:command] = :generate_grid_background
+      end
+
+      opts.separator ''
+      opts.separator 'Install/Pattern Options:'
+
+      opts.on('-f FRAMEWORK', '--framework FRAMEWORK', 'Use the specified framework. Only one may be specified.') do |framework|
+        self.options[:framework] = framework
+      end
+
+      opts.on('-n', '--pattern-name NAME', 'The name to use when stamping a pattern.',
+                                           '  Must be used in combination with -p.') do |name|
+        self.options[:pattern_name] = name
+      end
+
+      opts.on('--rails', "Sets the app type to a rails project (same as --app rails).") do
+        self.options[:project_type] = :rails
+      end
+
+      opts.on('--app APP_TYPE', 'Specify the kind of application to integrate with.') do |project_type|
+        self.options[:project_type] = project_type.to_sym
+      end
+
+      opts.separator ''
+      opts.separator 'Configuration Options:'
+
+      set_project_options(opts)
+
+      opts.separator ''
+      opts.separator 'General Options:'
+
+      set_global_options(opts)
+
+      opts.on('--imports', :NONE, 'Emit an imports suitable for passing to the sass command-line.',
+                                  '  Example: sass `compass --imports`',
+                                  '  Note: Compass\'s Sass extensions will not be available.') do
+        print ::Compass::Frameworks::ALL.map{|f| "-I #{f.stylesheets_directory}"}.join(' ')
+        exit
+      end
+
+      opts.on('--install-dir', :NONE, 'Emit the location where compass is installed.') do
+        puts ::Compass.base_directory
+        exit
+      end
+
+      opts.on_tail("-v", "--version", "Print version") do
+        self.options[:command] = :print_version
+      end
+
+    end
+    
+    def do_command(command)
+      command_class_name = command.to_s.split(/_/).map{|p| p.capitalize}.join('')
+      command_class = eval("::Compass::Commands::#{command_class_name}")
+      command_class.new(Dir.getwd, options).execute
+    end
+
+  end
+end

data/lib/compass/frameworks.rb

@@ -1,6 +1,10 @@
 module Compass
   module Frameworks
+    extend self
+
     ALL = []
+    DEFAULT_FRAMEWORKS_PATH = File.join(Compass.lib_directory, 'compass', 'frameworks')
+
     class Framework
       attr_accessor :name
       attr_accessor :templates_directory, :stylesheets_directory
@@ -11,19 +15,78 @@ module Compass
         @templates_directory = options[:templates_directory] || File.join(path, 'templates')
         @stylesheets_directory = options[:stylesheets_directory] || File.join(path, 'stylesheets')
       end
+      def template_directories
+        Dir.glob(File.join(templates_directory, "*")).map{|f| File.basename(f)}
+      end
+      def manifest_file(pattern)
+        File.join(templates_directory, pattern.to_s, "manifest.rb")
+      end
+      def manifest(pattern, options = {})
+        options[:pattern_name] ||= pattern
+        Compass::Installers::Manifest.new(manifest_file(pattern), options)
+      end
     end
+
     def register(name, *arguments)
-      ALL << Framework.new(name, *arguments)
+      if idx = ALL.index(self[name])
+        ALL[idx] = Framework.new(name, *arguments)
+      else
+        ALL << Framework.new(name, *arguments)
+      end
     end
+
     def [](name)
       ALL.detect{|f| f.name.to_s == name.to_s}
     end
-    module_function :register, :[]
+
+    def discover(frameworks_directory)
+      frameworks_directory = DEFAULT_FRAMEWORKS_PATH if frameworks_directory == :defaults
+      frameworks_directory = Dir.new(frameworks_directory) unless frameworks_directory.is_a?(Dir)
+      frameworks_directory.entries.reject{|e| e[0] == ?.}.each do |framework|
+        register_directory File.join(frameworks_directory.path, framework)
+      end
+    end
+
+    def register_directory(directory)
+      loaders = [
+        File.join(directory, "compass_init.rb"),
+        File.join(directory, 'lib', File.basename(directory)+".rb"),
+        File.join(directory, File.basename(directory)+".rb")
+      ]
+      loader = loaders.detect{|l| File.exists?(l)}
+      if loader
+        require loader
+      else
+        register File.basename(directory), directory
+      end
+    end
+
+    def template_exists?(template)
+      framework_name, template = template.split(%r{/}, 2)
+      template ||= "project"
+      if framework = self[framework_name]
+        return File.directory?(File.join(framework.templates_directory, template))
+      end
+      false
+    end
+
+    def template_usage(template)
+      framework_name, template = template.split(%r{/}, 2)
+      framework = self[framework_name]
+      template ||= "project"
+      usage_file = File.join(framework.templates_directory, template, "USAGE.markdown")
+      if File.exists?(usage_file)
+        File.read(usage_file)
+      elsif help = framework.manifest(template).help
+        help
+      else
+        <<-END.gsub(/^ {8}/, '')
+          No Usage!
+        END
+      end
+    end
+
   end
 end
 
-# Import all of the default frameworks.
-default_frameworks_directory = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'frameworks'))
-Dir.glob(File.join(default_frameworks_directory, "*.rb")).each do |framework|
-  require framework
-end
+Compass::Frameworks.discover(:defaults)

data/lib/compass/frameworks/blueprint/stylesheets/_blueprint.sass

@@ -0,0 +1,31 @@
+@import blueprint/colors.sass
+@import blueprint/grid.sass
+@import blueprint/typography.sass
+@import blueprint/utilities.sass
+@import blueprint/form.sass
+@import blueprint/interaction.sass
+@import blueprint/debug.sass
+@import blueprint/print.sass
+@import blueprint/ie.sass
+
+// Usage examples:
+// As a top-level mixin, apply to any page that includes the stylesheet:
+//   +blueprint
+// Scoped by a presentational class:
+//   body.blueprint
+//    +blueprint(true)
+// Scoped by semantic selectors:
+//   body#page-1, body#page-2, body.a-special-page-type
+//     +blueprint(true)
+// Deprecated:
+//   You can pass the body selector as the first argument when used as a top-level mixin
+//   +blueprint("body#page-1, body#page-2, body.a-special-page-type")
+=blueprint(!body_selector = "body")
+  @if not (!body_selector == "body" or !body_selector == true)
+    @debug "[DEPRECATED] To specify a the selector \"#{!body_selector}\" to +blueprint, pass true as the first argument and mix it into #{!body_selector}."
+  +blueprint-typography(!body_selector)
+  +blueprint-utilities
+  +blueprint-grid
+  +blueprint-debug
+  +blueprint-interaction
+  +blueprint-form

data/{frameworks/blueprint/stylesheets/blueprint/modules → lib/compass/frameworks/blueprint/stylesheets/blueprint}/_buttons.sass

@@ -1,4 +1,4 @@
-@import compass/utilities/general/inline_block.sass
+@import compass/css3/inline_block.sass
 @import compass/utilities/general/float.sass
 
 // Button Font
@@ -24,9 +24,9 @@
   @param border_highlight_color
     The highlight color defaults to whatever is the value of the border_color but it's one shade lighter.
 =button-colors(!font_color = !blueprint_button_font_color, !bg_color = !blueprint_button_background_color, !border_color = !blueprint_button_border_color, !border_highlight_color = !border_color + #101010)
-  :background-color= !bg_color
-  :border-color= !border_highlight_color !border_color !border_color !border_highlight_color
-  :color= !font_color
+  background-color= !bg_color
+  border-color= !border_highlight_color !border_color !border_color !border_highlight_color
+  color= !font_color
 
 //**
   Sets the colors for a button in the active state
@@ -46,39 +46,39 @@
 
 =button-base(!float = false)
   @if !float
-    :display block
+    display: block
     +float(!float)
   @else
     +inline-block
-  :margin 0.7em 0.5em 0.7em 0
-  :border-width 1px
-  :border-style solid
-  :font-family= !blueprint_button_font_family
-  :font-size 100%
-  :line-height 130%
-  :text-decoration none
-  :font-weight bold
-  :cursor pointer
+  margin: 0.7em 0.5em 0.7em 0
+  border-width: 1px
+  border-style: solid
+  font-family= !blueprint_button_font_family
+  font-size: 100%
+  line-height: 130%
+  text-decoration: none
+  font-weight: bold
+  cursor: pointer
   img
-    :margin 0 3px -3px 0 !important
-    :padding 0
-    :border none
-    :width 16px
-    :height 16px
-    :float none
+    margin: 0 3px -3px 0 !important
+    padding: 0
+    border: none
+    width: 16px
+    height: 16px
+    float: none
     
 
 =anchor-button(!float = false)
   +button-base(!float)
-  :padding 5px 10px 5px 7px
+  padding: 5px 10px 5px 7px
 
 =button-button(!float = false)
   +button-base(!float)
-  :width auto
-  :overflow visible
-  :padding 4px 10px 3px 7px
+  width: auto
+  overflow: visible
+  padding: 4px 10px 3px 7px
   &[type]
-    :padding 4px 10px 4px 7px
-    :line-height 17px
+    padding: 4px 10px 4px 7px
+    line-height: 17px
   *:first-child+html &[type]
-    :padding 4px 10px 3px 7px
+    padding: 4px 10px 3px 7px

data/{frameworks/blueprint/stylesheets/blueprint/modules → lib/compass/frameworks/blueprint/stylesheets/blueprint}/_debug.sass

@@ -1,9 +1,9 @@
 =showgrid(!image = "grid.png")
-  :background= image_url(!image)
+  background= image_url(!image)
 
 =blueprint-debug(!grid_image = "grid.png")
   // Use this class on any column or container to see the grid.
   // TODO: prefix this with the project path.
   .showgrid
     +showgrid(!grid_image)
-  
+  

data/{frameworks/blueprint/stylesheets/blueprint/modules → lib/compass/frameworks/blueprint/stylesheets/blueprint}/_fancy_type.sass

@@ -2,7 +2,7 @@
 
 //
   To install the fancy type plugin:
-    1. import the fancy_type module: @import blueprint/modules/fancy_type
+    1. import the fancy_type module: @import blueprint/fancy_type
     2. mixin +fancy-type to your project's body or at the top level of your stylesheet:
       body
         +fancy-type
@@ -18,11 +18,11 @@
 
 // Indentation instead of line shifts for sibling paragraphs. Mixin to a style like p + p
 =sibling-indentation
-  :text-indent 2em
-  :margin-top -1.5em
+  text-indent: 2em
+  margin-top: -1.5em
   /* Don't want this in forms.
   form &
-    :text-indent 0
+    text-indent: 0
 
 //
   For great looking type, use this code instead of asdf: 
@@ -30,10 +30,10 @@
   Best used on prepositions and ampersands.
 
 =alt
-  :color #666
-  :font-family "Warnock Pro", "Goudy Old Style","Palatino","Book Antiqua", Georgia, serif
-  :font-style italic
-  :font-weight normal
+  color: #666
+  font-family: "Warnock Pro", "Goudy Old Style","Palatino","Book Antiqua", Georgia, serif
+  font-style: italic
+  font-weight: normal
 
 //
   For great looking quote marks in titles, replace "asdf" with:
@@ -41,7 +41,7 @@
   (That is, when the title starts with a quote mark). 
   (You may have to change this value depending on your font size).
 =dquo(!offset = 0.5em)
-  :margin-left -!offset
+  margin-left: -!offset
 
 //
   Reduced size type with incremental leading
@@ -58,21 +58,21 @@
     base_font_size - The base font size in pixels. Defaults to 12px
     old_line_height - The old line height. Defaults to 1.5 times the base_font_size
 =incr(!font_size = 10px, !base_font_size = !blueprint_font_size, !old_line_height = !base_font_size * 1.5)
-  :font-size= 1em * !font_size / !base_font_size
-  :line-height= 1em * !old_line_height / !font_size * 4 / 5
-  :margin-bottom 1.5em
+  font-size= 1em * !font_size / !base_font_size
+  line-height= 1em * !old_line_height / !font_size * 4 / 5
+  margin-bottom: 1.5em
 
 //
   Surround uppercase words and abbreviations with this class.
   Based on work by Jørgen Arnor Gårdsø Lom [http://twistedintellect.com/]
 =caps
-  :font-variant small-caps
-  :letter-spacing 1px
-  :text-transform lowercase
-  :font-size 1.2em
-  :line-height 1%
-  :font-weight bold
-  :padding 0 2px
+  font-variant: small-caps
+  letter-spacing: 1px
+  text-transform: lowercase
+  font-size: 1.2em
+  line-height: 1%
+  font-weight: bold
+  padding: 0 2px
 
 =fancy-paragraphs
   p + p