http_magic 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ae2f80540b2ebc639265dd8a2b4afffa39b72f27
+  data.tar.gz: 38ed7512bca5927a8961ce9279e85b61521902ad
+SHA512:
+  metadata.gz: 0b9c6a898d4172ef774bc79e46a8b714d137270a0022bb3cf09f97d68b6b02e180d151b4d736bd9884b9e010cf8755b9e39c054a9ac95d82584b4f6b1fe4ae84
+  data.tar.gz: 53da0b3b6cdf245d2afcaefd1e0f8c3ab3a4e6522d3e344a1585cf14364a55c774d7ee4492e861bf4f4bb4c62d34b3a8c1d7dae6cc235e80ef2750329b3e9a99

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    http_magic (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    coderay (1.1.0)
+    columnize (0.3.6)
+    crack (0.4.1)
+      safe_yaml (~> 0.9.0)
+    debugger (1.6.5)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.3.1)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.3.1)
+    method_source (0.8.2)
+    minitest (4.7.5)
+    pry (0.9.12.4)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-debugger (0.2.2)
+      debugger (~> 1.3)
+      pry (~> 0.9.10)
+    rake (10.1.1)
+    safe_yaml (0.9.7)
+    slop (3.4.7)
+    webmock (1.16.1)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  http_magic!
+  minitest (~> 4.7.0)
+  pry
+  pry-debugger
+  rake
+  webmock (~> 1.16.0)

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 GradesFirst
+
+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,2 @@
+httpmagic
+=========

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.test_files = FileList["test/**/*.rb"].exclude("test/test_helper.rb")
+  test.verbose = false
+  test.warning = false
+end

data/http_magic.gemspec

