RubyGems - elcamino-microformat - Versions diffs - 0.0.8 - Mend

elcamino-microformat 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

checksums.yaml +7 -0
data/.gitignore +18 -0
data/.rvmrc +12 -0
data/.travis.yml +3 -0
data/Gemfile +4 -0
data/LICENSE +22 -0
data/README.md +55 -0
data/Rakefile +13 -0
data/lib/microformat.rb +11 -0
data/lib/microformat/attribute.rb +50 -0
data/lib/microformat/attribute_definition.rb +23 -0
data/lib/microformat/attribute_map.rb +40 -0
data/lib/microformat/card.rb +36 -0
data/lib/microformat/collection.rb +26 -0
data/lib/microformat/format.rb +48 -0
data/lib/microformat/parser.rb +54 -0
data/lib/microformat/review.rb +19 -0
data/lib/microformat/review_aggregate.rb +16 -0
data/lib/microformat/selectors.rb +45 -0
data/lib/microformat/version.rb +3 -0
data/microformat.gemspec +26 -0
data/spec/microformat/attribute_definition_spec.rb +16 -0
data/spec/microformat/attribute_spec.rb +23 -0
data/spec/microformat/collection_spec.rb +31 -0
data/spec/microformat/format_spec.rb +46 -0
data/spec/microformat/parser_spec.rb +121 -0
data/spec/microformat/selectors_spec.rb +92 -0
data/spec/microformat_spec.rb +17 -0
data/spec/spec_helper.rb +9 -0
data/spec/support/env.rb +8 -0
metadata +139 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b953eda6079522b0e0d424163f04636dbe335b4c
+  data.tar.gz: b6617bfe82b414dbb901a06079a730b58395421e
+SHA512:
+  metadata.gz: e2993d9b04c721e7ca88bc54f9ab350a9279d4e1ce8c2d620b393af6d66829cba7240ceb71f0050e6fe99f9e75093524d81d3c6d5a6e9cb3460f649bf12e6c1f
+  data.tar.gz: 07bd2728b89221ddd090d635644fb5fa1c226fd1d7f4e6e0e33acd52c1cc22293aa7f90ba0391aec21522f8fd0195ae2df630b16780e32b6e7bfbca339beced8

data/.gitignore ADDED Viewed

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

data/.rvmrc ADDED Viewed

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+if ! rvm list | grep -q ruby-1.9.3-p194 ; then
+	rvm install 1.9.3-p194
+fi
+rvm 1.9.3-p194@platformq_microformat --create
+if ! gem list | grep -q bundler ; then
+	gem install --no-ri --no-rdoc bundler
+	bundle install --without production
+fi

data/.travis.yml ADDED Viewed

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile ADDED Viewed

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

data/LICENSE ADDED Viewed

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Platform Q LLC
+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 ADDED Viewed

@@ -0,0 +1,55 @@
+# Microformat
+Reads Microformats from HTML documents
+[![Build Status][2]][1] [![Code Climate][3]][4]
+  [1]: http://travis-ci.org/platformq/microformat
+  [2]: https://secure.travis-ci.org/platformq/microformat.png?branch=master
+  [3]: https://codeclimate.com/badge.png
+  [4]: https://codeclimate.com/github/platformq/microformat
+## Installation
+Add this line to your application's Gemfile:
+```ruby
+gem "microformat"
+```
+And then execute:
+    $ bundle
+Or install it yourself as:
+    $ gem install microformat
+## Usage
+You can parse a document (or partial document), providing the HTML as a string:
+```ruby
+html = "<html>...</html>"
+Microformat.parse(html) # => Microformat::Collection
+```
+Or provide a Nokogiri element:
+```ruby
+require "nokogiri"
+html = "<html>...</html>"
+doc = Nokogiri::HTML(html)
+element = doc.css("body")
+Microformat.parse(element)
+# => Microformat::Collection
+```
+## Contributing
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile ADDED Viewed

@@ -0,0 +1,13 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+desc "Runs all the specs"
+task default: %w(spec)
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end

data/lib/microformat.rb ADDED Viewed

@@ -0,0 +1,11 @@
+require "microformat/version"
+require "microformat/parser"
+require "microformat/review"
+require "microformat/review_aggregate"
+require "microformat/card"
+module Microformat
+  def self.parse(*args)
+    Parser.parse(*args)
+  end
+end

data/lib/microformat/attribute.rb ADDED Viewed

