http_link_header 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README.rdoc

@@ -0,0 +1,7 @@
+= HttpLinkHeader
+
+Parses and generates HTTP Link headers as defined by
+{IETF RFC 5988}[http://tools.ietf.org/html/rfc5988].
+
+Author::  Clyde Law (mailto:claw@alum.mit.edu)
+License:: Released under the MIT license

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/http_link_header.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "http_link_header/version"
+
+Gem::Specification.new do |s|
+  s.name        = "http_link_header"
+  s.version     = HttpLinkHeader::VERSION
+  s.authors     = ["Clyde Law"]
+  s.email       = ["claw@alum.mit.edu"]
+  s.homepage    = %q{http://github.com/Umofomia/http_link_header}
+  s.summary     = %q{Parses and generates HTTP Link headers as defined by IETF RFC 5988.}
+  s.description = %q{Parses and generates HTTP Link headers as defined by IETF RFC 5988.}
+  s.license     = 'MIT'
+
+  s.rubyforge_project = "http_link_header"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/http_link_header/http_link_params.rb

@@ -0,0 +1,76 @@
+class HttpLinkHeader::HttpLinkParams < ::Hash
+  DELIMETER = ';'
+  RELATION_TYPE_ATTRIBUTES = Set['rel', 'rev']
+
+  class RelationTypes < ::Set
+
+    def initialize(relation_types)
+      if relation_types.is_a?(Enumerable)
+        super(relation_types)
+      elsif relation_types.is_a?(String)
+        add(relation_types)
+      else
+        raise ArgumentError, "invalid relation-types: #{relation_types}"
+      end
+    end
+
+    def add(relation_types)
+      relation_types.strip.gsub!(/\A"|"\z/, '').split(' ').each do |relation_type|
+        relation_type = relation_type.strip
+        super(relation_type.downcase) unless relation_type.empty?
+      end
+    end
+
+    def include?(relation_type)
+      super(relation_type.downcase)
+    end
+
+    def to_s
+      %Q{"#{to_a.join(' ')}"}
+    end
+
+  end
+
+  def initialize(link_params)
+    add(link_params)
+  end
+
+  def [](attribute)
+    super(attribute.to_s)
+  end
+
+  def []=(attribute, value)
+    if RELATION_TYPE_ATTRIBUTES.include?(attribute.to_s)
+      if self[attribute]
+        self[attribute].add(value)
+      else
+        super(attribute.to_s, RelationTypes.new(value))
+      end
+    else
+      super(attribute.to_s, value)
+    end
+  end
+
+  def add(link_params)
+    link_params.split(DELIMETER).each do |link_param|
+      link_param.strip!
+      next if link_param.empty?
+
+      if link_param_match = link_param.match(/\A([\w!#\$&\+\-\.\^`\|~]+\*?)\s*(=\s*(.*))?\z/)
+        attribute, value = link_param_match.values_at(1, 3)
+        self[attribute.strip] = value ? value.strip : nil
+      else
+        raise ArgumentError, "invalid link-param: #{link_param}"
+      end
+    end
+  end
+
+  def to_a
+    map { |attribute, value| value ? "#{attribute}=#{value.to_s}" : attribute }
+  end
+
+  def to_s
+    to_a.join("#{DELIMETER} ")
+  end
+
+end

data/lib/http_link_header/version.rb

@@ -0,0 +1,3 @@
+class HttpLinkHeader < ::Hash
+  VERSION = "0.1.0"
+end

data/lib/http_link_header.rb

@@ -0,0 +1,62 @@
+require "http_link_header/version"
+require "http_link_header/http_link_params"
+
+class HttpLinkHeader < ::Hash
+  DELIMETER = ','
+
+  def initialize(link_header = [])
+    link_header = link_header.split(DELIMETER) if link_header.is_a?(String)
+    link_header.each { |link_value| add(link_value) }
+  end
+
+  def [](uri_reference)
+    super(uri_reference.to_s)
+  end
+
+  def []=(uri_reference, link_params)
+    link_params = nil if link_params && link_params.empty?
+    if self[uri_reference]
+      self[uri_reference].add(link_params) unless link_params.nil?
+    else
+      super(uri_reference.to_s, link_params.nil? ? nil : HttpLinkParams.new(link_params))
+    end
+  end
+
+  def add(link_value)
+    if link_value_match = link_value.strip.match(/\A<([^>]+)>\s*(;\s*(.*))?\z/)
+      uri_reference, link_params = link_value_match.values_at(1, 3)
+      self[uri_reference.strip] = link_params ? link_params.strip : nil
+    else
+      raise ArgumentError, "invalid link-value: #{link_value}"
+    end
+  end
+
+  def to_a
+    map do |uri_reference, link_params|
+      link_value = "<#{uri_reference}>"
+      link_value << "#{HttpLinkParams::DELIMETER} #{link_params.to_s}" if link_params && !link_params.empty?
+      link_value
+    end
+  end
+
+  def to_s
+    to_a.join("#{DELIMETER} ")
+  end
+
+  # Define methods for each relation type attribute to find URIs that have
+  # the respective attribute set to the specified relation type.
+  #
+  HttpLinkParams::RELATION_TYPE_ATTRIBUTES.each do |relation_type_attribute|
+    class_eval(<<-RELATION_TYPE_METHOD, __FILE__, __LINE__ + 1)
+      def #{relation_type_attribute}(relation_type)
+        each do |uri_reference, link_params|
+          if (relation_types = link_params[#{relation_type_attribute.inspect}]) && relation_types.include?(relation_type.to_s)
+            return uri_reference
+          end
+        end
+        nil
+      end
+    RELATION_TYPE_METHOD
+  end
+
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: http_link_header
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Clyde Law
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-12 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Parses and generates HTTP Link headers as defined by IETF RFC 5988.
+email: 
+- claw@alum.mit.edu
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- http_link_header.gemspec
+- lib/http_link_header.rb
+- lib/http_link_header/http_link_params.rb
+- lib/http_link_header/version.rb
+has_rdoc: true
+homepage: http://github.com/Umofomia/http_link_header
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: http_link_header
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Parses and generates HTTP Link headers as defined by IETF RFC 5988.
+test_files: []
+