@@ -0,0 +1,23 @@
+
+Gem::Specification.new do |s|
+  s.name = 'http_magic'
+  s.version = '0.1.1'
+  s.licenses = ['MIT']
+  s.summary = 'Provides a more Object Oriented interface to RESTful apis.'
+
+  s.author = 'GradesFirst'
+  s.email = 'tech@gradesfirst.com'
+  s.homepage = 'https://github.com/Thoughtwright-LLC/httpmagic'
+
+  s.files = Dir['{lib}/**/*.rb', 'bin/*', 'LICENSE', '*.md']
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test}/*`.split("\n")
+
+  s.require_paths = ['lib']
+
+  s.add_development_dependency 'rake', '~> 0'
+  s.add_development_dependency 'minitest', '~> 4.7'
+  s.add_development_dependency 'webmock', '~> 1.16'
+  s.add_development_dependency 'pry', '~> 0'
+  s.add_development_dependency 'pry-debugger', '~> 0'
+end

data/lib/http_magic.rb

@@ -0,0 +1,4 @@
+require 'http_magic/api'
+
+module HttpMagic
+end

data/lib/http_magic/api.rb

@@ -0,0 +1,218 @@
+require 'json'
+require 'http_magic/uri'
+require 'http_magic/request'
+
+module HttpMagic
+  # A magical class that interacts with HTTP resources with a minimal amount of
+  # configuration.
+  #
+  # Assuming an api where the url http://www.example.com/api/v1/foo/99 responds
+  # with the following.
+  #
+  # Header:
+  #
+  #   Content-Type: application/json
+  #
+  # Body:
+  #
+  #   {
+  #     "name": "Foo Bar"
+  #   }
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic::Api
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #     headers({'X-AuthToken' => 'token'})
+  #   end
+  #
+  #   ExampleApi.foo[99].get['name']
+  #   => "Foo Bar"
+  #
+  #   ExampleApi.foo.create.post(name: 'New Foo')
+  #   => { 'name' => 'New Foo' }
+  class Api < BasicObject
+    # Makes the new method private so that instances of this class and it's
+    # children can only be instantiated through the class method method_missing.
+    # This is needed to enforce the intended usage of HttpMagic where the class
+    # is configured to represent an http location. Once it is configured, the
+    # location is interacted with dynamically with chained methods that correspond
+    # with parts of URNs found at the location.
+    class << self
+      private :new
+    end
+
+    # Sets or returns the request headers for an HttpMagic based class. The
+    # headers will be passed along to each resource request being made.
+    #
+    # == Example
+    #
+    #   class ExampleApi < HttpMagic:Api
+    #     url 'www.example.com'
+    #     headers({'X-AuthToken' => 'token'})
+    #   end
+    def self.headers(value = :not_provided)
+      unless value == :not_provided
+        @headers = value
+      end
+      @headers
+    end
+
+    # Sets or returns the namespace for an HttpMagic based class. The namespace
+    # will be prefixed to the urn for each request made to the url.
+    #
+    # Assuming an api where each resource is namespaced with 'api/v1' and where
+    # the url http://www.example.com/api/v1/foo/99 responds with the following.
+    #
+    # Header:
+    #
+    #   Content-Type: application/json
+    #
+    # Body:
+    #
+    #   {
+    #     "name": "Foo Bar"
+    #   }
+    #
+    # == Example
+    #
+    #   class ExampleApi < HttpMagic:Api
+    #     url 'www.example.com'
+    #     namespace 'api/v1'
+    #   end
+    #
+    #   ExampleApi.foo[99].get['name']
+    #   => "Foo Bar"
+    #
+    def self.namespace(value = :not_provided)
+      unless value == :not_provided
+        @namespace = value
+      end
+      @namespace
+    end
+
+    # Sets or returns the uniform resource locator for the HTTP resource.
+    #
+    # == Example
+    #
+    #   class ExampleApi < HttpMagic::Api
+    #     url 'www.example.com'
+    #   end
+    def self.url(value = :not_provided)
+      unless value == :not_provided
+        @url = value
+      end
+      @url
+    end
+
+    # Class scoped method_missing that starts the magic of creating urns
+    # through meta programming by instantiating an instance of the class
+    # and delegating the first part of the urn to that instance. This method
+    # is an implementation of the Factory Method design pattern.
+    def self.method_missing(name, *args, &block)
+      new(@url, @namespace, @headers).__send__(name, *args)
+    end
+
+    def initialize(url, namespace, headers)
+      @uri = Uri.new(url)
+      @uri.namespace = namespace
+      @headers = headers
+    end
+
+    # Resource index reference intended to allow for the use of numbers in a urn
+    # such as the following 'foo/99' being referenced by ExampleApi.foo[99].  It
+    # can also be used to allow for HttpMagic methods to be specified for a urn
+    # such as 'foo/get' being referenced by ExampleApi.foo[:get]. Finally, it can
+    # be used for urn parts that are not valid Ruby methods such as 'foo/%5B%5D'
+    # being referenced by ExampleApi.foo["%5B%5D"].
+    #
+    # * part - a part of a urn such that 'foo' and 'bar' would be parts of the urn
+    #   'foo/bar'.
+    #
+    # Returns a reference to its instance so that urn parts can be chained
+    # together.
+    def [](part)
+      @uri.parts << part.to_s
+      self
+    end
+
+    # Gets a resource from the URI and returns it based on its content type.
+    # JSON content will be parsed and returned as equivalent Ruby objects. All
+    # other content types will be returned as text.
+    #
+    # Assuming an api where each resource is namespaced with 'api/v1' and where
+    # the url http://www.example.com/api/v1/foo/99 responds with the following.
+    #
+    # Header:
+    #
+    #   Content-Type: application/json
+    #
+    # Body:
+    #
+    #   {
+    #     "name": "Foo Bar"
+    #   }
+    #
+    # == Example
+    #
+    #   class ExampleApi < HttpMagic::Api
+    #     url 'www.example.com'
+    #     namespace 'api/v1'
+    #   end
+    #
+    #   ExampleApi.foo[99].get
+    #   => { "name" => "Foo Bar" }
+    def get
+      request = Request.new(@uri,
+        headers: @headers
+      )
+      request.get
+    end
+
+    # POST's a resource from the URI and returns the result based on its content
+    # type. JSON content will be parsed and returned as equivalent Ruby objects.
+    # All other content types will be returned as text.
+    #
+    # Assuming an api where each resource is namespaced with 'api/v1' and where
+    # the url http://www.example.com/api/v1/foo/create responds with the
+    # following when a 'name' is sent with the request.
+    #
+    # Header:
+    #
+    #   Content-Type: application/json
+    #
+    # Body:
+    #
+    #   {
+    #     "name": "New Foo"
+    #   }
+    #
+    # == Example
+    #
+    #   class ExampleApi < HttpMagic::Api
+    #     url 'www.example.com'
+    #     namespace 'api/v1'
+    #   end
+    #
+    #   ExampleApi.foo.create.post(name: 'New Foo')
+    #   => { "name" => "New Foo" }
+    def post(data = {})
+      request = Request.new(@uri,
+        headers: @headers,
+        data: data,
+      )
+      request.post
+    end
+
+    # Instance scoped method_missing that accumulates the URN parts used in
+    # forming the URI. It returns a reference to the current instance so that
+    # method and [] based parts can be chained together to from the URN. In the
+    # case of ExampleApi.foo[99] the 'foo' method is accumlated as a URN part
+    # that will form the resulting URI.
+    def method_missing(part, *args, &block)
+      @uri.parts << part.to_s
+      self
+    end
+  end
+end

data/lib/http_magic/request.rb

@@ -0,0 +1,82 @@
+require 'net/http'
+require 'json'
+
+module HttpMagic
+  # Encapsulating class to hold all of the infrastructure to make the actual
+  # requests to the api. It receives at a minimum a HttpMagic::Uri object which
+  # manages the url building.
+  #
+  # == Example
+  #
+  #   uri_object = HttpMagic::Uri.new('http://example.com')
+  #
+  #   request = Request.new(uri_object)
+  #
+  #   request.get
+  #   => { 'name' => 'Foo Bar' }
+  class Request
+    def initialize(uri, options = {})
+      @uri = uri
+      @data = options[:data] || {}
+      @options = {
+        headers: options[:headers] || {}
+      }
+    end
+
+    # Makes a GET request to the url provided by the Uri object and returns the
+    # resulting JSON data as a Ruby hash.
+    #
+    # == Example
+    #
+    #   uri_object = HttpMagic::Uri.new('http://example.com')
+    #
+    #   request = Request.new(uri_object)
+    #
+    #   request.get
+    #   => { 'name' => 'Foo Bar' }
+    def get
+      send_request :get
+    end
+
+    # Makes a POST request to the url provided by the Uri object and returns the
+    # resulting JSON data as a Ruby hash. If data was provided as an optional
+    # initialization parameter, then that is also POSTed.
+    #
+    # == Example
+    #
+    #   uri_object = HttpMagic::Uri.new('http://example.com')
+    #
+    #   request = Request.new(uri_object, data: { name: 'New Foo' })
+    #
+    #   request.post
+    def post
+      if !@data.empty?
+        @options[:headers].merge!( 'content-type' => 'application/json' )
+      end
+
+      send_request :post
+    end
+
+    private
+
+    def http
+      return @http unless @http.nil?
+      @http = Net::HTTP.new(@uri.domain, 443)
+      @http.use_ssl = true
+      @http
+    end
+
+    def send_request(method)
+      response = http.send_request(method, @uri.urn, @data.to_json, @options[:headers])
+      if response && response.is_a?(Net::HTTPSuccess)
+        if response.content_type == 'application/json'
+          JSON.parse(response.body)
+        else
+          response.body
+        end
+      else
+        nil
+      end
+    end
+  end
+end

data/lib/http_magic/uri.rb

@@ -0,0 +1,74 @@
+
+module HttpMagic
+  # Helper class that holds the parts of the URI and provides methods to put
+  # them together.
+  #
+  # == Example
+  #
+  #   uri = HttpMagic::Uri.new('example.com')
+  #   uri.build
+  #   => "https://example.com/"
+  #
+  #   uri.namespace = 'api/v2'
+  #   uri.build
+  #   => "https://example.com/api/v2"
+  #
+  #   uri.parts = ['path']
+  #   uri.build
+  #   => "https://example.com/api/v2/path"
+  #
+  class Uri
+    attr_accessor :namespace, :parts
+
+    attr_reader :domain
+
+    def initialize(domain)
+      @domain = domain
+      @parts = []
+    end
+
+    # Builds a full uniform resource identifier.
+    #
+    # == Example
+    #
+    #   uri = HttpMagic::Uri.new('example.com')
+    #   uri.namespace = 'api/v1'
+    #   uri.parts = %w(foo bar)
+    #
+    #   uri.urn
+    #   => "https://example.com/api/v1/foo/bar"
+    def build
+      "#{url}#{urn}"
+    end
+
+    # Uniform resource locator based on @domain value.
+    #
+    # == Example
+    #
+    #   uri = HttpMagic::Uri.new('example.com')
+    #
+    #   uri.url
+    #   => "https://example.com/"
+    #
+    #   uri.url(false)
+    #   => "https://example.com"
+    def url
+      "https://#{@domain}"
+    end
+
+    # Uniform resource name for a resource.
+    #
+    # == Example
+    #
+    #   uri = HttpMagic::Uri.new('example.com')
+    #   uri.namespace = 'api/v1'
+    #   uri.parts = %w(foo bar)
+    #
+    #   uri.urn
+    #   => "/api/v1/foo/bar"
+    def urn
+      resource_name = [@namespace, @parts].flatten.compact.join('/')
+      "/#{resource_name}"
+    end
+  end
+end

data/test/api/get_test.rb

@@ -0,0 +1,68 @@
+require 'test_helper'
+require 'http_magic'
+
+class HttpMagicTest < HttpMagic::Api
+end
+
+describe 'HttpMagic#get' do
+  before do
+    @url = HttpMagicTest.url 'www.example.com'
+    HttpMagicTest.namespace nil
+    HttpMagicTest.headers nil
+  end
+
+  it 'should return the root response' do
+    stub_request(:get, "https://#{@url}:443").
+      to_return(body: 'I am root!!')
+
+    assert_equal(
+      'I am root!!',
+      HttpMagicTest.get
+    )
+  end
+
+  it 'should return the named resource' do
+    stub_request(:get, "https://#{@url}:443/bar").
+      to_return(body: 'A bear walked into a bar...')
+
+    assert_equal(
+      'A bear walked into a bar...',
+      HttpMagicTest.bar.get
+    )
+  end
+
+  it 'should return the named resource' do
+    stub_request(:get,  "https://#{@url}:443/bar/84").
+      to_return(body: 'Where Everybody Knows Your Name')
+
+    assert_equal(
+      'Where Everybody Knows Your Name',
+      HttpMagicTest.bar[84].get
+    )
+  end
+
+  it 'should serialize JSON objects' do
+    stub_request(:get,  "https://#{@url}:443/bar/99").
+      to_return(
+        headers: { 'Content-Type' => 'application/json' },
+        body: fixture_file('projects.json')
+      )
+
+    assert_equal(
+      'GradesFirst',
+      HttpMagicTest.bar[99].get.first['name']
+    )
+  end
+
+  it 'should provide specified headers' do
+    stub_request(:get,  "https://#{@url}:443/bar/84").
+      with(headers: { 'X-AuthToken' => 'test_token' }).
+      to_return(body: 'Where Everybody Knows Your Name')
+
+    HttpMagicTest.headers({ 'X-AuthToken' => 'test_token' })
+    assert_equal(
+      'Where Everybody Knows Your Name',
+      HttpMagicTest.bar[84].get
+    )
+  end
+end

data/test/api/post_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+require 'http_magic'
+
+class HttpMagicTest < HttpMagic::Api
+end
+
+describe 'HttpMagic#post' do
+  before do
+    @url = HttpMagicTest.url 'www.example.com'
+    HttpMagicTest.namespace nil
+    HttpMagicTest.headers nil
+  end
+
+  it 'should send POST request' do
+    stub_post = stub_request(:post, "https://#{@url}")
+
+    HttpMagicTest.post
+    assert_requested stub_post
+  end
+
+  it 'should send data with POST request' do
+    expected_data = {
+      apple: 'sauce',
+      banana: 'bread'
+    }
+    stub_post = stub_request(:post, "https://#{@url}/foo").with(
+      body: expected_data
+    )
+
+    HttpMagicTest.foo.post(expected_data)
+
+    assert_requested stub_post
+  end
+end

data/test/fixtures/projects.json

@@ -0,0 +1,66 @@
+[
+  {
+    "atom_enabled": false,
+    "version": 91975,
+    "name": "GradesFirst",
+    "velocity_averaged_over": 3,
+    "kind": "project",
+    "created_at": "2009-03-13T21:43:45Z",
+    "has_google_domain": false,
+    "point_scale_is_custom": false,
+    "current_iteration_number": 123,
+    "start_date": "2012-11-12",
+    "number_of_done_iterations_to_show": 4,
+    "updated_at": "2013-11-21T05:39:11Z",
+    "enable_incoming_emails": true,
+    "initial_velocity": 10,
+    "enable_following": true,
+    "account_id": 277647,
+    "start_time": "2009-03-16T05:00:00Z",
+    "enable_tasks": true,
+    "enable_planned_mode": true,
+    "week_start_day": "Monday",
+    "iteration_length": 2,
+    "time_zone": {
+      "kind": "time_zone",
+      "olson_name": "America/Chicago",
+      "offset": "-06:00"
+    },
+    "id": 10688,
+    "bugs_and_chores_are_estimatable": true,
+    "public": false,
+    "point_scale": "0,1,2,3,5,8"
+  },
+  {
+    "atom_enabled": false,
+    "version": 91975,
+    "name": "Technical",
+    "velocity_averaged_over": 3,
+    "kind": "project",
+    "created_at": "2009-03-13T21:43:45Z",
+    "has_google_domain": false,
+    "point_scale_is_custom": false,
+    "current_iteration_number": 123,
+    "start_date": "2012-11-12",
+    "number_of_done_iterations_to_show": 4,
+    "updated_at": "2013-11-21T05:39:11Z",
+    "enable_incoming_emails": true,
+    "initial_velocity": 10,
+    "enable_following": true,
+    "account_id": 277647,
+    "start_time": "2009-03-16T05:00:00Z",
+    "enable_tasks": true,
+    "enable_planned_mode": true,
+    "week_start_day": "Monday",
+    "iteration_length": 2,
+    "time_zone": {
+      "kind": "time_zone",
+      "olson_name": "America/Chicago",
+      "offset": "-06:00"
+    },
+    "id": 10687,
+    "bugs_and_chores_are_estimatable": true,
+    "public": false,
+    "point_scale": "0,1,2,3,5,8"
+  }
+]

data/test/request_test.rb

@@ -0,0 +1,63 @@
+require 'test_helper'
+require 'http_magic/uri'
+require 'http_magic/request'
+
+describe 'HttpMagic::Request' do
+  before do
+    @domain = 'example.com'
+    @uri = HttpMagic::Uri.new(@domain)
+  end
+
+  it 'should make a request' do
+    stub_request = stub_request(
+      :get,
+      "https://#{@domain}/api/v2/path/to/something"
+    )
+
+    @uri.namespace = 'api/v2'
+    @uri.parts = ['path', 'to', 'something']
+    request = HttpMagic::Request.new(@uri)
+    request.get
+
+    assert_requested stub_request
+  end
+
+  it 'should return content on request' do
+    content = 'This is SPARTA!'
+    stub_request(:get, "https://#{@domain}").
+      to_return(body: content)
+
+    request = HttpMagic::Request.new(@uri)
+
+    assert_equal content, request.get
+  end
+
+  it 'should be able to post data as hash' do
+    expected_data = {
+      apple: 'crispy',
+      banana: 'soft'
+    }
+    stub_request = stub_request(:post, "https://#{@domain}").with(
+      body: expected_data.to_json,
+      headers: { 'content-type' => 'application/json' }
+    )
+
+    request = HttpMagic::Request.new(@uri, data: expected_data)
+    request.post
+
+    assert_requested stub_request
+  end
+
+  it 'should set correct headers' do
+    stub_request = stub_request(:get,  "https://#{@domain}").
+      with(headers: { 'X-AuthToken' => 'test_token' })
+
+    request = HttpMagic::Request.new(
+      @uri,
+      headers: { 'X-AuthToken' => 'test_token' }
+    )
+    request.get
+
+    assert_requested stub_request
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,18 @@
+$LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
+
+require 'rubygems'
+gem 'minitest' if RUBY_VERSION > '1.9'
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'pry'
+
+# Retreive the contents of fixture files to be used in tests.  It is easier
+# to view, modify and visualize text used in tests when it is stored in files.
+# Also, it is much easier to reuse that text.
+def fixture_file(file_name)
+  File.open(fixture_file_path(file_name), 'rb').read
+end
+
+def fixture_file_path(file_name)
+  File.join(File.dirname(__FILE__), 'fixtures', file_name)
+end

data/test/uri_test.rb

@@ -0,0 +1,49 @@
+require 'test_helper'
+require 'http_magic/uri'
+
+describe 'HttpMagic::Uri' do
+  before do
+    @domain = 'example.com'
+    @uri = uri = HttpMagic::Uri.new(@domain)
+  end
+
+  it 'must have a domain param' do
+    assert_raises ArgumentError do
+      HttpMagic::Uri.new
+    end
+  end
+
+  it 'should return the domain' do
+    assert_equal @domain, @uri.domain
+  end
+
+  it 'can build a simple uri' do
+    assert_equal "https://#{@domain}/", @uri.build
+  end
+
+  it 'should have url' do
+    assert_equal "https://#{@domain}", @uri.url
+  end
+
+  it 'should create urn with parts' do
+    @uri.parts = ['path', 'to', 'something']
+    assert_equal '/path/to/something', @uri.urn
+  end
+
+  it 'should create urn with namespace' do
+    @uri.namespace = 'api/v2'
+    assert_equal '/api/v2', @uri.urn
+  end
+
+  it 'should create urn with namespace and parts combined' do
+    @uri.parts = ['path', 'to', 'something']
+    @uri.namespace = 'api/v2'
+    assert_equal '/api/v2/path/to/something', @uri.urn
+  end
+
+  it 'should create the full uri with urn included' do
+    @uri.parts = ['path', 'to', 'something']
+    @uri.namespace = 'api/v2'
+    assert_equal "https://#{@domain}/api/v2/path/to/something", @uri.build
+  end
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: http_magic
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- GradesFirst
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-17 00:00:00.000000000 Z
+dependencies:
+- !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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: pry-debugger
+  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: 
+email: tech@gradesfirst.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- http_magic.gemspec
+- lib/http_magic.rb
+- lib/http_magic/api.rb
+- lib/http_magic/request.rb
+- lib/http_magic/uri.rb
+- test/api/get_test.rb
+- test/api/post_test.rb
+- test/fixtures/projects.json
+- test/request_test.rb
+- test/test_helper.rb
+- test/uri_test.rb
+homepage: https://github.com/Thoughtwright-LLC/httpmagic
+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.2.1
+signing_key: 
+specification_version: 4
+summary: Provides a more Object Oriented interface to RESTful apis.
+test_files: []