@@ -0,0 +1,50 @@
+require "microformat/attribute_map"
+module Microformat
+  class Attribute
+    attr_reader :name, :options, :attributes
+    def initialize(name, options = {}, &block)
+      @name = name
+      @options = options
+      @attributes ||= {}
+      if options[:format]
+        @attributes.merge!(options[:format].attribute_definition.attributes)
+      end
+      block.yield(self) if block_given?
+    end
+    def attribute(name, options = {}, &block)
+      Attribute.new(name, options, &block).tap do |attribute|
+        @attributes.merge!(name.to_sym => attribute)
+      end
+    end
+    def read_from(document)
+      selector = options[:selector] || ".#{@name}"
+      sub_document = document.css(selector).first
+      value = read_value_from(sub_document)
+      AttributeMap.new(self, sub_document, { value: value })
+    end
+    def read_value_from(document)
+      Array(options[:attribute] || "text").each do |attr|
+        if attr == "text"
+          return cast((document && document.text) || options[:default], options[:cast])
+        elsif document[attr]
+          return cast(document && document[attr], options[:cast])
+        end
+      end
+      return options[:default]
+    end
+    def cast(value, cast_to = nil)
+      value && case cast_to
+      when :integer then value.to_s.strip.to_i
+        when :decimal then value.to_s.strip.to_f
+        when :string then value.to_s.strip
+        else value
+      end
+    end
+  end
+end

data/lib/microformat/attribute_definition.rb ADDED Viewed

@@ -0,0 +1,23 @@
+require "microformat/attribute"
+require "microformat/attribute_map"
+module Microformat
+  class AttributeDefinition
+    attr_reader :attributes
+    def initialize(&block)
+      @attributes ||= {}
+      block.yield(self)
+    end
+    def attribute(name, options = {}, &block)
+      Attribute.new(name, options, &block).tap do |attribute|
+        @attributes.merge!(name.to_sym => attribute)
+      end
+    end
+    def map_to(document)
+      AttributeMap.new(self, document)
+    end
+  end
+end

data/lib/microformat/attribute_map.rb ADDED Viewed

@@ -0,0 +1,40 @@
+module Microformat
+  class AttributeMap
+    attr_reader :definition, :document
+    def initialize(definition, document, values = {})
+      @definition = definition
+      @document = document
+      @values = values
+      @attribute_cache = {}
+    end
+    def respond_to_missing?(name, public_only = false)
+      values_responds_to?(name) ||
+      definition_responds_to?(name)
+    end
+    def method_missing(name, *args, &block)
+      if values_responds_to?(name)
+        @values.fetch(name.to_sym)
+      elsif @attribute_cache.has_key?(name)
+        @attribute_cache[name]
+      elsif definition_responds_to?(name)
+        attribute = @definition.attributes.fetch(name)
+        value = attribute.read_from(document)
+        @attribute_cache[name] = value
+      else
+        super(name)
+      end
+    end
+    private
+    def values_responds_to?(name)
+      @values.has_key?(name.to_sym)
+    end
+    def definition_responds_to?(name)
+      @definition.attributes.has_key?(name.to_sym)
+    end
+  end
+end

data/lib/microformat/card.rb ADDED Viewed

@@ -0,0 +1,36 @@
+require "microformat/format"
+module Microformat
+  class Card < Format
+    selector ".vcard"
+    attribute_definition do |root|
+      root.attribute(:fn, required: true)
+      root.attribute(:n) do |n|
+        n.attribute(:"honorific-prefix")
+        n.attribute(:"given-name")
+        n.attribute(:"additional-name")
+        n.attribute(:"family-name")
+        n.attribute(:"honorific-suffix")
+      end
+      root.attribute(:nickname)
+      root.attribute(:org)
+      root.attribute(:photo, cast: :url, attribute: ["href", "src"])
+      root.attribute(:url, cast: :url, attribute: "href")
+      root.attribute(:email, cast: :email)
+      root.attribute(:tel, cast: :tel)
+      root.attribute(:categoria)
+      root.attribute(:adr) do |adr|
+        adr.attribute(:"street-address")
+        adr.attribute(:locality)
+        adr.attribute(:region)
+        adr.attribute(:"postal-code")
+        adr.attribute(:"country-name")
+        adr.attribute(:district)
+      end
+      root.attribute(:"bday")
+      root.attribute(:"category")
+      root.attribute(:"note")
+    end
+  end
+end

data/lib/microformat/collection.rb ADDED Viewed

