execcsslint 12.03.19

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012, Mint Digital, Daniel Holz
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,68 @@
+ExecCSSLint
+==========
+
+ExecCSSLint is a thin Ruby wrapper that uses ExecJS to execute [csslint]. It is heavily inspired by Dean Strelau's [https://github.com/mintdigital/execjslint][ExecJSLint].
+
+Install
+-------
+
+```
+$ gem install execcsslint
+```
+
+Usage
+-----
+
+```ruby
+js = File.open('path/to/my.js')
+results = csslint.run(js)
+if result.valid?
+  puts "Great job pal"
+else
+  puts "Check your CSS"
+  puts result.errors
+end
+```
+
+If you're looking to use this in a Rails app, take a look at
+[examples/csslint.rake][rake].
+
+Requirements
+------------
+
+You'll need one of the [supported ExecJS runtimes][execjs-runtimes]. OS X
+comes with JavaScriptCore by default, so you likely don't need to install
+anything.
+
+csslint Options
+--------------
+
+Right now, `ExecCSSLint` does not support setting global csslint options, so you'll
+have to include them in a `/*csslint */` comment at the top of each file.
+`csslint.js` will automatically parse and apply options specified like this. A
+full list of options is available on [csslint.net][csslint-options].
+
+Using an Alternate csslint.js
+----------------------------
+
+ExecCSSLint depends on the `csslint-source` gem, which is a ruby packaging
+of the official [csslint.js][csslintjs]. By default, ExecCSSLint depends on the
+latest version of the `csslint-source` gem. As there are no official releases
+of csslint, `csslint-source` is versioned according to [the date at the top of
+csslint.js][csslint-date] (eg, `2012.03.16`). rubygems.org has a [full list of
+`csslint-source` gem versions][source-versions].
+
+To override this, you can specify an explicit dependency on `csslint-source`,
+for example, using bundler:
+
+```
+gem 'execcsslint'
+gem 'csslint-source', '2012.03.17'
+```
+
+You can also explicitly specify a local copy of `csslint.js` to use by setting
+the `CSSLINT_PATH` env variable.
+
+```
+$ CSSLINT_PATH=../lib/csslint.js rake csslint
+```

data/lib/csslint.rb

@@ -0,0 +1,82 @@
+require 'execjs'
+require 'csslint/source'
+
+module CSSLint
+  # Internal: The ExecJS Context in which to run csslint().
+  #
+  # Provides a small helper function CSSLINTR to return both the CSSLint()
+  # return value and the CSSLint messages
+  def self.context
+    ExecJS.compile(
+      CSSLint::Source.contents + <<-EOW
+
+function gatherRules(options){
+    var ruleset,
+        warnings = options.rules || options.warnings,
+        errors = options.errors;
+    
+    if (warnings){
+        ruleset = ruleset || {};
+        for( var _i = 0, _len = warnings.length; _i < _len; _i++ ) {
+            ruleset[warnings[_i]] = 1;
+        };
+    }
+    
+    if (errors){
+        ruleset = ruleset || {};
+        for( var _i = 0, _len = errors.length; _i < _len; _i++ ) {
+            ruleset[errors[_i]] = 2;
+        };
+    }
+    
+    return ruleset;
+}
+
+function CSSLINTR(source, options) {
+    var result    = CSSLint.verify( source, gatherRules( options ) );
+    var messages  = result.messages || [];
+    return [ messages ];
+};
+      EOW
+    )
+  end
+
+  # Public: Run CSSLint over some CSS text
+  #
+  # source - some String-like or IO-like CSS text
+  # options - Hash of options passed directly to csslint (default: {})
+  def self.run(source, options={})
+    source   = source.respond_to?(:read) ? source.read : source
+    if source.respond_to?(:path)
+      options[:fullPath] = File.expand_path( source.path )
+      options[:filename] =                   source.path
+    end
+    Result.new(*context.call("CSSLINTR", source, options))
+  end
+
+  class Result
+    def initialize(messages)
+      @messages = messages
+    end
+
+    # Public: Did the CSS text pass CSSLint without messages?
+    #
+    # This is the return value of the CSSLint() function.
+    #
+    # Returns true iff CSSLint returned no error messages.
+    def valid?
+      @messages.select { |m| m['type'] == 'error' }.length == 0
+    end
+
+    # Public: A nicely formatted list of messages with their line number.
+    #
+    # Returns an Array of Strings.
+    def error_messages
+      # @messages may have a 'nil' as the last element if there was a catastrophic
+      # error, so we 'compact'.
+      @messages.compact.map {|e|
+        "#{e['line']}:#{e['col']}: [#{ e['type'] }] #{e['message']}#{ e['evidence'] and " (#{ e['evidence'] })"}"
+      }
+    end
+  end
+end

data/lib/csslint/testtask.rb

@@ -0,0 +1,61 @@
+require 'rake'
+require 'csslint'
+
+module CSSLint
+  class TestTask
+    include Rake::DSL
+
+    # Public: Gets/Sets the Array of JavaScript filenames as Strings, each of
+    # which will be run through csslint. (default: Dir['**/*.css'])
+    attr_accessor :file_list
+
+    # Public: Gets/Sets the Hash of options that will be passed to each call
+    # of csslint. See http://www.csslint.com/lint.html for allowed options.
+    # (default: {})
+    attr_accessor :options
+
+    # Public: Define a new Rake task that runs CSSLint tests over several
+    # JavaScript files.
+    #
+    # name - the name of the defined Rake Task. (default: 'csslint')
+    #
+    # Yields itself for configuration if a block is given.
+    def initialize(name=:csslint)
+      @name = name
+      @file_list = Dir['**/*.css']
+      @options   = {}
+      yield self if block_given?
+
+      define_task
+    end
+
+    # Internal: Define the actual Rake task.
+    def define_task
+      desc "Run #{@name == :csslint ? '' : @name + ' '}CSSLint tests"
+      task @name do
+        t0 = Time.now
+        errors = []
+
+        @file_list.each do |f|
+          result = CSSLint.run(File.open(f), @options )
+          if result.valid?
+            print '.'
+          else
+            errors << result.error_messages.map {|e| "#{f}:#{e}"}
+            print 'F'
+          end
+        end
+
+        puts
+        puts
+        if errors.any?
+          puts *errors
+          puts
+        end
+        puts "Finished in %.5f seconds" % [Time.now.to_f - t0.to_f]
+        puts "%d files, %d errors"      % [@file_list.length, errors.length]
+      end
+    end
+
+  end
+end

data/lib/execcsslint.rb

@@ -0,0 +1 @@
+require 'csslint'

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: execcsslint
+version: !ruby/object:Gem::Version
+  version: 12.03.19
+  prerelease: 
+platform: ruby
+authors:
+- Dean Strelau
+- Daniel Holz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &21734580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :runtime
+  prerelease: false
+  version_requirements: *21734580
+- !ruby/object:Gem::Dependency
+  name: csslint-source
+  requirement: &21733944 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *21733944
+- !ruby/object:Gem::Dependency
+  name: execjs
+  requirement: &21733356 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *21733356
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &21732396 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *21732396
+description: ! '    A bridge to run CSSLint from Ruby via ExecJS.
+
+'
+email: dgholz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/execcsslint.rb
+- lib/csslint.rb
+- lib/csslint/testtask.rb
+- LICENSE
+- README.md
+homepage: http://github.com/dgholz/execcsslint
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: ExecJS CSSLint Bridge
+test_files: []