css_compare 0.1.0

data/lib/css_compare/css/parser.rb

@@ -0,0 +1,28 @@
+require 'sass'
+
+module CssCompare
+  module CSS
+    class Parser
+      # @param [File]
+      def initialize(input)
+        @input = File.expand_path(input)
+      end
+
+      # Parses a CSS project using the Sass parser
+      #
+      # @note The specified syntax is `:scss` because
+      #   `:css` has been throwing syntax error on
+      #   @charset directive.
+      #
+      # @return [::Sass::Tree::RootNode]
+      def parse
+        tree = ::Sass::Engine.new(
+          File.read(@input),
+          :syntax => :scss, :filename => File.expand_path(@input)
+        ).to_tree
+        ::Sass::Tree::Visitors::CheckNesting.visit(tree)
+        ::Sass::Tree::Visitors::Perform.visit(tree)
+      end
+    end
+  end
+end

data/lib/css_compare/engine.rb

@@ -0,0 +1,31 @@
+require 'css_compare/css'
+
+module CssCompare
+  # The engine responsible for the CSS comparison
+  class Engine
+    def initialize(options)
+      @options = options
+      @operands = []
+    end
+
+    # Parses and evaluates the input CSS stylesheets - the operands.
+    #
+    # @return [Engine] itself for method chaining purposes
+    def parse!
+      @options[:operands].each { |operand| @operands << CSS::Engine.new(operand).evaluate }
+      self
+    end
+
+    # Checks, whether the parsed CSS files are equal.
+    #
+    # The CSS files are equal, if they define the same
+    # components, that are also equal and at the same
+    # time, no component is missing from either of the
+    # files.
+    #
+    # @return [Boolean]
+    def equal?
+      @operands.first == @operands.last
+    end
+  end
+end

data/lib/css_compare/exec.rb

@@ -0,0 +1,111 @@
+require 'css_compare/engine'
+require 'optparse'
+
+module CssCompare
+  class Comparison
+    def initialize(args)
+      @args = args
+      @options = {}
+    end
+
+    # Parses the command-line arguments and runs the executable.
+    # Calls `Kernel#exit` at the end, so it never returns.
+    #
+    # @see #parse
+    def parse!
+      begin
+        parse
+      rescue StandardError => e
+        raise e if @options[:trace] || e.is_a?(SystemExit)
+        $stderr.puts "#{e.class}: " + e.message.to_s
+        exit 1
+      end
+      exit 0
+    end
+
+    # Parses the command-line arguments and runs the executable.
+    def parse
+      @opts = OptionParser.new { |opts| process_opts(opts) }
+      @opts.parse!(@args)
+
+      process_args
+
+      @options
+    end
+
+    protected
+
+    # Tells optparse how to parse the arguments.
+    #
+    # @param opts [OptionParser]
+    def process_opts(opts)
+      opts.banner = <<END
+Usage: css_compare <CSS file> <CSS file>
+Description:
+Checks the equality of
+END
+
+      common_options(opts)
+      input_and_output(opts)
+    end
+
+    def common_options(opts)
+      opts.on('-?', '-h', '--help', 'Show this help message.') do
+        puts opts
+        exit
+      end
+
+      opts.on('-v', '--version', 'Print the css_compare version.') do
+        puts("v#{CssCompare::VERSION}")
+        exit
+      end
+    end
+
+    # @todo: specify an option for outputting the diff, when feature is ready
+    def input_and_output(opts)
+      # opts.separator ''
+      # opts.separator 'Input and Output:'
+    end
+
+    def open_file(filename, flag = 'r')
+      return if filename.nil?
+      File.open(filename, flag)
+    end
+
+    # Processes the options set by the command-line arguments -
+    # `@options[:input]` and `@options[:output]` are being set
+    # to appropriate IO streams.
+    #
+    # This method is being overridden by subclasses
+    # to run their respective programs.
+    def process_args
+      args = @args.dup
+      @options[:operands] = nil
+      unless args.length >= 2
+        puts @opts
+        exit 1
+      end
+      @options[:operands] = args.shift(2)
+      @options[:output_filename] = args.shift unless args.empty?
+      @options[:output] ||= @options[:output_filename] || $stdout
+
+      run
+    end
+
+    def write_output(text, destination)
+      if destination.is_a?(String)
+        open_file(destination, 'w') { |file| file.write(text) }
+      else
+        destination.write(text)
+      end
+    end
+
+    # Runs the comparison.
+    def run
+      result = CssCompare::Engine.new(@options)
+                                 .parse!
+                                 .equal?
+      write_output(result.to_s + "\n", @options[:output])
+    end
+  end
+end

data/lib/css_compare/util.rb

@@ -0,0 +1,13 @@
+module CssCompare
+  module Util
+    class << self
+      # Returns a file's path relative to the Less2Sass root directory.
+      #
+      # @param file [String] The filename relative to the Less2Sass root
+      # @return [String] The filename relative to the the working directory
+      def scope(file)
+        File.join(CssCompare::ROOT_DIR, file)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: css_compare
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Attila Večerek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description: |2
+        Processes, evaluates and compares 2 different
+        CSS files based on their AST.
+email:
+- attila.vecerek@gmail.com
+executables:
+- css_compare
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/css_compare
+- lib/css_compare.rb
+- lib/css_compare/constants.rb
+- lib/css_compare/css.rb
+- lib/css_compare/css/component.rb
+- lib/css_compare/css/component/base.rb
+- lib/css_compare/css/component/font_face.rb
+- lib/css_compare/css/component/keyframes.rb
+- lib/css_compare/css/component/keyframes_selector.rb
+- lib/css_compare/css/component/margin_box.rb
+- lib/css_compare/css/component/page_selector.rb
+- lib/css_compare/css/component/property.rb
+- lib/css_compare/css/component/selector.rb
+- lib/css_compare/css/component/supports.rb
+- lib/css_compare/css/component/value.rb
+- lib/css_compare/css/engine.rb
+- lib/css_compare/css/parser.rb
+- lib/css_compare/engine.rb
+- lib/css_compare/exec.rb
+- lib/css_compare/util.rb
+homepage: https://github.com/vecerek/css-compare
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.3
+signing_key: 
+specification_version: 4
+summary: AST-based CSS comparing tool.
+test_files: []