lesstidy 0.0.1.pre

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+doc
+.rvmrc

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Rico Sta. Cruz
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,60 @@
+Lesstidy
+========
+
+A CSS tidying tool.
+
+Installation (for text editors)
+-------------------------------
+
+ - For VIM users, install `lesstidy-vim`.
+ - For Textmate users, install `lesstidy
+
+Installation (command line)
+---------------------------
+
+To use the `lesstidy` command, type `gem install lesstidy --pre`.
+
+Usage
+-----
+
+General usage is `lesstidy <input> [<output>]`.
+
+Type `lesstidy --help` for tweaks.
+
+.lesstidyopts file
+------------------
+
+Want to impose a LessTidy options standard to your project? Put a file called 
+`.lesstidyopts` in your project's folder. Whenever lesstidy is used without
+any style options, it finds this file (relative to the current directory).
+Put each option in it's own line.
+
+Example:
+
+    # .lesstidyopts
+    --preset=column
+    --wrap-width=140
+
+Even the text editor plugins (vim, textmate, etc) will refer to this file.
+
+Examples
+--------
+
+    lesstidy --preset=compact input.css
+
+To do
+-----
+
+ - More types
+   - Mixin declarations
+   - Var declarations
+   - import lines
+ - .lesstidyopts
+
+Done:
+
+ - Presets
+ - bin/lesstidy
+ - blackbox testing
+ - Comments
+ - recursive wrapping

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "lesstidy"
+    gem.summary = "CSS formatting tool"
+    gem.description = "LessTidy takes your CSS (or LessCSS) file and rewrites it in a more readable format."
+    gem.email = "rico@sinefunc.com"
+    gem.homepage = "http://github.com/rstacruz/lesstidy"
+    gem.authors = ["Rico Sta. Cruz", "Sinefunc, Inc."]
+    gem.add_dependency "treetop"
+    gem.add_development_dependency "contest"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "lesstidy #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1.pre

data/bin/lesstidy

@@ -0,0 +1,101 @@
+#!/usr/bin/env ruby
+lib_path = File.dirname(__FILE__) + "/../lib"
+$:.unshift lib_path
+
+require 'optparse'
+require 'rubygems'
+require 'lesstidy'
+require 'ostruct'
+
+options = OpenStruct.new({
+  :input  => '-',
+  :output => '-',
+  :debug  => false,
+  :style  => Hash.new
+})
+
+opts = OptionParser.new do |o|
+  o.banner = "usage: lesstidy [<input>]"
+  o.separator ""
+
+  o.on("-d", "--debug", "show debug info instead") do
+    options.debug = true
+  end
+  
+  o.on('-o', '--output FILE', 'output file') do |file|
+    options.output = file
+  end
+
+  # Help
+  o.on("-h", "--help", "show this message") do
+    puts opts
+    exit
+  end
+
+  Lesstidy::StyleParser.parse o, options.style
+
+  o.separator ""
+  o.separator "Available presets:"
+  Lesstidy::StyleParser.presets.each do |preset|
+    o.separator("        --preset=#{preset}")
+  end
+end
+
+begin
+  opts.parse!
+rescue OptionParser::InvalidOption
+  puts opts
+  exit
+end
+
+if ARGV.size == 1
+  options.input = ARGV[0]
+elsif ARGV.size > 1
+  puts opts
+  exit
+end
+
+begin
+  input = options.input == '-' ? STDIN : File.open(options.input, "r")
+rescue Errno::ENOENT
+  STDERR << "Can't open input file for reading"
+  exit
+end
+
+begin
+  output = options.output == '-' ? STDOUT : File.open(options.output, "w")
+rescue Errno::ENOENT
+  STDERR << "Can't open output file for reading"
+  exit
+end
+
+if options.style == {}
+  options.style = Lesstidy::StyleParser.defaults
+end
+
+contents = input.read
+wrapper = {
+  :pre =>  /^[ \n\t]*/.match(contents).to_s,
+  :post => /[ \n\t]*$/.match(contents).to_s
+}
+
+begin
+  style = Lesstidy::Style.new(options.style)
+  doc = Lesstidy::Document.new(contents)
+
+  if options.debug
+    output << doc.inspect.strip
+  else
+    output << wrapper[:pre] << doc.to_css(style).strip << wrapper[:post] << "\n\n"
+  end
+
+rescue Lesstidy::ParseError => e
+  output << "/* Parse error: #{e.message} */\n"
+  output << contents
+end
+
+
+input.close
+output.close
+
+

data/data/presets/column

@@ -0,0 +1,9 @@
+--selector-width=19
+--subrule-indent=2
+--open-brace-spaces=s|s
+--close-brace-spaces=|n
+--semicolon-spaces=|s
+--colon-spaces=|s
+--no-selector-wrap
+--wrap-width=120
+--property-indent=3

data/data/presets/terse

@@ -0,0 +1,5 @@
+--open-brace-spaces=s|s
+--close-brace-spaces=|n
+--no-wrap
+--no-selector-wrap
+--semicolon-spaces=|s

data/data/presets/wide-column

@@ -0,0 +1,3 @@
+--preset=column
+--selector-width=40
+--wrap-width=400

data/lib/lesstidy.rb

@@ -0,0 +1,20 @@
+require "treetop"
+
+module Lesstidy
+  prefix = File.join(File.dirname(__FILE__), 'lesstidy')
+
+  Treetop.load "#{prefix}/grammar/less.treetop"
+
+  autoload :Nodes,       "#{prefix}/nodes"
+  autoload :Renderer,    "#{prefix}/renderer"
+  autoload :Document,    "#{prefix}/document"
+  autoload :Style,       "#{prefix}/style"
+  autoload :CUtil,       "#{prefix}/cutil"
+  autoload :Preset,      "#{prefix}/preset"
+  autoload :Config,      "#{prefix}/config"
+  autoload :StyleParser, "#{prefix}/style_parser"
+
+  Error = Class.new(::StandardError)
+  PresetNotFoundError = Class.new(Error)
+  ParseError          = Class.new(Error)
+end

data/lib/lesstidy/config.rb

@@ -0,0 +1,33 @@
+module Lesstidy
+  class Config
+    class << self
+      NoRootError = Class.new(Exception)
+
+      def paths
+        r = []
+        begin
+          r << find_project_root
+        rescue NoRootError; end
+        r
+      end
+
+      def find_project_root(start = Dir.pwd)
+        check = File.expand_path(start)
+        ret = nil
+        while ret.nil?
+          # See if any of these files exist
+          ['.lesstidy'].each do |config_name|
+            config_file = File.join(check, config_name)
+            ret ||= [check, config_file]  if File.directory? config_file
+          end
+
+          # Traverse back (die if we reach the root)
+          old_check = check
+          check = File.expand_path(File.join(check, '..'))
+          raise NoRootError  if check == old_check
+        end
+        ret
+      end
+    end
+  end
+end

data/lib/lesstidy/cutil.rb

@@ -0,0 +1,73 @@
+module CUtil
+  class String < ::String
+    def prepend!(str)
+      self.replace(str + self)
+    end
+
+    def append!(str)
+      self << str
+    end
+
+    def wrap!(args = {})
+      temp = self.wrap(args)
+      self.replace(temp)
+      #self.replace(self.wrap(*args))
+    end
+
+    def lasplit(regex)
+      a = []
+      split(regex).each_slice(2) { |i| a << i.join('') }
+      a
+    end
+
+    def wrap(args = {})
+      # Inherit the given hashes
+      options = args
+      options[:regexp] ||= /([;,])/
+      options[:indent] ||= 0
+      options[:first_indent] ||= options[:indent]
+
+      width = options[:width]
+
+      first_indent = options[:first_indent]
+      indent = ''
+      indent = ' ' * options[:indent]  if options[:indent]
+
+      ret = self.lasplit(options[:regexp]).inject(['']) do |a, chunk|
+        nl = a[-1] + chunk
+
+        line_width = first_indent ? (width - first_indent) : width
+        if nl.rstrip.size > line_width
+          # To wrap...
+          new_chunk = (indent + chunk.lstrip)
+          if a == ['']
+            a = [new_chunk]
+          else
+            a << new_chunk
+          end
+
+          first_indent = false
+
+          # If the new line exceeds the line width, rewrap!
+          if a[-1].size > width and not options[:no_rewrap]
+            a[-1] = String.new(a[-1])  unless a[-1].is_a? String
+            wrapped = [a[-1]]
+            wrapped = a[-1].wrap(args.merge({ :regexp => /( +)/, :no_rewrap => true, :array => true, :pad => false }))
+            a = a[0..-2]
+            a << wrapped  if wrapped.size > 0
+          end
+        else
+          a[-1] = nl
+        end
+        a
+      end
+
+      # Pad the last line with spaces
+      ret[-1] = ret[-1] + (" " * [width - ret[-1].size, 0].max)  if options[:pad]
+
+      # Stringify if needed
+      options[:array] ? ret : ret.join("\n")
+    end
+  end
+end
+

data/lib/lesstidy/document.rb

@@ -0,0 +1,20 @@
+module Lesstidy
+  class Document < Lesstidy::Nodes::Document
+    def initialize(str)
+      super
+      parser = LessParser.new
+      tree = parser.parse(str)
+
+      if tree
+        tree.build self
+      else
+        raise Lesstidy::ParseError, parser.failure_message
+      end
+    end
+    
+    def self.load(filename)
+      str = File.open(filename) { |f| f.read }
+      return self.new(str)
+    end
+  end
+end

data/lib/lesstidy/grammar/less.treetop

@@ -0,0 +1,117 @@
+require File.dirname(__FILE__) + "/less_syntax.rb"
+
+# Document
+#  Import
+#  Variable
+#  Comment
+#  Ruleset
+#    Selector
+#    Mixin
+#    Stylerule (prop/val)
+
+module Lesstidy
+  grammar Less
+    rule document
+      ws document_item* ws {
+        def build(env = nil)
+          env ||= Lesstidy::Nodes::Document.new
+          cascade env
+        end
+      }
+    end
+  
+    rule document_item
+      block_comment {
+        def build(env)
+          env << Lesstidy::Nodes::Comment.new(comment.text_value)
+        end
+      } /
+      ruleset
+    end
+  
+    rule ruleset
+      ws selector_group ws '{' rule_group ws '}' {
+        def build( env )
+          ruleset = Lesstidy::Nodes::Ruleset.new
+          env << ruleset
+          cascade ruleset
+        end
+      }
+    end
+  
+    # Anything inside a `#selector { ... }`
+    rule rule_group
+      rule_group_item*
+    end
+  
+    rule rule_group_item
+      ruleset /
+      stylerule {
+        def build( ruleset )
+          rule = Lesstidy::Nodes::Rule.new property.text_value, value.text_value
+          ruleset << rule
+        end
+      } /
+      mixin {
+      } /
+      block_comment {
+        def build(ruleset)
+          ruleset << Lesstidy::Nodes::Comment.new(comment.text_value)
+        end
+      }
+    end
+  
+    rule selector_group
+      selector ( ws ',' ws selector )*
+    end
+  
+    rule selector
+      ( [A-Za-z0-9] / ':' / '>' / '*' / '(' / ')' / '[' / ']' / '-' / '_' / '#' / '.' / [\n\t ]+ / '&' )+ {
+        def build(ruleset)
+          sel = Lesstidy::Nodes::Selector.new self.text_value.strip
+          ruleset << sel
+        end
+      }
+    end
+  
+    rule mixin
+      ws name:('.' [a-zA-Z0-9_\-]+) '(' params:(value_string) ')' ws ';' {
+        def build(ruleset)
+          mixin = Lesstidy::Nodes::Mixin.new name.text_value, params.text_value
+          ruleset << mixin
+        end
+      } /
+      ws name:('.' [a-zA-Z0-9_\-]*) ws ';' {
+        def build(ruleset)
+          mixin = Lesstidy::Nodes::Mixin.new name.text_value
+          ruleset << mixin
+        end
+      }
+    end
+  
+    rule stylerule
+      ws property ws ':' ws value ws ';'
+    end
+  
+    rule property
+      '-'? [A-Za-z]+ ( '-' [A-Za-z]* )*
+    end
+  
+    rule value
+      (!';' . )*
+    end
+    
+    # TODO: Add balancing of ()'s
+    rule value_string
+      [a-zA-Z0-9 \[\]\*\<\>\.,\#_\-@]*
+    end
+  
+    rule block_comment
+      [\n\t ]* '/*' ' '* comment:(!(' '* '*/') . )* ' '* '*/'
+    end
+  
+    rule ws
+      [\n\t ]*
+    end
+  end
+end