@@ -0,0 +1,26 @@
+require "microformat/selectors"
+module Microformat
+  class Collection < ::Array
+    def <<(element)
+      # load the first matching format
+      format = Selectors.class_matching(element)
+      # use the microformat to parse the element
+      parsed = format.parse(element)
+      # add the parsed object to the array
+      super(parsed)
+    end
+    def filter(*args)
+      classes = Array(args).flatten
+      # find the applicable classes
+      filtered = select do |object|
+        Array(classes).include?(object.class)
+      end
+      # create a new collection from them
+      self.class.new.tap do |collection|
+        collection.replace(filtered)
+      end
+    end
+  end
+end

data/lib/microformat/format.rb ADDED Viewed

@@ -0,0 +1,48 @@
+require "microformat/attribute_definition"
+require "microformat/selectors"
+module Microformat
+  class Format
+    def self.selector(selector = nil)
+      define_selector(selector) if selector
+      @selector
+    end
+    def self.attribute_definition(&block)
+      @attribute_definition = AttributeDefinition.new(&block) if block_given?
+      @attribute_definition
+    end
+    def self.parse(document)
+      new(document)
+    end
+    attr_reader :document
+    def initialize(document)
+      @document = document
+    end
+    def respond_to_missing?(name, public_only = false)
+      attribute_map.respond_to?(name)
+    end
+    def method_missing(name)
+      if attribute_map.respond_to?(name)
+        attribute_map.send(name)
+      else
+        super(name)
+      end
+    end
+    private
+    def attribute_map
+      @attribute_map ||= self.class.attribute_definition.map_to(document)
+    end
+    def self.define_selector(selector)
+      Selectors.define(selector, self)
+      @selector = selector
+    end
+  end
+end

data/lib/microformat/parser.rb ADDED Viewed

@@ -0,0 +1,54 @@
+require "nokogiri"
+require "microformat/collection"
+require "microformat/selectors"
+module Microformat
+  class Parser
+    def self.parse(doc, options = {})
+      # ensure the document is parsed
+      unless doc.respond_to?(:css)
+        doc = Nokogiri::HTML(doc)
+      end
+      # return the collection
+      new(doc, options).collection
+    end
+    attr_reader :doc, :options
+    def initialize(doc, options)
+      @doc = doc
+      @options = options
+      parse(elements)
+    end
+    def parse(elements)
+      i = 0; while i < [limit, elements.size].min do
+        collection << elements[i]
+        i += 1
+      end
+    end
+    def limit
+      @limit ||= options[:limit] || Float::INFINITY
+    end
+    def selectors
+      @selectors ||= Selectors.filter(options[:filter])
+    end
+    def collection
+      @collection ||= Collection.new
+    end
+    private
+    def elements
+      @elements ||= [].tap do |elements|
+        while doc.css(selectors.join(", ")).length > 0
+          node = doc.css(selectors.join(", ")).first
+          node.remove
+          elements.push node
+        end
+      end
+    end
+  end
+end

data/lib/microformat/review.rb ADDED Viewed

@@ -0,0 +1,19 @@
+require "microformat/format"
+require "microformat/card"
+module Microformat
+  class Review < Format
+    selector ".hreview"
+    attribute_definition do |root|
+      root.attribute(:summary)
+      root.attribute(:type)
+      root.attribute(:item, format: Card)
+      root.attribute(:reviewer, format: Card)
+      root.attribute(:rating, cast: :decimal)
+      root.attribute(:description)
+      root.attribute(:tags, multiple: true, selector: "[rel='tag']")
+      root.attribute(:permalink, selector: "[rel='bookmark']", attribute: "href")
+    end
+  end
+end

data/lib/microformat/review_aggregate.rb ADDED Viewed

@@ -0,0 +1,16 @@
+require "microformat/format"
+require "microformat/card"
+module Microformat
+  class ReviewAggregate < Format
+    selector ".hreview-aggregate"
+    attribute_definition do |root|
+      root.attribute(:item, format: Card)
+      root.attribute(:rating, cast: :decimal)
+      root.attribute(:count, cast: :integer)
+      root.attribute(:votes, cast: :integer)
+      root.attribute(:summary)
+    end
+  end
+end

data/lib/microformat/selectors.rb ADDED Viewed

