compass 0.8.17 → 0.10.0.pre1

data/CHANGELOG.markdown

@@ -1,6 +1,171 @@
 COMPASS CHANGELOG
 =================
 
+0.10.0.pre1 (November 29, 2009)
+--------------------------------
+
+Deprecated in this release:
+
+* The usless blueprint "modules" folder will be removed. Please update your
+  blueprint imports by removing the modules folder. Deprecation warnings will be
+  emitted if you use the old imports.
+* Blueprint mixins that used to accept a "body selector" argument, are now
+  deprecated, instead you should pass `true` to them and mix them into
+  the selector of your choice.
+* If you are using the `+opacity` or `+inline-block` mixins, you may need to update your imports.
+* In your configuration file, setting `http_images_path` to `:relative` is
+  deprecated in favor of setting `relative_assets` to `true`
+* The YUI framework has been extracted to a plugin.
+  If you use it, please follow the [installation instructions](http://github.com/chriseppstein/yui-compass-plugin)
+
+Command-Line:
+
+* The compass command-line tool has been re-written to allow be easier to
+  use and be more flexible. The old command line is still supported at
+  this time. "compass help" will get you started on using the new
+  command line syntax.
+* Allow specification of a height for the grid image
+* For the truly hardcore compass users, you may now create a
+  compass project using "compass create my_project --bare"
+  and you'll have a completely bare project created for you with no
+  sass files provided for you.
+* Get stats on your compass project with "compass stats". You'll
+  need to install the "css_parser" ruby gem to get stats on your
+  css files.
+
+Configuration:
+
+* The entire configuration infrastructure has been re-written to make it
+  easier to support the various sources of configuration data (project type,
+  config file, command line, and hard coded defaults)
+* Whether to generate relative links to assets is now controlled by a
+  separate boolean configuration flag called `relative_assets` in the
+  configuration file and `--relative-assets` on the command line.
+  Setting `http_images_path` to `:relative` is deprecated.
+* You may now configure the http locations for your project by simply setting
+  `http_path` for the top level path of the project. You
+  may also set `http_images_dir`, `http_stylesheets_dir`, and
+  `http_javascripts_dir` relative to the `http_path` instead of
+  setting the absolute `http_XXX_path` counterparts.
+* You may now configure the fonts directory for your project (fonts_dir).
+  By default, for standalone projects, it is the "fonts" subdirectory of
+	your css directory. Rails projects will default to "public/fonts".
+
+Compass Core:
+
+* A new helper function `stylesheet_url(path)` can now be used to refer
+  to assets that are relative to the css directory.
+* Compass sprite mixins are now more flexible and feature rich.
+* Fixed the append_selector function to allow comma-delimited selectors
+  for both arguments instead of just the first
+* There is no longer any outline on unstyled links in the :active and :focused states.
+* IE6 bug fixes for sticky-footer
+* New CSS3 Compatibility Mixins. You can import them all with `@import compass/css3.sass`
+    * `+opacity(amount)` where amount should be between 0 and 1, where 0 is transparent and 1 is opaque.
+    * `+opaque` and `+transparent` mixins for convenience. Built on top of the opacity mixin.
+    * `+border-radius(amount)` as well as the following convenience mixins:
+        * `+border-top-left-radius(amount)`
+        * `+border-top-right-radius(amount)`
+        * `+border-top-right-radius(amount)`,
+        * `+border-bottom-left-radius(amount)`
+        * `+border-bottom-right-radius(amount)`
+        * `+border-top-radius(amount)`
+        * `+border-right-radius(amount)`
+        * `+border-left-radius(amount)`
+        * `+border-bottom-radius(amount)`
+    * `+box-shadow(!horiz_offset, !vert_offset, !blur, !color)`
+    * `+box-sizing(!sizing_mode)`
+    * Column support via the following mixins:
+        * `+column-count`
+        * `+column-gap`
+        * `+column-width`
+        * `+column-rule-width`
+        * `+column-rule-style`
+        * `+column-rule-color`
+        * `+column-rule`
+    * `+background-clip(clip)` where clip can be `padding-box` or `border-box`
+    * `+background-origin(origin)` where origin can be `padding-box`, `border-box`, or `content-box`
+    * `+background-size(size)` where size is a width and height. E.g. "50% 75%"
+    * `+font-face` should be mixed into the top level of your document.
+      Usage Example: `+font-face("this name", font-files("this.woff", "woff", "this.otf", "opentype"), "fonts/this.eot", "thisname")`
+    * Simple Background Gradient Support:
+      * `+gradient` - Generic background gradient mixin
+      * `+radial-gradient` - Radial gradient mixin
+      * `+linear-gradient` - Linear gradient mixin
+      * `+h-gradient` - Horizontal linear gradient mixin
+      * `+v-gradient` - Vertical linear gradient mixin
+    * `+text-shadow` - Create a text shadow effect.
+    * Transforms Support:
+      * `+transform`
+      * `+scale`
+      * `+rotate`
+      * `+translate`
+      * `+skew`
+    * Transition Support:
+      * `+transition-property`
+      * `+transition-duration`
+      * `+transition-timing-function`
+      * `+transition-delay`
+      * `+transition`
+    * The import for `+inline-block` has moved from compass/utilities/general/inline_block
+      to compass/css3/inline_block
+    * The import for `+opacity` has moved from compass/utilities/general/opacity
+      to compass/css3/opacity
+    * Note: If you are using the `+opacity` or `+inline-block` mixins,
+      you may need to update your imports.
+
+Blueprint:
+
+* Make the primary blueprint mixins easier to use by allowing them to be nested when passing true as the first argument.
+  The old approach of passing a selector as the first argument is now deprecated in favor of a simple flag to indicate nesting or not.
+
+YUI:
+
+* YUI was upgraded to 2.7.0
+* Yahoo has deprecated the YUI CSS framework, as such YUI has been extracted to a plugin.
+  If you use it, please install it with: `sudo gem install compass-yui`
+
+Extensions:
+
+* Extensions can now be installed locally by unpacking them into a project's
+  "extensions" directory. Rails projects use "vendor/plugins/compass/extenstions".
+* Extensions can deliver html to projects if they like. The html can be in
+  haml and will be transformed to html and can contain inline, compass-enabled
+	sass.
+* All files can be processed using ERB before being copied into the user's
+  project.
+* Compass extensions can now add support for other application frameworks.
+  These extensions can help compass understand the project structure of that
+  framework as well as provide runtime integration for ruby-based apps.
+  Contact me if you plan to do this -- the first couple times may be a little
+  rough.
+* Compass extensions can now add new command line commands. Contact me if you
+  plan to do this -- the first couple times may be a little rough.
+* Extensions can now provide help documentation just after a project is
+  created and on demand when the user uses the command line help system.
+  This can be done via the manifest file or by adding a USAGE.markdown file
+  at the top level of the framework template.
+
+Miscellaneous:
+
+* The compass configuration object is no longer a singleton, this makes it
+  possible for other ruby software to manage multiple compass projects at a
+  time.
+* Compass no longer requires rubygems in order to work, this is a ruby
+  best-practice.
+* All sass provided by compass now uses css-style property syntax.
+* The command line tool is now tested using the cucumber testing framework.
+
+Many thanks to the following Contributors:
+
+  * Brandon Mathis - CSS3 (+opacity, +border-radius) and sprites
+  * Eric Meyer - CSS3 (+box-shadow, +columns, +box-sizing)
+  * Jacques Crocker - Merb Compatibility fixes
+  * Gabriel Mansour - Fixes to +unstyled-link
+  * John Debs - IE6 Fixes for +sticky-footer
+  * Brian Johnson - Upgraded to YUI 2.7.0
+  * Beau Smith - fixing my dyslexia.
+
 0.8.17 (September 24, 2009)
 ---------------------------
 

data/README.markdown

@@ -3,8 +3,10 @@ A [Sass][sass]-based CSS Meta-Framework that allows you to mix and match any of
 
 - [Compass Core][compass_core_website] - [Wiki Documentation][compass_core_wiki]
 - [Blueprint][blueprint_website] - [Wiki Documentation][bleuprint_wiki]
-- [YUI][yui_website] - [Wiki Documentation][yui_wiki]
 - [960][ninesixty_website] - [Wiki Documentation][ninesixty_wiki]
+- [Susy][susy_website] - [Wiki Documentation][susy_wiki]
+- [YUI][yui_website] - [Wiki Documentation][yui_wiki]
+- New frameworks and extensions are [tracked on the wiki][plugins_wiki] as they are created.
 - Other frameworks can be added relatively easily. Create your own!
 
 ## Compass Provides
@@ -13,6 +15,13 @@ A [Sass][sass]-based CSS Meta-Framework that allows you to mix and match any of
 2. Simple integration with [Ruby-on-Rails][ruby_on_rails_wiki], [Merb][merb_wiki], [StaticMatic][static_matic_wiki], and even [non-ruby application servers][command_line_wiki].
 3. Loads of Sass mixins to make building your website a snap.
 
+## Quick Start
+
+    $ (sudo) gem install compass
+    $ compass create my_compass_project --using blueprint
+    $ cd my_compass_project
+    $ compass watch
+
 ## More Information
 Please see the [wiki][wiki]
 
@@ -25,13 +34,14 @@ Copyright (c) 2008-2009 Christopher M. Eppstein<br>
 All Rights Reserved.<br>
 Released under a [slightly modified MIT License][license].
 
-[sass]: http://haml.hamptoncatlin.com/docs/rdoc/classes/Sass.html "Syntactically Awesome StyleSheets"
+[sass]: http://sass-lang.com/ "Syntactically Awesome StyleSheets"
 [compass_core_website]: http://github.com/chriseppstein/compass/tree/master/frameworks/compass
 [compass_core_wiki]: http://github.com/chriseppstein/compass/wikis/compass-core-documentation
 [blueprint_website]: http://blueprintcss.org/
 [bleuprint_wiki]: http://github.com/chriseppstein/compass/wikis/blueprint-documentation
 [yui_website]: http://developer.yahoo.com/yui/grids/
 [yui_wiki]: http://github.com/chriseppstein/compass/wikis/yui-documentation
+[plugins_wiki]: http://github.com/chriseppstein/compass/wikis/compass-plugins
 [ninesixty_website]: http://960.gs/
 [ninesixty_wiki]: http://github.com/chriseppstein/compass/wikis/960gs-documentation
 [command_line_wiki]: http://wiki.github.com/chriseppstein/compass/command-line-tool
@@ -39,6 +49,8 @@ Released under a [slightly modified MIT License][license].
 [ruby_on_rails_wiki]: http://wiki.github.com/chriseppstein/compass/ruby-on-rails-integration
 [merb_wiki]: http://wiki.github.com/chriseppstein/compass/merb-integration
 [static_matic_wiki]: http://wiki.github.com/chriseppstein/compass/staticmatic-integration
-[chris_eppstein]: http://acts-as-architect.blogspot.com
+[chris_eppstein]: http://chriseppstein.github.com
 [caring.com]: http://www.caring.com/ "Senior Care Resources"
 [license]: http://github.com/chriseppstein/compass/tree/master/LICENSE.markdown
+[susy_website]: http://www.oddbird.net/susy/
+[susy_wiki]: http://github.com/chriseppstein/compass/wikis/susy-documentation 

data/Rakefile

@@ -2,7 +2,8 @@ if ENV['RUN_CODE_RUN']
   # We need to checkout edge haml for the run>code>run test environment.
   if File.directory?("haml")
     Dir.chdir("haml") do
-      sh "git", "pull"
+      sh "git", "fetch"
+      sh "git", "reset", "--hard", "origin/stable"
     end
   else
     sh "git", "clone", "git://github.com/nex3/haml.git"
@@ -12,7 +13,9 @@ end
 
 require 'rubygems'
 require 'rake'
-require 'lib/compass'
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require 'compass'
+require 'rcov/rcovtask'
 
 # ----- Default: Testing ------
 
@@ -23,6 +26,7 @@ require 'fileutils'
 
 Rake::TestTask.new :run_tests do |t|
   t.libs << 'lib'
+  t.libs << 'test'
   t.libs << 'haml/lib' if ENV["RUN_CODE_RUN"]
   test_files = FileList['test/**/*_test.rb']
   test_files.exclude('test/rails/*', 'test/haml/*')
@@ -45,7 +49,7 @@ begin
     gemspec.description = "Compass is a Sass-based Stylesheet Framework that streamlines the creation and maintainance of CSS."
     gemspec.authors = ["Chris Eppstein"]
     gemspec.has_rdoc = false
-    gemspec.add_dependency('haml', '>= 2.2.0')
+    gemspec.add_dependency('haml', '>= 2.2.14')
     gemspec.files = []
     gemspec.files << "CHANGELOG.markdown"
     gemspec.files << "README.markdown"
@@ -58,12 +62,13 @@ begin
     gemspec.files += Dir.glob("examples/**/*.*")
     gemspec.files -= Dir.glob("examples/**/*.css")
     gemspec.files -= Dir.glob("examples/**/*.html")
-    gemspec.files += Dir.glob("frameworks/**/*.*")
+    gemspec.files -= Dir.glob("examples/*/extensions/**")
     gemspec.files += Dir.glob("lib/**/*")
     gemspec.files += Dir.glob("test/**/*.*")
     gemspec.files -= Dir.glob("test/fixtures/stylesheets/*/saved/**/*.*")
     gemspec.test_files = Dir.glob("test/**/*.*")
     gemspec.test_files -= Dir.glob("test/fixtures/stylesheets/*/saved/**/*.*")
+    gemspec.test_files += Dir.glob("features/**/*.*")
   end
 rescue LoadError
   puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
@@ -89,6 +94,8 @@ end
 
 task :release => :commit_revision
 
+task :gem => :build
+
 desc "Compile Examples into HTML and CSS"
 task :examples do
   linked_haml = "tests/haml"
@@ -105,6 +112,10 @@ task :examples do
     next unless File.directory?(example)
     puts "\nCompiling #{example}"
     puts "=" * "Compiling #{example}".length
+    Dir.chdir example do
+      load "bootstrap.rb" if File.exists?("bootstrap.rb")
+      Compass::Exec::SwitchUI.new(["--force"]).run!
+    end
     # compile any haml templates to html
     FileList["#{example}/**/*.haml"].each do |haml_file|
       basename = haml_file[0..-6]
@@ -114,9 +125,6 @@ task :examples do
       output.write(engine.render)
       output.close
     end
-    Dir.chdir example do
-      Compass::Exec::Compass.new(["--force"]).run!
-    end
   end
 end
 
@@ -125,3 +133,34 @@ namespace :git do
     sh "git", "clean", "-fdx"
   end
 end
+
+require 'cucumber/rake/task'
+
+namespace :rcov do
+  Cucumber::Rake::Task.new(:cucumber) do |t|    
+    t.rcov = true
+    t.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/ --aggregate coverage.data}
+    t.rcov_opts << %[-o "coverage"]
+  end
+  
+  Rcov::RcovTask.new(:units) do |rcov|
+    rcov.libs << 'lib'
+    rcov.libs << 'haml/lib' if ENV["RUN_CODE_RUN"]
+    test_files = FileList['test/**/*_test.rb']
+    test_files.exclude('test/rails/*', 'test/haml/*')
+    rcov.pattern    = test_files
+    rcov.output_dir = 'coverage'
+    rcov.verbose    = true
+    rcov.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/ --aggregate coverage.data}
+    rcov.rcov_opts << %[-o "coverage" --sort coverage]
+  end
+  
+  
+  desc "Run both specs and features to generate aggregated coverage"
+  task :all do |t|
+    rm "coverage.data" if File.exist?("coverage.data")
+    Rake::Task["rcov:units"].invoke
+    Rake::Task["rcov:cucumber"].invoke
+  end
+end
+

