buildr 1.4.16 → 1.4.17

data/addon/buildr/scss_lint.rb

@@ -0,0 +1,199 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+module Buildr
+  # Provides the <code>scss_lint:html</code> and <code>scss_lint:xml</code> tasks.
+  # Require explicitly using <code>require "buildr/scss_lint"</code>.
+  module ScssLint
+    class << self
+
+      def scss_lint(output_file, source_paths, options = {})
+        args = []
+        if ENV['BUNDLE_GEMFILE']
+          args << 'bundle'
+          args << 'exec'
+        end
+        args << 'scss-lint'
+        if options[:configuration_file]
+          args << '--config'
+          args << options[:configuration_file]
+        end
+        if options[:file_excludes]
+          args << '--exclude'
+          args << options[:file_excludes].join(',')
+        end
+        if options[:formatter]
+          args << '--format'
+          args << options[:formatter]
+        end
+        if options[:linter_includes] && !options[:linter_includes].empty?
+          args << '--include-linter'
+          args << options[:linter_includes].join(',')
+        end
+        if options[:linter_excludes] && !options[:linter_excludes].empty?
+          args << '--exclude-linter'
+          args << options[:linter_excludes].join(',')
+        end
+
+        source_paths.each do |source_path|
+          args << source_path
+        end
+
+        mkdir_p File.dirname(output_file)
+        File.open(output_file, 'wb') do |f|
+          f.write `#{args.join(' ')}`
+        end
+      end
+    end
+
+    class Config
+      def enabled?
+        File.exist?(self.configuration_file)
+      end
+
+      def html_enabled?
+        File.exist?(self.style_file)
+      end
+
+      attr_writer :config_directory
+
+      def config_directory
+        @config_directory || project._(:source, :main, :etc, :scss_lint)
+      end
+
+      attr_writer :report_dir
+
+      def report_dir
+        @report_dir || project._(:reports, :scss_lint)
+      end
+
+      attr_writer :file_excludes
+
+      def file_excludes
+        @file_excludes ||= []
+      end
+
+      attr_writer :linter_includes
+
+      def linter_includes
+        @linter_includes ||= []
+      end
+
+      attr_writer :linter_excludes
+
+      def linter_excludes
+        @linter_excludes ||= []
+      end
+
+      attr_writer :configuration_file
+
+      def configuration_file
+        @configuration_file || "#{self.config_directory}/checks.yml"
+      end
+
+      attr_writer :format
+
+      def format
+        @format || 'XML'
+      end
+
+      attr_writer :xml_output_file
+
+      def xml_output_file
+        @xml_output_file || "#{self.report_dir}/scss_lint.xml"
+      end
+
+      attr_writer :html_output_file
+
+      def html_output_file
+        @html_output_file || "#{self.report_dir}/scss_lint.html"
+      end
+
+      attr_writer :style_file
+
+      def style_file
+        unless @style_file
+          project_xsl = "#{self.config_directory}/scss_lint-report.xsl"
+          if File.exist?(project_xsl)
+            @style_file = project_xsl
+          else
+            @style_file = "#{File.dirname(__FILE__)}/scss_lint-report.xsl"
+          end
+        end
+        @style_file
+      end
+
+      def source_paths
+        @source_paths ||= [self.project._(:source, :main, :webapp, :sass)]
+      end
+
+      protected
+
+      def initialize(project)
+        @project = project
+      end
+
+      attr_reader :project
+
+    end
+
+    module ProjectExtension
+      include Extension
+
+      def scss_lint
+        @scss_lint ||= Buildr::ScssLint::Config.new(project)
+      end
+
+      after_define do |project|
+        if project.scss_lint.enabled?
+          desc "Generate scss-lint xml report."
+          project.task("scss_lint:xml") do
+            source_paths = project.scss_lint.source_paths.flatten.compact
+            source_paths.each do |path|
+              path.respond_to?(:invoke) ? path.invoke : project.file(path).invoke
+            end
+            puts "ScssLint: Analyzing source code..."
+            Buildr::ScssLint.scss_lint(project.scss_lint.xml_output_file,
+                                       source_paths,
+                                       :formatter => project.scss_lint.format,
+                                       :configuration_file => project.scss_lint.configuration_file,
+                                       :file_excludes => project.scss_lint.file_excludes,
+                                       :linter_includes => project.scss_lint.linter_includes,
+                                       :linter_excludes => project.scss_lint.linter_excludes)
+          end
+
+          if project.scss_lint.html_enabled?
+            xml_task = project.task("scss_lint:xml")
+            desc "Generate scss_lint html report."
+            project.task("scss_lint:html" => xml_task) do
+              puts "ScssLint: Generating report"
+              mkdir_p File.dirname(project.scss_lint.html_output_file)
+              Buildr.ant "scss_lint" do |ant|
+                ant.xslt :in => project.scss_lint.xml_output_file,
+                         :out => project.scss_lint.html_output_file,
+                         :style => project.scss_lint.style_file
+              end
+            end
+
+          end
+        end
+      end
+    end
+  end
+end
+
+class Buildr::Project
+  include Buildr::ScssLint::ProjectExtension
+end