@@ -0,0 +1,45 @@
+require "singleton"
+module Microformat
+  class Selectors < Hash
+    include Singleton
+    def self.class_matching(element)
+      # load the CSS classes of the element
+      css_classes = element["class"].split(/\s+/).map do |c|
+        ".#{c}"
+      end
+      # loop through the classes
+      Array(css_classes).each do |css_class|
+        instance.each do |selector, klass|
+          if selector == css_class
+            return klass
+          end
+        end
+      end
+      raise RuntimeError, "No class is defined for any of the selectors: #{css_classes.join(" / ")}"
+    end
+    def self.define(selector, klass)
+      if instance.has_key?(selector) && instance.fetch(selector) != klass
+        raise ArgumentError, "#{instance.fetch(selector).name} has already implemented the selector '#{selector}'"
+      else
+        instance.merge!(selector => klass)
+      end
+    end
+    def self.filter(klasses = nil)
+      if klasses
+        instance.filter(Array(klasses))
+      else
+        instance.keys
+      end
+    end
+    def filter(klasses)
+      select do |selector, klass|
+        Array(klasses).include?(klass)
+      end.keys
+    end
+  end
+end

data/lib/microformat/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module Microformat
+  VERSION = "0.0.8"
+end

data/microformat.gemspec ADDED Viewed

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "microformat/version"
+Gem::Specification.new do |s|
+  s.authors       = ["Ryan Townsend", "Tobias Begalke"]
+  s.email         = ["ryan@ryantownsend.co.uk", "elcamino@spyz.org"]
+  s.description   = %q{Reads Microformats from HTML documents}
+  s.summary       = s.description
+  s.homepage      = "https://github.com/elcamino/microformat"
+  s.files         = `git ls-files`.split($\)
+  s.executables   = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.name          = "elcamino-microformat"
+  s.require_paths = ["lib"]
+  s.version       = Microformat::VERSION
+  # gems
+  s.add_dependency "nokogiri"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "simplecov"
+end

data/spec/microformat/attribute_definition_spec.rb ADDED Viewed

@@ -0,0 +1,16 @@
+require "spec_helper"
+describe Microformat::AttributeDefinition do
+  subject { Microformat::AttributeDefinition }
+  describe "#initialize" do
+    it "should accept a block of nested attributes" do
+      map = subject.new do |map|
+        map.attribute(:one)
+        map.attribute(:two)
+      end
+      expect(map.attributes.size).to eq(2)
+    end
+  end
+end

data/spec/microformat/attribute_spec.rb ADDED Viewed

@@ -0,0 +1,23 @@
+require "spec_helper"
+describe Microformat::Attribute do
+  subject { Microformat::Attribute }
+  describe "#initialize" do
+    it "should accept a block of nested attributes" do
+      attribute = subject.new(:name) do |attr|
+        attr.attribute(:one)
+        attr.attribute(:two)
+        attr.attribute(:three) do |three|
+          three.attribute(:four)
+        end
+      end
+      expect(attribute.attributes.size).to eq(3)
+    end
+    it "should set the name" do
+      expect(subject.new(:fn).name).to eq(:fn)
+    end
+  end
+end

data/spec/microformat/collection_spec.rb ADDED Viewed

@@ -0,0 +1,31 @@
+require "spec_helper"
+describe Microformat::Collection do
+  subject do
+    Microformat::Collection.new
+  end
+  describe "#<<" do
+    it "should parse the element to the collection" do
+      selector = ".selector"
+      source = %Q(<html><body>
+          <div class="#{selector.gsub(/^\./, "")}"></div>
+      </body></html>)
+      element = Nokogiri::HTML(source).css(selector).first
+      parsed = mock("parsed_object")
+      format = mock("format")
+      format.should_receive(:parse).and_return(parsed)
+      Microformat::Selectors.define(selector, format)
+      subject << element
+      expect(subject).to include parsed
+    end
+  end
+  describe "#filter" do
+    it "should filter the collection down to the specific classes" do
+      objects = [Object.new, Hash.new, Array.new]
+      subject.replace(objects)
+      expect(subject.filter(Hash)).to eq [objects[1]]
+    end
+  end
+end

data/spec/microformat/format_spec.rb ADDED Viewed

@@ -0,0 +1,46 @@
+require "spec_helper"
+module Microformat
+  class TestFormat < Microformat::Format; end
+end
+describe Microformat::Format do
+  after(:each) do
+    Microformat::Selectors.instance.replace({})
+  end
+  describe "::selector" do
+    describe "getting the value" do
+      it "should return the value" do
+        Microformat::TestFormat.selector ".review"
+        expect(Microformat::TestFormat.selector).to eq ".review"
+      end
+    end
+    describe "setting the value" do
+      it "should define the selector" do
+        Microformat::TestFormat.selector ".review2"
+        expect(Microformat::Selectors.instance[".review2"]).to eq Microformat::TestFormat
+      end
+    end
+  end
+  describe "::attribute_definition" do
+    describe "setting the value" do
+      it "should accept a block and set the map correctly" do
+        map = Microformat::TestFormat.attribute_definition do |attr|
+          attr.attribute :name
+        end
+        expect(map.attributes.values.first.name).to eq :name
+      end
+    end
+  end
+  describe "::parse" do
+    it "should return and instance of the format using the given document" do
+      html = %Q(<html><body>Something</body></html>)
+      doc = Nokogiri::HTML(html)
+      expect(Microformat::TestFormat.parse(doc).document).to eq doc
+    end
+  end
+end