data/VERSION.yml

@@ -1,4 +1,5 @@
 --- 
-:patch: 17
+:patch: 0
 :major: 0
-:minor: 8
+:minor: 10
+:build: pre1

data/bin/compass

@@ -1,8 +1,26 @@
 #!/usr/bin/env ruby
 # The compass command line utility
 
-require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'compass'))
-require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'compass', 'exec'))
+# This allows compass to run easily from a git checkout without install.
+def fallback_load_path(path)
+  retried = false
+  begin
+    yield
+  rescue LoadError
+    unless retried
+      $: << path
+      retried = true
+      retry
+    end
+    raise
+  end
+end
 
-command = Compass::Exec::Compass.new(ARGV)
-exit command.run!
+fallback_load_path(File.join(File.dirname(__FILE__), '..', 'lib')) do
+  require 'compass'
+  require 'compass/exec'
+end
+
+
+command_line_class = Compass::Exec::Helpers.select_appropriate_command_line_ui(ARGV)
+exit command_line_class.new(ARGV).run!

data/examples/blueprint_default/index.html.haml

@@ -32,7 +32,7 @@
             %a{ :href => "parts/grid.html" }
               Grid
           %td
-            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/modules/_grid.sass" }
+            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/_grid.sass" }
               grid.sass
           %td
             Tests classes provided by the grid module.