data/addon/buildr/wsgen.rb

@@ -114,6 +114,7 @@ module Buildr
       # Service options include:
       # * :service_name -- The name of the service.
       # * :package -- The package in which to generate the code.
+      # * :extension -- Should we allow non-portable extensions.
       #
       # Method options include:
       # * :output_dir -- The target directory.
@@ -153,6 +154,9 @@ module Buildr
             command << ws_dir
             command << "-p"
             command << pkg
+            if config[:extension]
+              command << "-extension"
+            end
             if wsdl_location
               command << "-wsdllocation"
               command << wsdl_location

data/doc/building.textile

@@ -130,7 +130,7 @@ You can also use "profiles":settings_profiles.html#profiles to supply a name/val
 filter: &alpha1
   version: experimental
   copyright: Acme Inc (C) 2007
-  
+
 development:
   filter: *alpha1
 test:
@@ -143,7 +143,7 @@ You can specify a different format by passing it as the first argument. Supporte
 | @:ant@    | Map from <code>@key@</code> to value. |
 | @:maven@  | Map from @${key}@ to value (default). |
 | @:ruby@   | Map from @#{key}@ to value. |
-| @:erb@    | Map from @<%=key%>@ to value. | 
+| @:erb@    | Map from @<%=key%>@ to value. |
 | @Regexp@  | Map using the matched value of the regular expression (e.g. @/=(.*?)=/@). |
 
 For example, using the @:ruby@ format instead of the default @:maven@ format:
@@ -234,7 +234,7 @@ The @build@ task has an evil twin, the @clean@ task.  It's the task you use to r
 
 It basically erases the target directories, the one called @target@, and if you get creative and change the target directory for tasks like @compile@, it will also erase those.  If you decide to generate files outside the target directory and want to cleanup after yourself, just extend the @clean@ task.
 
-For example: 
+For example:
 
 {% highlight ruby %}
 clean { rm_rf _('staged') }

data/doc/css/default.css

@@ -82,7 +82,7 @@ blockquote {
   font-style: italic;
 }
 
-ul { 
+ul {
   list-style-type: disc;
 }
 
@@ -153,7 +153,7 @@ th, thead td {
 #pages ol li {
   padding: 0.3em 0 0.6em 0em;
   color: #669966;
-  font-weight: bold; 
+  font-weight: bold;
 }
 #pages ol li ol {
   margin-top: 0.3em;
@@ -206,7 +206,7 @@ ol.toc li ol.toc {
 }
 #content p.tip { background: url("../images/tip.png") 0 0 no-repeat; }
 #content p.note { background: url("../images/note.png") 0 0 no-repeat; }
- 
+
 #content .footnote {
   margin-top: 2.5em;
 }

data/doc/css/print.css

@@ -64,7 +64,7 @@
     background: transparent;
     text-decoration: none;
   }
-  
+
 
   #header, #pages, #footer { display: none }
   #wrap, #content {

data/doc/download.textile