data/spec/microformat/parser_spec.rb ADDED Viewed

@@ -0,0 +1,121 @@
+require "spec_helper"
+require "nokogiri"
+describe Microformat::Parser do
+  describe "::parse" do
+    subject do
+      Microformat::Parser.parse(doc)
+    end
+    before(:each) do
+      Microformat::Selectors.instance.replace({})
+      [
+        Microformat::Card,
+        Microformat::Review
+      ].each { |klass| klass.selector(klass.selector) }
+    end
+    let(:html) do
+      %Q(<html><body></body></html>)
+    end
+    let(:review_html) do
+      %Q(<html><body>
+        <div class="hreview">
+          <div class="summary">It's good</div>
+          <div class="reviewer">
+            <p class="fn">Dave</p>
+          </div>
+        </div>
+      </body></html>)
+    end
+    let(:nested_review_html) do
+      %Q(<html><body>
+        <div class="hreview">
+          <div class="summary">It's good</div>
+          <div class="reviewer">
+            <p class="fn">Dave</p>
+            <div class="hreview"></div>
+          </div>
+        </div>
+      </body></html>)
+    end
+    context "given a HTML string" do
+      let(:doc) { html }
+      it "should return an instance of Microformat::Collection" do
+        expect(subject).to be_kind_of Microformat::Collection
+      end
+    end
+    context "given a HTML document" do
+      let(:doc) { Nokogiri::HTML(html) }
+      it "should return an instance of Microformat::Collection" do
+        expect(subject).to be_kind_of Microformat::Collection
+      end
+    end
+    context "given a HTML element" do
+      let(:doc) { Nokogiri::HTML(html).css("body") }
+      it "should return an instance of Microformat::Collection" do
+        expect(subject).to be_kind_of Microformat::Collection
+      end
+    end
+    context "given a HTML document with a hReview" do
+      let(:doc) { Nokogiri::HTML(review_html) }
+      it "should return a collection with one object" do
+        expect(subject.size).to eq 1
+      end
+      describe "the returned Microformat object" do
+        subject do
+          Microformat::Parser.parse(doc).first
+        end
+        it "should be a Microformat::Review" do
+          expect(subject).to be_kind_of(Microformat::Review)
+        end
+        it "should return the summary" do
+          expect(subject.summary.value).to eq "It's good"
+        end
+        it "should return the reviewer's full name" do
+          expect(subject.reviewer.fn.value).to eq "Dave"
+        end
+      end
+    end
+    context "given a HTML document with nested microformats" do
+      let(:doc) { Nokogiri::HTML(nested_review_html) }
+      it "should return a collection with one object" do
+        expect(subject.size).to eq 1
+      end
+      describe "the returned Microformat object" do
+        subject do
+          Microformat::Parser.parse(doc).first
+        end
+        it "should be a Microformat::Review" do
+          expect(subject).to be_kind_of(Microformat::Review)
+        end
+        it "should return the summary" do
+          expect(subject.summary.value).to eq "It's good"
+        end
+        it "should return the reviewer's full name" do
+          expect(subject.reviewer.fn.value).to eq "Dave"
+        end
+      end
+    end
+  end
+end

data/spec/microformat/selectors_spec.rb ADDED Viewed

