stylesheet 0.1.0

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.rvmrc
+.bundle
+.config
+.yardoc
+.rspec
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bin

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in color_parser.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/stylesheet/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')         { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Derek DeVries
+
+MIT License
+
+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,63 @@
+## Stylesheet
+
+The Stylesheet gem provides a parser for CSS Stylesheets based on the DOM API
+
+## Examples
+
+Get styles from a document: 
+
+```ruby
+document = Stylesheet::Document.new("http://sportspyder.com")
+document.style_sheets
+```
+
+Get attributes of a stylesheet: 
+
+```ruby
+sheet = document.style_sheets[0]
+puts sheet.href
+puts sheet.type
+```
+
+Get stylesheet media definitions: 
+
+```ruby
+sheet = document.style_sheets[0]
+sheet.media.each do |media| 
+  puts media
+end
+```
+
+Get rules defined in a stylesheet: 
+
+```ruby
+sheet = Stylesheet::CssStyleSheet.new("http://sportspyder.com/stylesheets/screen.css")
+sheet.css_rules.each do |rule|
+  puts rule.css_text
+  puts rule.selector_text
+end
+```
+
+Get declarations defined in a style rules: 
+
+```ruby
+sheet = document.style_sheets[0]
+rule  = sheet.css_rules[0]
+puts rule.style[0]
+puts rule.style.border
+```
+
+## Installation
+
+```
+gem install stylesheet
+```
+```
+gem "stylesheet"
+```
+
+## LICENSE
+
+Copyright (c) 2013 Derek DeVries
+
+Released under the [MIT License](http://www.opensource.org/licenses/MIT)

data/Rakefile

@@ -0,0 +1,22 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+namespace :spec do
+  desc 'Run unit specs only'
+  RSpec::Core::RakeTask.new(:unit) do |task|
+    task.pattern    = 'spec'
+    task.rspec_opts = '--tag "~live"'
+  end
+
+  desc 'Run acceptance specs only'
+  RSpec::Core::RakeTask.new(:acceptance) do |task|
+    task.pattern    = 'spec'
+    task.rspec_opts = '--tag "live"'
+  end
+end
+
+task :default => :spec

data/features/document_styles.feature

@@ -0,0 +1,15 @@
+Feature: find stylesheets from documents
+  In order to find visual components of a website
+  As a developer
+  I want to find the stylesheets in a document
+
+  Scenario: find document styles
+    Given I have a document at the url http://example.com/css/absolute_path.html
+    When I ask for style sheets
+    Then I should receive a list of stylesheets
+  
+  Scenario: find stylesheet attributes
+    Given I have a css file found in the document http://example.com/css/absolute_path.html
+    When I ask the stylesheet about it's attributes
+    Then I should get details about the stylesheet
+    And the media the stylesheet was intended for

data/features/rule_declarations.feature

@@ -0,0 +1,9 @@
+Feature: find declarations defined in a style rules
+  In order to find visual components of a website
+  As a developer
+  I want to find the css rule declarations in a style rule
+
+  Scenario: find declarations in style rules
+    Given I have a rule in the css file at the url http://example.com/css/stylesheets/screen.css
+    When I ask a rule about it's styles
+    Then I should get style declarations

data/features/step_definitions/document_steps.rb

@@ -0,0 +1,39 @@
+Before do 
+  Stylesheet.request = FakeRequest.new
+end
+
+Given(/^I have a document at the url (.*)$/) do |url|
+  @document = Document.new(url)
+end
+
+When(/^I ask for style sheets$/) do
+  @sheets = @document.style_sheets
+end
+
+Then(/^I should receive a list of stylesheets$/) do
+  expect(@sheets).to be_kind_of(StyleSheetList)
+end
+
+Given(/^I have a css file found in the document (.*)$/) do |url|
+  @stylesheet = Document.new(url).style_sheets[0]
+end
+
+When(/^I ask the stylesheet about it's attributes$/) do
+  @type     = @stylesheet.type
+  @href     = @stylesheet.href
+  @disabled = @stylesheet.disabled?
+  @rules    = @stylesheet.css_rules
+  
+  @media = @stylesheet.media
+end
+
+Then(/^I should get details about the stylesheet$/) do
+  expect(@type).to eq "text/css"
+  expect(@href).to eq "http://example.com/css/stylesheets/screen.css"
+  expect(@disabled).to be_false
+  expect(@rules).to be_kind_of(CssRuleList)
+end
+
+Then(/^the media the stylesheet was intended for$/) do
+  expect(@media).to be_kind_of(MediaList)
+end

data/features/step_definitions/rule_declaration_steps.rb

@@ -0,0 +1,13 @@
+Before do 
+  Stylesheet.request = FakeRequest.new
+end
+
+When(/^I ask a rule about it's styles$/) do
+  @declarations = @rule.style
+end
+
+Then(/^I should get style declarations$/) do
+  expect(@declarations.css_text).to eq "color: #444; background-color: #535353;"
+  expect(@declarations[0]).to eq    "color: #444"
+  expect(@declarations.color).to eq "#444"
+end

data/features/step_definitions/style_rule_steps.rb

@@ -0,0 +1,31 @@
+Before do 
+  Stylesheet.request = FakeRequest.new
+end
+
+Given(/^I have a css file at the url (.*)$/) do |url|
+  @stylesheet = CssStyleSheet.new(url)
+end
+
+When(/^I ask the style about it's rules$/) do
+  @rules = @stylesheet.css_rules
+end
+
+Then(/^I should receive a list of style rules$/) do
+  expect(@rules).to be_kind_of CssRuleList
+end
+
+Given(/^I have a rule in the css file at the url (.*)$/) do |url|
+  @rule = CssStyleSheet.new(url).css_rules[0]
+end
+
+When(/^I ask the rule about it's attributes$/) do
+  @css_text = @rule.css_text
+  @selector = @rule.selector_text
+  @type     = @rule.type
+end
+
+Then(/^I should get details about the rule$/) do
+  expect(@css_text).to eq "body { color: #444;background-color: #535353;}"
+  expect(@selector).to eq "body"
+  expect(@type).to eq CssRule::STYLE_RULE
+end

data/features/style_rules.feature

@@ -0,0 +1,15 @@
+Feature: find rules defined in a stylesheet
+  In order to find visual components of a website
+  As a developer
+  I want to find style rules in a stylesheet
+
+  Scenario: find rules in a stylesheet
+    Given I have a css file at the url http://example.com/css/stylesheets/screen.css
+    When I ask the style about it's rules
+    Then I should receive a list of style rules
+
+  Scenario: find rule attributes
+    Given I have a rule in the css file at the url http://example.com/css/stylesheets/screen.css
+    When I ask the rule about it's attributes
+    Then I should get details about the rule
+

data/features/support/env.rb

@@ -0,0 +1,6 @@
+require 'rspec/expectations'
+
+require_relative '../../lib/stylesheet'
+require_relative '../../spec/stubs/fake_request'
+
+include Stylesheet

data/lib/stylesheet.rb

@@ -0,0 +1,35 @@
+require 'uri'
+require 'forwardable'
+require 'curb'
+require 'nokogiri'
+
+require 'stylesheet/errors'
+require 'stylesheet/version'
+require 'stylesheet/inflector'
+require 'stylesheet/request'
+require 'stylesheet/document'
+require 'stylesheet/location'
+
+require 'stylesheet/style_sheet_list'
+require 'stylesheet/css_style_sheet'
+require 'stylesheet/media_list'
+
+require 'stylesheet/css_rule_list'
+require 'stylesheet/css_rule'
+require 'stylesheet/css_style_rule'
+require 'stylesheet/css_charset_rule'
+require 'stylesheet/css_import_rule'
+require 'stylesheet/css_media_rule'
+require 'stylesheet/css_font_face_rule'
+
+require 'stylesheet/css_style_declaration'
+
+module Stylesheet
+  def self.request=(request)
+    @request = request
+  end
+
+  def self.request
+    @request ||= Request.new
+  end
+end

data/lib/stylesheet/css_charset_rule.rb

@@ -0,0 +1,24 @@
+module Stylesheet
+  class CssCharsetRule < CssRule
+    
+    attr_reader :encoding
+
+    def type
+      CssRule::CHARSET_RULE
+    end
+    
+    def self.matches_rule?(text)
+      text.include?("@charset")
+    end
+
+    private
+    
+    def encoding=(encoding)
+      @encoding = encoding.gsub(/["']+/, "")
+    end
+
+    def parse_css_text
+      selector, self.encoding = css_text.gsub(";", "").split(" ", 2)
+    end
+  end
+end

data/lib/stylesheet/css_font_face_rule.rb

@@ -0,0 +1,26 @@
+module Stylesheet
+  class CssFontFaceRule < CssRule
+
+    def type
+      CssRule::FONT_FACE_RULE
+    end
+
+    def style
+      CssStyleDeclaration.new(:css_text    => @declarations, 
+                              :parent_rule => self)
+    end
+
+    def self.matches_rule?(text)
+      text.include?("@font-face")
+    end
+
+    private
+    
+    def parse_css_text
+      return unless css_text.include?("{")
+
+      selector, declarations = css_text.split("{")
+      @declarations = declarations.strip.gsub(/\}\s*$/, "")
+    end
+  end
+end

data/lib/stylesheet/css_import_rule.rb

@@ -0,0 +1,41 @@
+module Stylesheet
+  class CssImportRule < CssRule
+
+    attr_reader :media
+
+    def type
+      CssRule::IMPORT_RULE
+    end
+
+    def href
+      @href
+    end
+
+    def style_sheet
+      @style_sheet ||= CssStyleSheet.new(location.href)
+    end
+
+    def self.matches_rule?(text)
+      text.include?("@import")
+    end
+
+    def location
+      @location ||= Location.new(@href,
+        parent_style_sheet && parent_style_sheet.location)
+    end
+
+    private
+
+    def href=(url)
+      @href = url.gsub(/url\(|\)|['";]+/, "")
+    end
+
+    def media=(media)
+      @media = MediaList.new(media)
+    end
+    
+    def parse_css_text
+      selector, self.href, self.media = css_text.gsub(";", "").split(" ", 3)
+    end
+  end
+end

data/lib/stylesheet/css_media_rule.rb

@@ -0,0 +1,30 @@
+module Stylesheet
+  class CssMediaRule < CssRule
+    
+    attr_reader :content
+
+    def type
+      CssRule::MEDIA_RULE
+    end
+
+    def css_rules
+      @css_rules ||= CssRuleList.new(content)
+    end
+
+    def self.matches_rule?(text)
+      text.include?("@media")
+    end
+    
+    private
+    
+    def parse_css_text
+      return unless css_text.include?("{")
+
+      @content = if matches = css_text.match(/\{(.*)\}/mi)
+        matches[1]
+      else
+        ""
+      end
+    end
+  end
+end