leadlight 0.0.2

data/Gemfile

@@ -0,0 +1,9 @@
+source 'http://rubygems.org'
+
+gemspec
+
+# I fear there's no reasonable way to do conditional dependencies like this in 
+# a gemspec.
+gem 'rb-inotify' if RUBY_PLATFORM =~ /linux/i
+gem 'libnotify' if RUBY_PLATFORM =~ /linux/i
+

data/Gemfile.lock

@@ -0,0 +1,79 @@
+PATH
+  remote: .
+  specs:
+    leadlight (0.0.1)
+      faraday
+      fattr
+      hookr
+      link_header
+      mime-types
+      multi_json
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.6)
+    archive-tar-minitar (0.5.2)
+    columnize (0.3.6)
+    diff-lcs (1.1.3)
+    fail-fast (1.0.0)
+    faraday (0.7.5)
+      addressable (~> 2.2.6)
+      multipart-post (~> 1.1.3)
+      rack (< 2, >= 1.1.0)
+    fattr (2.2.0)
+    ffi (1.0.11)
+    guard (0.10.0)
+      ffi (>= 0.5.0)
+      thor (~> 0.14.6)
+    guard-bundler (0.1.3)
+      bundler (>= 1.0.0)
+      guard (>= 0.2.2)
+    guard-rspec (0.6.0)
+      guard (>= 0.10.0)
+    hookr (1.1.1)
+      fail-fast (= 1.0.0)
+    libnotify (0.7.1)
+    linecache19 (0.5.12)
+      ruby_core_source (>= 0.1.4)
+    link_header (0.0.5)
+    mime-types (1.17.2)
+    multi_json (1.0.4)
+    multipart-post (1.1.4)
+    rack (1.4.0)
+    rb-inotify (0.8.8)
+      ffi (>= 0.5.0)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    ruby-debug-base19 (0.11.25)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.5)
+      archive-tar-minitar (>= 0.5.2)
+    thor (0.14.6)
+    vcr (2.0.0.rc1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  guard
+  guard-bundler
+  guard-rspec
+  leadlight!
+  libnotify
+  rb-inotify
+  rspec
+  ruby-debug19
+  vcr (~> 2.0.0.rc1)

data/Guardfile

@@ -0,0 +1,19 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^app/(.*)(\.erb|\.haml)$})                 { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  # Capybara request specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/requests/#{m[1]}_spec.rb" }
+end
+

data/Rakefile

@@ -0,0 +1,133 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+require 'rspec'
+require 'rspec/core/rake_task'
+
+desc "Run all specs"
+task RSpec::Core::RakeTask.new('spec')
+
+task :default => "spec"
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/leadlight.gemspec

@@ -0,0 +1,125 @@
+## This is the rakegem gemspec template. Make sure you read and understand
+## all of the comments. Some sections require modification, and others can
+## be deleted if you don't need them. Once you understand the contents of
+## this file, feel free to delete any comments that begin with two hash marks.
+## You can find comprehensive Gem::Specification documentation, at
+## http://docs.rubygems.org/read/chapter/20
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+
+  ## Leave these as is they will be modified for you by the rake gemspec task.
+  ## If your rubyforge_project name is different, then edit it and comment out
+  ## the sub! line in the Rakefile
+  s.name              = 'leadlight'
+  s.version           = '0.0.2'
+  s.date              = '2012-01-09'
+  s.rubyforge_project = 'leadlight'
+
+  ## Make sure your summary is short. The description may be as long
+  ## as you like.
+  s.summary     = "Short description used in Gem listings."
+  s.description = "Long description. Maybe copied from the README."
+
+  ## List the primary authors. If there are a bunch of authors, it's probably
+  ## better to set the email to an email list or something. If you don't have
+  ## a custom homepage, consider using your GitHub URL or the like.
+  s.authors  = ["Avdi Grimm"]
+  s.email    = 'avdi@avdi.org'
+  s.homepage = 'https://github.com/avdi/leadlight'
+
+  ## This gets added to the $LOAD_PATH so that 'lib/NAME.rb' can be required as
+  ## require 'NAME.rb' or'/lib/NAME/file.rb' can be as require 'NAME/file.rb'
+  s.require_paths = %w[lib]
+
+  ## Specify any RDoc options here. You'll want to add your README and
+  ## LICENSE files to the extra_rdoc_files list.
+  ## s.rdoc_options = ["--charset=UTF-8"]
+  ## s.extra_rdoc_files = %w[README LICENSE]
+
+  ## List your runtime dependencies here. Runtime dependencies are those
+  ## that are needed for an end user to actually USE your code.
+  ## s.add_dependency('DEPNAME', [">= 1.1.0", "< 2.0.0"])
+  s.add_dependency 'faraday'
+  s.add_dependency 'fattr'
+  s.add_dependency 'link_header'
+  s.add_dependency 'multi_json'
+  s.add_dependency 'mime-types'
+  s.add_dependency 'hookr'
+
+  ## List your development dependencies here. Development dependencies are
+  ## those that are only needed during development
+  ## s.add_development_dependency('DEVDEPNAME', [">= 1.1.0", "< 2.0.0"])
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'vcr', '~> 2.0.0.rc1'
+  s.add_development_dependency 'guard'
+  s.add_development_dependency 'guard-rspec'
+  s.add_development_dependency 'guard-bundler'
+  s.add_development_dependency 'ruby-debug19'
+
+  ## Leave this section as-is. It will be automatically generated from the
+  ## contents of your Git repository via the gemspec task. DO NOT REMOVE
+  ## THE MANIFEST COMMENTS, they are used as delimiters by the task.
+  # = MANIFEST =
+  s.files = %w[
+    Gemfile
+    Gemfile.lock
+    Guardfile
+    Rakefile
+    leadlight.gemspec
+    lib/leadlight.rb
+    lib/leadlight/blank.rb
+    lib/leadlight/codec.rb
+    lib/leadlight/enumerable_representation.rb
+    lib/leadlight/errors.rb
+    lib/leadlight/hyperlinkable.rb
+    lib/leadlight/link.rb
+    lib/leadlight/link_template.rb
+    lib/leadlight/representation.rb
+    lib/leadlight/request.rb
+    lib/leadlight/service.rb
+    lib/leadlight/service_middleware.rb
+    lib/leadlight/tint.rb
+    lib/leadlight/tint_helper.rb
+    lib/leadlight/type.rb
+    spec/cassettes/Leadlight/authorized_GitHub_example/_user/has_the_expected_content.yml
+    spec/cassettes/Leadlight/authorized_GitHub_example/_user/indicates_the_expected_oath_scopes.yml
+    spec/cassettes/Leadlight/authorized_GitHub_example/adding_and_removing_team_members.yml
+    spec/cassettes/Leadlight/authorized_GitHub_example/adding_and_removing_team_members/.yml
+    spec/cassettes/Leadlight/authorized_GitHub_example/test_team/.yml
+    spec/cassettes/Leadlight/basic_GitHub_example/_root/.yml
+    spec/cassettes/Leadlight/basic_GitHub_example/_root/__location__/.yml
+    spec/cassettes/Leadlight/basic_GitHub_example/_root/should_be_a_204_no_content.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/_root/.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/_root/__location__/.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/_root/should_be_a_204_no_content.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/_user/has_the_expected_content.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_followers/.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_followers/should_be_able_to_follow_next_link.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_followers/should_be_enumerable.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_followers/should_be_enumerable_over_page_boundaries.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_followers/should_have_next_and_last_links.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_link/exists.yml
+    spec/cassettes/Leadlight/tinted_GitHub_example/user_link/links_to_the_expected_URL.yml
+    spec/leadlight/codec_spec.rb
+    spec/leadlight/hyperlinkable_spec.rb
+    spec/leadlight/link_spec.rb
+    spec/leadlight/link_template_spec.rb
+    spec/leadlight/representation_spec.rb
+    spec/leadlight/request_spec.rb
+    spec/leadlight/service_middleware_spec.rb
+    spec/leadlight/service_spec.rb
+    spec/leadlight/tint_helper_spec.rb
+    spec/leadlight/type_spec.rb
+    spec/leadlight_spec.rb
+    spec/spec_helper_lite.rb
+    spec/support/credentials.rb
+    spec/support/vcr.rb
+  ]
+  # = MANIFEST =
+
+  ## Test files will be grabbed from the file list. Make sure the path glob
+  ## matches what you actually use.
+  s.test_files = s.files.select { |path| path =~ /^test\/test_.*\.rb/ }
+end

data/lib/leadlight.rb

@@ -0,0 +1,92 @@
+require 'faraday'
+require 'fattr'
+require 'logger'
+require 'leadlight/errors'
+require 'leadlight/link'
+require 'leadlight/hyperlinkable'
+require 'leadlight/service_middleware'
+require 'leadlight/representation'
+require 'leadlight/tint'
+require 'leadlight/type'
+require 'leadlight/service'
+require 'leadlight/enumerable_representation'
+
+
+module Leadlight
+
+  VERSION = '0.0.2'
+
+  def self.build_service(target, &block)
+    target.module_eval do
+      extend ServiceClassMethods
+      include Service
+    end
+    target.module_eval(&block)
+  end
+
+  def self.build_connection_common(&common_connection_stack)
+    @common_connection_stack = common_connection_stack
+  end
+
+  def self.common_connection_stack
+    @common_connection_stack ||= ->(builder) {
+      builder.adapter :net_http
+    }
+  end
+
+  module ServiceClassMethods
+    fattr(:tints) { default_tints }
+    fattr(:types) { []            }
+
+    def url(new_url=:none)
+      if new_url == :none
+        @url ||= Addressable::URI.parse('http://example.com')
+      else
+        @url = Addressable::URI.parse(new_url)
+      end
+    end
+
+    def session(options={})
+      sessions[options]
+    end
+
+    def sessions
+      @sessions ||= Hash.new{|h,k|
+        h[k] = new(k)
+      }
+    end
+
+    def connection_stack
+      @connection_stack ||= ->(builder){}
+    end
+
+    def default_tints
+      [
+       EnumerableRepresentation::Tint
+      ]
+    end
+
+    private
+
+    def tint(name, &block)
+      self.tints << Tint.new(name, &block)
+    end
+
+    def type(name, &block)
+      self.types << Type.new(name, self, &block)
+    end
+
+    def type_for_name(name)
+      raise_on_missing = -> do
+        raise KeyError, "Type not found: #{name}"
+      end
+      types.detect(raise_on_missing){|type| type.name.to_s == name.to_s}
+    end
+
+    def build_connection(&block)
+      @connection_stack = block
+    end
+
+  end
+
+end