@@ -20,16 +20,28 @@ The source code is included in both source and binary distribution, the Gem dist
 
 h2(#dist).  Binaries and Source Code
 
+h3. buildr 1.4.16 (2014-05-03)
+
+|_. Package |_. MD5 Checksum |_. PGP |
+| "buildr-1.4.16-java.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.16/buildr-1.4.16-java.gem | "da920dd00f4b09f01aa0e5c71a8a87e5":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16-java.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16-java.gem.asc |
+| "buildr-1.4.16-x86-mswin32.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.16/buildr-1.4.16-x86-mswin32.gem | "10180c59e1b11da4d6f499fd3f0d43bb":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16-x86-mswin32.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16-x86-mswin32.gem.asc |
+| "buildr-1.4.16.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.16/buildr-1.4.16.gem | "cfc81dacdd825928a5e1a8b55735895b":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.gem.asc |
+| "buildr-1.4.16.tgz":http://www.apache.org/dyn/closer.cgi/buildr/1.4.16/buildr-1.4.16.tgz | "b3234fff8924589fe2826acecc7bc03e":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.tgz.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.tgz.asc |
+| "buildr-1.4.16.zip":http://www.apache.org/dyn/closer.cgi/buildr/1.4.16/buildr-1.4.16.zip | "a20af0a5046e84813561ae50ce58703c":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.zip.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.16/buildr-1.4.16.zip.asc |
+
+p>. ("Release signing keys":http://www.apache.org/dist/buildr/1.4.16/KEYS)
+
+
 h3. buildr 1.4.15 (2013-11-06)
 
 |_. Package |_. MD5 Checksum |_. PGP |
-| "buildr-1.4.15-java.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.15/buildr-1.4.15-java.gem | "5ea7f855a2e57340d840fea3ef635a44":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15-java.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15-java.gem.asc |
-| "buildr-1.4.15-x86-mswin32.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem | "e297b9a358ed2fe90afe0a67285c1236":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem.asc |
-| "buildr-1.4.15.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.15/buildr-1.4.15.gem | "d4052ac4aa739c63ab7ad08d80719a1a":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.gem.asc |
-| "buildr-1.4.15.tgz":http://www.apache.org/dyn/closer.cgi/buildr/1.4.15/buildr-1.4.15.tgz | "c80a6fee2d2cfe7de1a57821596444bd":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.tgz.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.tgz.asc |
-| "buildr-1.4.15.zip":http://www.apache.org/dyn/closer.cgi/buildr/1.4.15/buildr-1.4.15.zip | "0c63028d9965817b8d17ca49096974dc":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.zip.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.15/buildr-1.4.15.zip.asc |
+| "buildr-1.4.15-java.gem":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-java.gem | "5ea7f855a2e57340d840fea3ef635a44":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-java.gem.md5 | "Sig":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-java.gem.asc |
+| "buildr-1.4.15-x86-mswin32.gem":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem | "e297b9a358ed2fe90afe0a67285c1236":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem.md5 | "Sig":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15-x86-mswin32.gem.asc |
+| "buildr-1.4.15.gem":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.gem | "d4052ac4aa739c63ab7ad08d80719a1a":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.gem.md5 | "Sig":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.gem.asc |
+| "buildr-1.4.15.tgz":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.tgz | "c80a6fee2d2cfe7de1a57821596444bd":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.tgz.md5 | "Sig":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.tgz.asc |
+| "buildr-1.4.15.zip":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.zip | "0c63028d9965817b8d17ca49096974dc":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.zip.md5 | "Sig":http://archive.apache.org/dist/buildr/1.4.15/buildr-1.4.15.zip.asc |
 
-p>. ("Release signing keys":http://www.apache.org/dist/buildr/1.4.15/KEYS)
+p>. ("Release signing keys":http://archive.apache.org/dist/buildr/1.4.15/KEYS)
 
 
 h3. buildr 1.4.14 (2013-10-11)
@@ -268,4 +280,3 @@ p>. ("Release signing keys":http://archive.apache.org/dist/buildr/1.3.0-incubati
 
 
 p(note). When downloading from files please check the "md5sum":http://www.apache.org/dev/release-signing#md5 and verify the "OpenPGP":http://www.apache.org/dev/release-signing#openpgp compatible signature from the main Apache site. This KEYS file contains the public keys used for signing releases. It is recommended that (when possible) a web of trust is used to confirm the identity of these keys. For more information, please see the "Apache Release FAQ":http://www.apache.org/dev/release.html.
-

data/doc/index.textile

@@ -46,6 +46,14 @@ So let's get started.  You can "read the documentation online":quick_start.html,
 
 h2(#news).  What's New
 
+Highlights from Buildr 1.4.17 (2014-05-25)
+
+* Change: Supply a default xsl file for generating the checkstyle report.
+* Added:  Add csslint tasks css_lint:xml and css_lint:html that support source code analysis of CSS files.
+* Added:  Add scss_lint tasks scss_lint:xml and scss_lint:html that support source code analysis of SCSS files.
+* Added:  Import 'buildr/custom_pom' addon to make it easier to build POMs for projects publishing to Maven Central.
+* Added:  Add flag to allow non portable extensions in wsgen addon.
+
 Highlights from Buildr 1.4.16 (2014-05-03)
 
 * Added:  Add the ability to generate a html report when using the
@@ -75,4 +83,3 @@ The Apache Software Foundation is a non-profit organization, consider "sponsorin
 Community member quotes from a thread on "Stack Overflow":http://stackoverflow.com/questions/1015525/why-use-buildr-instead-of-ant-or-maven/1055864.
 
 Developed with !http://www.jetbrains.com/ruby/features/ruby_banners/ruby1/ruby120x30_white.gif(Developed with RubyMine)!:http://www.jetbrains.com/ruby/features?utm_source=RubyMineUser&utm_medium=Banner&utm_campaign=RubyMine
-

data/doc/installing.textile

@@ -11,11 +11,11 @@ The RubyForge distribution is *not* an official Apache distribution. The all-in-
 
 *In details:* Navigate to "Rubyforge's buildr's Files page":http://rubyforge.org/frs/?group_id=3180 and download the all-in-one bundle for the latest version available.
 
-Unzip the bundle in a convenient location. 
+Unzip the bundle in a convenient location.
 
-You can execute the buildr executable under the bin directory directly. 
+You can execute the buildr executable under the bin directory directly.
 
-You should consider adding the bin directory of the result to the @PATH@ global environment variable. See "Installing Buildr for JRuby":#jruby for instructions to update it.  
+You should consider adding the bin directory of the result to the @PATH@ global environment variable. See "Installing Buildr for JRuby":#jruby for instructions to update it.
 
 h1(#the-gem). Installing the gem
 

data/doc/languages.textile

@@ -617,4 +617,3 @@ Supports the following options:
 | @:fork@         | Run the tests on a new java vm. (enabled unless running on JRuby) |
 | @:properties@   | Hash of system properties available to the test case. |
 | @:java_args@    | Arguments passed as is to the JVM. (only when fork is enabled) |
-

data/doc/mailing_lists.textile

@@ -23,7 +23,3 @@ title: Mailing Lists
 | Search        | "http://buildr.markmail.org/search/list:ci":http://buildr.markmail.org/search/list:ci |
 | Subscribe     | "ci-subscribe@buildr.apache.org":mailto:ci-subscribe@buildr.apache.org |
 | Unsubscribe   | "ci-unsubscribe@buildr.apache.org":mailto:ci-unsubscribe@buildr.apache.org |
-
-
-
-

data/doc/more_stuff.textile

@@ -391,6 +391,78 @@ $ buildr --generate /path/to/my_project
 
 This creates a basic buildfile with a main project called 'my_project'. The buildfile contains a skeleton for compiling the Eclipse projects. If you want to automate dependency tracking via OSGi have a look at the "buildr4osgi":http://oss.intalio.com/buildr4osgi/ project. Support for building Eclipse RCP applications, running PDE tests and P2-sites is currently lacking in Buildr.
 
+h2(#maven_central). Releasing to Maven Central
+
+Many opensource projects release their artifacts to Maven Central. To release a library to Maven Central, the project needs to provide several elements for each library;
+
+* the jar artifact,
+* the sources artifact,
+* the javadocs artifact,
+* a pom that supplies fields required by Maven Central, and
+* gpg signatures for every file supplied.
+
+Buildr has built-in support for the artifacts and can easily sign the artifacts using the 'buildr/gpg' addon. However it has not always been easy to generate a pom in the required format until the 'buildr/custom_pom' became available.
+
+Below is an extremely verbose example of a project that provides all the elements required to publish to Maven Central.
+
+{% highlight sh %}
+# Include addon to generate GPG Signatures
+require 'buildr/gpg'
+# Include addon to generate custom pom
+require 'buildr/custom_pom'
+
+define 'myproject' do
+  project.group = 'org.myproject'
+  project.version = '1.0'
+
+  pom.licenses['The Apache Software License, Version 2.0'] = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+  pom.scm_connection = pom.scm_developer_connection = 'scm:git:git@github.com:jbloggs/myproject'
+  pom.scm_url = 'git@github.com:jbloggs/myproject'
+  pom.url = 'https://github.com/jbloggs/myproject'
+  pom.issues_url = 'https://github.com/jbloggs/myproject/issues'
+  pom.issues_system = 'GitHub Issues'
+  pom.add_developer('jbloggs', 'Joe Bloggs', 'jbloggs@example.com', ['Project Lead'])
+  pom.provided_dependencies.concat [:javax_servlet]
+  pom.optional_dependencies.concat [:optional_api]
+
+  compile.with :javax_servlet, :some_api, :optional_api
+
+  test.with :mockito
+
+  package(:jar)
+  package(:sources)
+  package(:javadoc)
+end
+{% endhighlight %}
+
+That example is however, extremely verbose and there is a number of helper methods been added to the 'buildr/custom_pom' addon to simplify common scenarios. It would be more common to see the addon used in the following manner;
+
+{% highlight sh %}
+require 'buildr/gpg'
+require 'buildr/custom_pom'
+
+define 'myproject' do
+  project.group = 'org.myproject'
+  project.version = '1.0'
+
+  pom.add_apache2_license
+  pom.add_github_project('jbloggs/myproject')
+  pom.add_developer('jbloggs', 'Joe Bloggs')
+  pom.provided_dependencies.concat [:javax_servlet]
+  pom.optional_dependencies.concat [:optional_api]
+
+  compile.with :javax_servlet, :optional_api
+
+  test.with :mockito
+
+  package(:jar)
+  package(:sources)
+  package(:javadoc)
+end
+{% endhighlight %}
+
+If there are other common scenarios useful for opensource developers, feel free to make a request on buildr mailing list to provide simplified helper methods.
+
 h2(#idea). IntelliJ IDEA
 
 If you use IntelliJ IDEA, you can generate project files by issuing:
@@ -812,7 +884,7 @@ $ buildr -rbuildr/java/cobertura cobertura:html
 
 h2(#checkstyle). Checkstyle
 
-Checkstyle is integrated into Buildr through an extension. The extension adds the "checkstyle:xml" task that generates an xml report listing checkstyle violations and may add a "checkstyle:html" task if an appropriate xsl is present. A typical project that uses the extension may look something like;
+Checkstyle is integrated into Buildr through an extension. The extension adds the "checkstyle:xml" task that generates an xml report listing checkstyle violations and a "checkstyle:html" task to generate the html variant. A typical project that uses the extension may look something like;
 
 {% highlight ruby %}
 require 'buildr/checkstyle'
@@ -833,7 +905,7 @@ By default checkstyle will look for all configuration files in the src/main/etc/
 
 The extension will include the source and test directories of the project aswell as the compile and test dependencies when invoking the checkstyle tool. These can be added to by the parameters "checkstyle.source_paths" and "checkstyle.extra_dependencies" as appropriate.
 
-If the xsl file named "checkstyle-report.xsl" is present in the configuration directory then a "checkstyle:html" task will be defined. The name of the xsl file can be overridden by the parameter "checkstyle.style_file".
+If the xsl file named "checkstyle-report.xsl" is present in the configuration directory then it will be used to generate the html report, otherwise a xsl file that comes with buildr will be used. The name of the xsl file can be overridden by the parameter "checkstyle.style_file".
 
 h2(#findbugs). FindBugs
 
@@ -987,6 +1059,59 @@ The method compile_jaxb accepts either an array of files or a single file as the
 * <tt>:keep_content</tt>: By default the generated directory will be deleted. If <tt>true</tt> is specified for this parameter the directory will not be deleted.
 * <tt>:package</tt>: The package in which the source is generated.
 
+h2(#css_lint). CssLint
+
+"CssLint":https://github.com/CSSLint/csslint is integrated into Buildr through an extension. The extension adds the "css_lint:xml" task to generate an xml report listing css lint violations and a "css_lint:html" task for a html variant of the same data. It is expected that a project that makes use of css linting will have installed the csslint using node. A typical project that uses the extension may look something like;
+
+{% highlight ruby %}
+require 'buildr/css_lint'
+
+define "foo" do
+  project.version = "1.0.0"
+
+  define "bar" do ... end
+
+  css_lint.source_paths.concat([some_generated_dir])
+  css_lint.ignore.concat(%w(box-sizing font-sizes adjoining-classes))
+end
+{% endhighlight %}
+
+By default css_lint will look for the xsl file in the src/main/etc/css_lint directory but this can be overriden by the setting the "css_lint.config_directory" parameter. The "css_lint:xml" task will be defined if the source_paths is not empty. The rules can be passed to the task using the 'ignores', 'errors' and 'warnings' parameters.
+
+The extension will lint the css files in the "_(:source, :main, :webapp, :css)" directory by default. The set of source directories linted can be controlled by the "css_lint.source_paths" parameter.
+
+If the xsl file named "css_lint-report.xsl" is present in the configuration directory then that will be used in the "css_lint:html" task otherwise a default xsl included with buildr will be used. The name of the xsl file can be overridden by the parameter "css_lint.style_file".
+
+h2(#scss_lint). ScssLint
+
+"ScssLint":https://github.com/causes/scss-lint is integrated into Buildr through an extension. The extension adds the "scss_lint:xml" task to generate an xml report listing scss lint violations and a "scss_lint:html" task for a html variant of the same data. A buildr project that makes uses of the extension is expected to have added 'scss_lint' gem to the projects Gemfile by adding a line such as;
+
+{% highlight ruby %}
+gem 'scss-lint', '= 0.24.0'
+{% endhighlight %}
+
+A typical project that uses the extension may look something like;
+
+{% highlight ruby %}
+require 'buildr/scss_lint'
+
+define "foo" do
+  project.version = "1.0.0"
+
+  define "bar" do ... end
+
+  scss_lint.configuration_file = _('etc/scss_lint/checks.yml')
+  scss_lint.source_paths << project('web')._(:source, :main, :webapp, 'sass')
+  scss_lint.file_excludes = FileList["#{project('web')._(:source, :main, :webapp, 'sass')}/vendor/**/*"]
+end
+{% endhighlight %}
+
+By default scss_lint will look for all configuration files in the src/main/etc/scss_lint directory but this can be overriden by the setting the "scss_lint.config_directory" parameter. The "scss_lint:xml" task will be defined if the scss_lint rules file is found. The rules file is named "checks.yml" by default but can be overridden by setting the "scss_lint.configuration_file" parameter.
+
+The extension will lint the sass files in the "_(:source, :main, :webapp, :sass)" directory by default. The set of source directories linted can be controlled by the "scss_lint.source_paths" parameter.
+
+If the xsl file named "scss_lint-report.xsl" is present in the configuration directory then that will be used in the "scss_lint:html" task otherwise a default xsl included with buildr will be used. The name of the xsl file can be overridden by the parameter "scss_lint.style_file".
+
 h2(#anything_ruby). Anything Ruby Can Do
 
 Buildr is Ruby code.  That's an implementation detail for some, but a useful features for others.  You can use Ruby to keep your build scripts simple and DRY, tackle ad hoc tasks and write reusable features without the complexity of "plugins".
@@ -1041,4 +1166,3 @@ puts "There are #{source.size} source files"
 lines = sources.inject(0) { |lines, src| lines += File.readlines(src).size }
 puts "That contain #{lines} lines"
 {% endhighlight %}
-