@@ -41,7 +41,7 @@
             %a{ :href => "parts/elements.html" }
               Typography
           %td
-            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/modules/_typography.sass" }
+            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/_typography.sass" }
               typography.sass
           %td
             Tests HTML elements which gets set in the typography module.
@@ -50,7 +50,7 @@
             %a{ :href => "parts/forms.html" }
               Forms
           %td
-            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/modules/_form.sass" }
+            %a{ :href => "../../frameworks/blueprint/stylesheets/blueprint/_form.sass" }
               form.sass
           %td
             Tests classes and default look provided by the form module.

data/examples/blueprint_default/parts/forms.html.haml

@@ -184,6 +184,8 @@
               %input#q.text{ :type => "text", :name => "q", :value => "Field with class .text" }
             .span-2.last
               %input.button{ :type => "submit", :value => "submit" }
+              / WTF This doesn't render correctly without some space.
+               
       %hr
       %p
         %a{ :href => "http://validator.w3.org/check?uri=referer" }

data/examples/blueprint_default/src/screen.sass

@@ -1,5 +1,5 @@
 @import blueprint.sass
-@import blueprint/modules/scaffolding.sass
+@import blueprint/scaffolding.sass
 @import compass/reset.sass
 
 +blueprint

data/examples/blueprint_plugins/index.html.haml

@@ -31,13 +31,13 @@
             %a{ :href => "plugins/fancy_type.html" }
               Fancy Type
           %td
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_grid.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_grid.sass" }
               grid.sass
             ,
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_typography.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_typography.sass" }
               typography.sass
             ,
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_fancy_type.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_fancy_type.sass" }
               fancy_type.sass
           %td
             A simple sample page, with common elements and fancy type.
@@ -46,7 +46,7 @@
             %a{ :href => "plugins/buttons.html" }
               Buttons
           %td
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_buttons.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_buttons.sass" }
               buttons.sass
           %td
             A simple page, showing links and buttons styled using the button plugin.
@@ -55,7 +55,7 @@
             %a{ :href => "plugins/link_icons.html" }
               Link Icons
           %td
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_link_icons.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_link_icons.sass" }
               link_icons.sass
           %td
             A simple page, showing links icons.
@@ -64,7 +64,7 @@
             %a{ :href => "plugins/rtl.html" }
               RTL
           %td
-            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/modules/_rtl.sass" }
+            %a{ :href => "http://github.com/chriseppstein/compass/blob/master/frameworks/blueprint/stylesheets/blueprint/_rtl.sass" }
               rtl.sass
           %td
             A simple page, showing a right-to-left grid layout.