@@ -0,0 +1,92 @@
+require "spec_helper"
+describe Microformat::Selectors do
+  let(:selectors) { Hash.new }
+  subject do
+    Microformat::Selectors.instance
+  end
+  before(:each) do
+    selectors.each do |sel,klass|
+      Microformat::Selectors.define(sel, klass)
+    end
+  end
+  after(:each) do
+    Microformat::Selectors.instance.replace({})
+  end
+  describe "::instance" do
+    it "should always return the same object" do
+      expect(subject.class.instance.object_id).to eq subject.class.instance.object_id
+    end
+  end
+  describe "::define" do
+    context "when the selector is already defined" do
+      it "should raise an exception" do
+        subject.class.define(".hello", Hash)
+        expect {
+          subject.class.define(".hello", Object)
+        }.to raise_error(ArgumentError)
+      end
+    end
+    context "when redefining the selector" do
+      it "should not raise an exception" do
+        subject.class.define(".hello", Hash)
+        expect {
+          subject.class.define(".hello", Hash)
+        }.not_to raise_error(ArgumentError)
+      end
+    end
+    context "when the selector is not defined" do
+      it "should add the definition to the hash" do
+        subject.class.define(".hello", Hash)
+        expect(subject[".hello"]).to eq Hash
+      end
+    end
+  end
+  describe "::class_matching" do
+    let(:selectors) do
+      {
+        ".review" => Object,
+        ".card" => Hash
+      }
+    end
+    it "should return the first class that matches the given selectors" do
+      doc = %Q(<html><body>
+        <div class="card review"></div>
+      </body></html>)
+      element = Nokogiri::HTML(doc).css(".card").first
+      expect(subject.class.class_matching(element)).to eq Hash
+    end
+    context "with no matching selectors" do
+      it "should raise an exception" do
+        doc = %Q(<html><body>
+          <div class="non"></div>
+        </body></html>)
+        element = Nokogiri::HTML(doc).css(".non").first
+        expect {
+          subject.class.class_matching(element)
+        }.to raise_error(RuntimeError)
+      end
+    end
+  end
+  describe "::filter" do
+    let(:selectors) do
+      { ".review" => Object }
+    end
+    it "should return an array of selectors that match the given classes" do
+      expect(subject.class.filter(Object)).to eq [".review"]
+      expect(subject.class.filter(Hash)).to eq []
+    end
+  end
+end

data/spec/microformat_spec.rb ADDED Viewed

@@ -0,0 +1,17 @@
+require "spec_helper"
+describe Microformat do
+  subject { Microformat }
+  describe "::parse" do
+    let(:args) { ["one", 2, :three] }
+    before(:each) do
+      Microformat::Parser.should_receive(:parse).with(*args).and_return(true)
+    end
+    it "should pass args onto the parser" do
+      expect(subject.parse(*args)).to be_true
+    end
+  end
+end

data/spec/spec_helper.rb ADDED Viewed

@@ -0,0 +1,9 @@
+require "simplecov"
+SimpleCov.start do
+  add_filter "/spec/"
+end
+require "bundler"
+Bundler.require
+Dir[File.join(File.dirname(__FILE__), "support/**/*.rb")].each { |f| require f }

data/spec/support/env.rb ADDED Viewed

@@ -0,0 +1,8 @@
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+  config.color_enabled = true
+  config.order = :random
+end

metadata ADDED Viewed

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: elcamino-microformat
+version: !ruby/object:Gem::Version
+  version: 0.0.8
+platform: ruby
+authors:
+- Ryan Townsend
+- Tobias Begalke
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2014-10-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Reads Microformats from HTML documents
+email:
+- ryan@ryantownsend.co.uk
+- elcamino@spyz.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rvmrc"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/microformat.rb
+- lib/microformat/attribute.rb
+- lib/microformat/attribute_definition.rb
+- lib/microformat/attribute_map.rb
+- lib/microformat/card.rb
+- lib/microformat/collection.rb
+- lib/microformat/format.rb
+- lib/microformat/parser.rb
+- lib/microformat/review.rb
+- lib/microformat/review_aggregate.rb
+- lib/microformat/selectors.rb
+- lib/microformat/version.rb
+- microformat.gemspec
+- spec/microformat/attribute_definition_spec.rb
+- spec/microformat/attribute_spec.rb
+- spec/microformat/collection_spec.rb
+- spec/microformat/format_spec.rb
+- spec/microformat/parser_spec.rb
+- spec/microformat/selectors_spec.rb
+- spec/microformat_spec.rb
+- spec/spec_helper.rb
+- spec/support/env.rb
+homepage: https://github.com/elcamino/microformat
+licenses: []
+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.2.2
+signing_key:
+specification_version: 4
+summary: Reads Microformats from HTML documents
+test_files:
+- spec/microformat/attribute_definition_spec.rb
+- spec/microformat/attribute_spec.rb
+- spec/microformat/collection_spec.rb
+- spec/microformat/format_spec.rb
+- spec/microformat/parser_spec.rb
+- spec/microformat/selectors_spec.rb
+- spec/microformat_spec.rb
+- spec/spec_helper.rb
+- spec/support/env.rb