comicvine 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e57f06754f14d9c6e34e4c7bb96c9dfd7f3b5a05
+  data.tar.gz: 3b7e8ee97f5e4201482545f1e55746376a24c3c0
+SHA512:
+  metadata.gz: 7ae0274f1a68527ba65c43344de16bb918d392041ea19ef79f678bd24251d9445cddf6408b974959a148fa80bfdc29607ed48738285ea6fde82261c2b178abd8
+  data.tar.gz: 28ba70a48ca692f6d17ad15aeade62684a98f3f713bc1dcf40fc0416d5f8e24e81c5417b59edb6bb19a8e34075e20839e9958e5a3e88a6ec63921909d5269d4a

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.13.6

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Holden Omans
+
+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,86 @@
+# Comicvine
+
+A ruby gem to interface with the [ComicVine API](http://comicvine.gamespot.com/api/). 
+
+Some code was built off of work by [Patrick Sharp](https://github.com/Jakanapes), you can find it [here](https://github.com/Jakanapes/ComicVine)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'comicvine'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install comicvine
+
+Then set a environmental variable named `CV_API_KEY` to your ComicVine API key **(optional)**
+
+    $ export CV_API_KEY=18357f40df87fb4a4aa6bbbb27cd8ad1deb08d3e
+
+## Usage
+
+If you did not set the env variable `CV_API_KEY` then you need to set the class `api_key` before using. If you did set the env variable you do not need to set this.
+
+```ruby
+resp = ComicVine::API.api_key = '18357f40df87fb4a4aa6bbbb27cd8ad1deb08d3e'
+```
+
+Gather response from a url:
+
+```ruby
+resp = ComicVine::API.get_details_by_url('http://comicvine.gamespot.com/api/issue/4000-371103')
+```
+
+You can also fetch lists of resources while passing API options: (see [ComicVine API Docs](http://comicvine.gamespot.com/api/documentation) for optional values)
+
+```ruby
+vol_list = ComicVine::API.get_list(:volumes, limit: 50)
+```
+
+You can fetch a more specific result by id:
+
+```ruby
+issue = ComicVine::API.get_details(:issue, '371103')
+```
+
+Performing a search:
+
+```ruby
+results = ComicVine::API.search(:volume, 'Avengers ', limit: 5)
+
+# Go to next 5 results
+results.next_page
+
+# Go to last 5 results
+results.prev_page
+```
+
+Create also create an `ComicVine::API` instance using your API key:
+
+```ruby
+api = ComicVine::API.new('18357f40df87fb4a4aa6bbbb27cd8ad1deb08d3e')
+```
+
+You can gather more detailed API information at http://rubydoc.info/gems/comicvine
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `gem install comicvine`. Or you can download it from https://rubygems.org/gems/comicvine
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/kalinon/ruby-comicvine-api.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,27 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'yard'
+
+# Test tasks
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb'] # optional
+  t.options = %w{--private} # optional
+  t.stats_options = ['--list-undoc'] # optional
+end
+
+# Default task
+task :default => :test
+
+task :gen_checksum do
+  require 'digest/sha2'
+  built_gem_path = 'pkg/comicvine-'+ComicVine::VERSION+'.gem'
+  checksum = Digest::SHA512.new.hexdigest(File.read(built_gem_path))
+  checksum_path = 'checksum/comicvine-'+ComicVine::VERSION+'.gem.sha512'
+  File.open(checksum_path, 'w' ) {|f| f.write(checksum) }
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'comicvine'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/certs/homans.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDgDCCAmigAwIBAgIBATANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxob2xk
+ZW4ub21hbnMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+A2NvbTAeFw0xNjExMDkxNTU5MTdaFw0xNzExMDkxNTU5MTdaMEMxFTATBgNVBAMM
+DGhvbGRlbi5vbWFuczEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2V7yrTuO
+4FNzWlhQL2R8Vdx5LKX/oewZ7bKh/2GJcR5R7mowdqejlfzJb7abtmYsQfyvwNfy
+NrKneghJ/rLflQ1NrlehYSYLlBFTVuymPvejG+EH5C2/RJqhm2zyfjkisasqhWk8
+Bq6IUPX1l8C78Kkd6t3QR/n3zr1Ip25NicpJ2flBMHPg3IV9qaNXywkCzutkEMoW
+FuHdHMN2cDMUnhM9qGOK7nvRk7rkP/yJAp+sf2nv+C99s5CMNuvnGeSgnX7IMcRV
+Ks2FrSvqKDj24Xf5kHdlcpDrS1VcFsAkIT6bVBm19KO8pFvZkDJE76Yshy80FRpQ
+bijjrYQhYXiM4QIDAQABo38wfTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNV
+HQ4EFgQUbbbHhJ0Z4S/c5FcDSqEVx7Yk1agwIQYDVR0RBBowGIEWaG9sZGVuLm9t
+YW5zQGdtYWlsLmNvbTAhBgNVHRIEGjAYgRZob2xkZW4ub21hbnNAZ21haWwuY29t
+MA0GCSqGSIb3DQEBBQUAA4IBAQCoC/7FnCsRFIV/rwAJRXY3Ao0qdbnksPrqUhP0
+7A8m8PccIDuUspq/WtkhzSMLZvzurlXEw1qdLtRLS2LnftQQuo5YPz6PQj4XAx8w
+yF48j5e3XvUZJiMQ+cIsXPnjes13JgnP/KOfILgfIz9ad0pGMMUCTLYahu+fXqxE
+if+otWjB2is7MBxd+krcr8vCJ4E46a8H3zyBN/tSgGw4RwkxHnXekTJvMy4skcSB
+VpDNqh/BlGMQ0mqAEuBFZFSNaroph6JLUz1ykVvQENOQLThxAjolK7SAUrdoBDOc
+fXEVP1s+hpJB6IEU8/LW016TU8WpnA+MHGfJRtkrUm/cEsWU
+-----END CERTIFICATE-----

data/checksum/comicvine-0.1.0.gem.sha512

@@ -0,0 +1 @@
+98a260c7e46e2166f400b41fc88d9da43d2f75c42712fd1f137734d20f8cebdeb101b735edb005f94cf67878d7f44c7da686775229edbc2751d0468581feed7c

data/comicvine.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'comicvine/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'comicvine'
+  spec.version       = ComicVine::VERSION
+  spec.authors       = ['Holden Omans']
+  spec.email         = ['holden.omans@gmail.com']
+
+  spec.summary       = %q{Api interface to ComicVine.  Allows for searches and returning specific information on resources.}
+  spec.description   = %q{Interface to ComicVine API}
+  spec.homepage      = 'https://github.com/kalinon/ruby-comicvine-api'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.cert_chain  = ['certs/homans.pem']
+  spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem') if $0 =~ /gem\z/
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'minitest', '~> 5.9', '>= 5.9.1'
+  spec.add_development_dependency 'minitest-reporters', '~> 1.1', '>= 1.1.12'
+  spec.add_development_dependency 'rdoc', '~> 4.2', '>= 4.2.1'
+  spec.add_development_dependency 'yard', '~> 0.9', '>= 0.9.5'
+
+  # Dependencies
+  spec.add_dependency 'rest-client', '~> 2.0'
+end

data/lib/comicvine.rb

@@ -0,0 +1,301 @@
+require 'comicvine/version'
+require 'comicvine/list'
+require 'comicvine/resource'
+require 'rest-client'
+require 'cgi'
+require 'json'
+
+## Yard Doc generation stuff
+# @!macro [new] raise.ResourceNotSupportedError
+#   @raise [ResourceNotSupportedError] indicating the resource requested is not supported
+# @!macro [new] raise.ComicVineAPIError
+#   @raise [ComicVineAPIError] indicating the api request code recived
+
+##
+# Base ComicVine module, holds default api variables
+#
+module ComicVine
+  # ComicVine api version (1.0)
+  API_VERSION = '1.0'
+
+  # Base ComicVine url
+  API_URL = 'http://comicvine.gamespot.com/api'
+
+  # ComicVine format (json)
+  API_FORMAT = 'json'
+
+  # Array of available resources
+  API_RESOURCES = [:character, :characters, :chat, :chats, :concept, :concepts, :episode, :episodes, :issue, :issues,
+                   :location, :locations, :movie, :movies, :object, :objects, :origin, :origins, :person, :people,
+                   :power, :powers, :promo, :promos, :publisher, :publishers, :series, :series_list, :search, :story_arc,
+                   :story_arcs, :team, :teams, :types, :video, :videos, :video_type, :video_types, :video_category,
+                   :video_categories, :volume, :volumes]
+  ##
+  # Class to interact and query the ComicVine API
+  # @since 0.1.0
+  class API
+
+    ##
+    # Raised when a resource is not implemented on the current API
+    #
+    # Must be included in {ComicVine::API_RESOURCES}
+    #
+    # @since 0.1.0
+    class ResourceNotSupportedError < ScriptError
+    end
+
+    ##
+    # Raised when a ComicVine API error is encountered
+    #
+    # @since 0.1.0
+    class ComicVineAPIError < ScriptError
+    end
+
+    # Hash containing ComicVine resource types and corresponding id values
+    @@types = nil
+    # Last time we pulled types from the API
+    @@last_type_check = nil
+
+    # ComicVine API Key. Set to the environmental variable CV_API_KEY by default if present
+    @@api_key = ENV['CV_API_KEY'] || nil
+
+    class << self
+
+      ##
+      # @return [ComicVine::API]
+      # @since 0.1.0
+      def new(key)
+        @@api_key=key
+        self
+      end
+
+      ##
+      # Returns ComicVine API Key. Set to the environmental variable CV_API_KEY by default if present
+      # @return [String]
+      # @since 0.1.0
+      def api_key
+        @@api_key || ENV['CV_API_KEY']
+      end
+
+      ##
+      # Sets the ComicVine API Key. Overrides the environmental variable CV_API_KEY
+      # @param key [String]
+      # @since 0.1.0
+      def api_key=(key)
+        @@api_key = key
+      end
+
+      ##
+      # Makes request for the current api version
+      #
+      # @return [String]
+      # @since 0.1.0
+      def get_api_version
+        _make_request(:types)['version'].to_s
+      end
+
+      ##
+      # Search ComicVine with the provided information
+      # @example
+      #   ComicVine::API.search(:volume, 'Avengers ', limit: 5)
+      #
+      # @param resource [Symbol] The symbol of the resource to query
+      # @param query [String] The string to query
+      # @param params [Hash] optional parameters to pass to CV API
+      # @return [ComicVine::SearchResults]
+      # @since 0.1.0
+      def search(resource, query, **params)
+        options = {
+            resources: resource.to_s,
+            query: CGI::escape(query)
+        }
+
+        options.merge! params
+
+        ComicVine::SearchResults.new(_make_request(:search, options), resource, query)
+      end
+
+      ##
+      # Returns comicvine type information
+      #
+      # @return [Hash]
+      # @since 0.1.0
+      def types
+        if @@types.nil? || (@@last_type_check + (4 * 60 * 60)) < Time.now
+          @@last_type_check = Time.now
+          @@types = _make_request(:types)['results']
+        end
+        @@types
+      end
+
+      ##
+      # Cycles through type hash to return the +resource+ hash of the matching the detail_resource_name
+      # @example
+      #   ComicVine::API.find_detail(:issue) #=> { "detail_resource_name": "issue", "list_resource_name": "issues", "id": 4000 }
+      # @param resource [Symbol] The symbol of the resource to return
+      # @return [Hash]
+      # @since 0.1.0
+      def find_detail(resource)
+        types.find { |t| t['detail_resource_name'] == resource.to_s }
+      end
+
+      ##
+      # Cycles through type hash to return the +resource+ hash of the matching the list_resource_name
+      # @example
+      #   ComicVine::API.find_list(:issues) #=> { "detail_resource_name": "issue", "list_resource_name": "issues", "id": 4000 }
+      # @param resource [Symbol] The symbol of the resource to return
+      # @return [Hash]
+      # @since 0.1.0
+      def find_list(resource)
+        types.find { |t| t['list_resource_name'] == resource.to_s }
+      end
+
+      ##
+      # Fetches provided
+      # @example
+      #   ComicVine::API.get_list(:volumes, limit: 50)
+      # @param resource [Symbol] The symbol of the resource to fetch (plural)
+      # @param params [Hash] optional parameters to pass to CV API
+      # @return [ComicVine::ResourceList]
+      # @since 0.1.0
+      def get_list(resource, **params)
+        resp = _make_request(resource, params)
+        ComicVine::ResourceList.new(resp, resource)
+      end
+
+      ##
+      # Fetches provided +resource+ with associated +id+
+      # @example
+      #   ComicVine::API.get_details(:issue, '371103')
+      # @param resource [Symbol] The symbol of the resource to fetch
+      # @param id [String] The id of the resource you would like to fetch
+      # @param params [Hash] optional parameters to pass to CV API
+      # @return [ComicVine::Resource]
+      # @since 0.1.0
+      def get_details(resource, id, **params)
+        ops_hash = {
+            id: id
+        }
+        ops_hash.merge! params
+        resp = _make_request(resource, ops_hash)
+        ComicVine::Resource.new(resp['results'])
+      end
+
+      ##
+      # Will fetch the provided +url+ as a {ComicVine::Resource}
+      # @example
+      #   ComicVine::API.get_details_by_url('http://comicvine.gamespot.com/api/issue/4000-371103')
+      # @param url [String]
+      # @return [ComicVine::Resource]
+      def get_details_by_url(url)
+        resp = _make_url_request(url)
+        ComicVine::Resource.new(resp['results'])
+      end
+
+      ##
+      # Checks missing method against the resource {@@types types} and passes it to {find_list} or {get_details}
+      def method_missing(method_sym, *arguments, &block)
+        if find_list(method_sym)
+          get_list method_sym, arguments.first
+        elsif find_detail(method_sym)
+          get_details method_sym, *arguments
+        elsif
+        super
+        end
+      end
+
+      private
+
+      ##
+      # Builds api url string based on provided +resource+ and optional +id+
+      #
+      # @example Build a url for resource +:issue+ with an id of +371103+
+      #   _build_base_url(:issue, '371103') #=> "http://comicvine.gamespot.com/api/issue/4000-371103"
+      # @example Build a url for resource +:issues+
+      #   _build_base_url(:issues) #=> "http://comicvine.gamespot.com/api/issues"
+      #
+      # @param resource [Symbol] The symbol of the resource to build the url for
+      # @param id [String] optional id for specific resource requests
+      # @return [String] Full url of the requested resource
+      # @macro raise.ResourceNotSupportedError
+      def _build_base_url(resource, id = nil)
+        if ComicVine::API_RESOURCES.include? resource
+          if !id.nil?
+            API_URL + '/' + resource.to_s + '/' + "#{self.find_detail(resource)['id']}-#{id.to_s}"
+          else
+            API_URL + '/' + resource.to_s
+          end
+        else
+          raise ResourceNotSupportedError, resource.to_s + ' is not a supported resource'
+        end
+      end
+
+      ##
+      # Executes api request based on provided +resource+ and +params+
+      #
+      # @example Return 5 results from the +:characters+ resource
+      #   _make_request(:characters, limit: 5)
+      #
+      # @param resource [Symbol] The symbol of the resource to fetch
+      # @param params [Hash] The named key value pairs of query parameters
+      # @return [Hash]
+      # @since 0.1.0
+      # @macro raise.ComicVineAPIError
+      # @macro raise.ResourceNotSupportedError
+      def _make_request(resource, **params)
+        _make_url_request(_build_base_url(resource, params[:id] || nil), params)
+      end
+
+      ##
+      # Executes api request based on provided +resource+ and +params+
+      #
+      # @example Make a simple request with +limit: 1+
+      #   _make_url_request('http://comicvine.gamespot.com/api/issues', limit: 1)
+      #
+      # @param url [String] Request url
+      # @param params [Hash] optional request parameters
+      # @return [Hash]
+      # @since 0.1.0
+      # @macro raise.ComicVineAPIError
+      def _make_url_request(url, **params)
+        # Default options hash
+        options = {
+            params: {
+                api_key: self.api_key,
+                format: ComicVine::API_FORMAT
+            }
+        }
+
+        options[:params].merge! params
+
+        begin
+          # Perform request
+          request = RestClient::Request.execute(
+              method: :get,
+              url: url,
+              timeout: 10,
+              headers: options
+          )
+            #request = RestClient.get(url, options)
+        rescue RestClient::NotFound, RestClient::Exceptions::ReadTimeout => e
+          raise ComicVineAPIError, e.message
+        end
+
+        case request.code
+          when 200
+            req = JSON.parse(request.body)
+            if req['error'].eql?('OK')
+              req
+            else
+              raise ComicVineAPIError, req['error']
+            end
+          when 420
+            raise ComicVineAPIError, 'Recived a '+request.code+' http response: You\'ve been rate limited'
+          else
+            raise ComicVineAPIError, 'Recived a '+request.code+' http response'
+        end
+      end
+
+    end
+  end
+end

data/lib/comicvine/list.rb

@@ -0,0 +1,99 @@
+module ComicVine
+
+  ##
+  # Enumerable list for multiple ComicVine results
+  # @since 0.1.0
+  class List
+    include Enumerable
+
+    attr_reader :total_count
+    attr_reader :page_count
+    attr_reader :offset
+    attr_reader :limit
+    attr_reader :cvos
+
+    def initialize(resp)
+      @total_count = resp['number_of_total_results']
+      @page_count = resp['number_of_page_results']
+      @offset = resp['offset']
+      @limit = resp['limit']
+    end
+
+    def each
+      @cvos.each { |c| yield c }
+    end
+
+    def last
+      @cvos.last
+    end
+
+    def page
+      (@offset / @limit) + 1
+    end
+
+    protected
+
+    def update_ivals(new_cvol)
+      @total_count = new_cvol.total_count
+      @offset = new_cvol.offset
+      @limit = new_cvol.limit
+
+      @cvos = new_cvol.cvos
+    end
+
+  end
+
+  ##
+  # Class container for multiple ComicVine resources
+  # @since 0.1.0
+  class ResourceList < List
+    attr_reader :resource
+
+    def initialize(resp, resc)
+      super(resp)
+
+      @resource = resc
+      @cvos = resp['results'].map { |r| ComicVine::Resource.new(r) }
+    end
+
+    def next_page
+      return nil if (@offset + @page_count) >= @total_count
+      update_ivals(ComicVine::API.send(@resource, {:limit => @limit, :offset => (@offset + @page_count)}))
+    end
+
+    def prev_page
+      return nil if @offset == 0
+      update_ivals(ComicVine::API.send(@resource, {:limit => @limit, :offset => (@offset - @page_count)}))
+    end
+  end
+
+  ##
+  # Class container for ComicVine search results
+  # @since 0.1.0
+  class SearchResults < List
+    attr_reader :resource
+    attr_reader :query
+
+    def initialize(resp, resc, query)
+      super(resp)
+
+      @resource = resc
+      @query = query
+      @cvos = resp['results'].map { |r| ComicVine::Resource.new(r) }
+    end
+
+    ##
+    # Moves search to the next offset results
+    def next_page
+      return nil if (@offset + @page_count) >= @total_count
+      update_ivals(ComicVine::API.search(@resource, @query, {:limit => @limit, :page => (((@offset + @page_count) / @limit) + 1)}))
+    end
+
+    ##
+    # Moves search to the previous offset results
+    def prev_page
+      return nil if @offset == 0
+      update_ivals(ComicVine::API.search(@resource, @query, {:limit => @limit, :page => (@offset / @limit)}))
+    end
+  end
+end

data/lib/comicvine/modules.rb

@@ -0,0 +1,194 @@
+module ComicVine
+  ##
+  # Holds the various modules for ComicVine resource attributes
+  # @since 0.1.0
+  module ResourceAttributes
+
+    ##
+    # Module to hold character resource attributes
+    # @since 0.1.0
+    module Character
+      attr_accessor :aliases, :api_detail_url, :birth, :character_enemies, :character_friends,
+                    :count_of_issue_appearances, :creators, :date_added, :date_last_updated, :deck, :description,
+                    :first_appeared_in_issue, :gender, :id, :image, :issue_credits, :issues_died_in, :movies, :name,
+                    :origin, :powers, :publisher, :real_name, :site_detail_url, :story_arc_credits, :team_enemies,
+                    :team_friends, :teams, :volume_credits
+    end
+
+    ##
+    # Module to hold chat resource attributes
+    # @since 0.1.0
+    module Chat
+      attr_accessor :api_detail_url, :channel_name, :deck, :image, :password, :site_detail_url, :title
+    end
+
+    ##
+    # Module to hold concept resource attributes
+    # @since 0.1.0
+    module Concept
+      attr_accessor :aliases, :api_detail_url, :count_of_issue_appearances, :date_added, :date_last_updated, :deck,
+                    :description, :first_appeared_in_issue, :id, :image, :issue_credits, :movies, :name,
+                    :site_detail_url, :start_year, :volume_credits
+    end
+
+    ##
+    # Module to hold episode resource attributes
+    # @since 0.1.0
+    module Episode
+      attr_accessor :aliases, :api_detail_url, :character_credits, :characters_died_in, :concept_credits, :air_date,
+                    :date_added, :date_last_updated, :deck, :description, :first_appearance_characters,
+                    :first_appearance_concepts, :first_appearance_locations, :first_appearance_objects,
+                    :first_appearance_storyarcs, :first_appearance_teams, :has_staff_review, :id, :image,
+                    :episode_number, :location_credits, :name, :object_credits, :person_credits, :site_detail_url,
+                    :story_arc_credits, :team_credits, :series
+    end
+
+    ##
+    # Module to hold issue resource attributes
+    # @since 0.1.0
+    module Issue
+      attr_accessor :aliases, :api_detail_url, :character_credits, :characters_died_in, :concept_credits, :cover_date,
+                    :date_added, :date_last_updated, :deck, :description, :disbanded_teams,
+                    :first_appearance_characters, :first_appearance_concepts, :first_appearance_locations,
+                    :first_appearance_objects, :first_appearance_storyarcs, :first_appearance_teams, :has_staff_review,
+                    :id, :image, :issue_number, :location_credits, :name, :object_credits, :person_credits,
+                    :site_detail_url, :store_date, :story_arc_credits, :team_credits, :teams_disbanded_in, :volume
+    end
+
+    ##
+    # Module to hold location resource attributes
+    # @since 0.1.0
+    module Location
+      attr_accessor :aliases, :api_detail_url, :count_of_issue_appearances, :date_added, :date_last_updated, :deck,
+                    :description, :first_appeared_in_issue, :id, :image, :issue_credits, :movies, :name,
+                    :site_detail_url, :start_year, :story_arc_credits, :volume_credits
+    end
+
+    ##
+    # Module to hold movie resource attributes
+    # @since 0.1.0
+    module Movie
+      attr_accessor :api_detail_url, :box_office_revenue, :budget, :characters, :concepts, :date_added,
+                    :date_last_updated, :deck, :description, :distributor, :has_staff_review, :id, :image, :locations,
+                    :name, :producers, :rating, :release_date, :runtime, :site_detail_url, :studios, :teams, :things,
+                    :total_revenue, :writers
+    end
+
+    ##
+    # Module to hold object resource attributes
+    # @since 0.1.0
+    module Object
+      attr_accessor :aliases, :api_detail_url, :count_of_issue_appearances, :date_added, :date_last_updated, :deck,
+                    :description, :first_appeared_in_issue, :id, :image, :issue_credits, :movies, :name,
+                    :site_detail_url, :start_year, :story_arc_credits, :volume_credits
+    end
+
+    ##
+    # Module to hold origin resource attributes
+    # @since 0.1.0
+    module Origin
+      attr_accessor :api_detail_url, :character_set, :id, :name, :profiles, :site_detail_url
+    end
+
+    ##
+    # Module to hold person resource attributes
+    # @since 0.1.0
+    module Person
+      attr_accessor :aliases, :api_detail_url, :birth, :count_of_issue_appearances, :country, :created_characters,
+                    :date_added, :date_last_updated, :death, :deck, :description, :email, :gender, :hometown, :id,
+                    :image, :issue_credits, :name, :site_detail_url, :story_arc_credits, :volume_credits, :website
+    end
+
+    ##
+    # Module to hold power resource attributes
+    # @since 0.1.0
+    module Power
+      attr_accessor :attr_accessor, :aliases, :api_detail_url, :characters, :date_added, :date_last_updated,
+                    :description, :id, :name, :site_detail_url
+    end
+
+    ##
+    # Module to hold promo resource attributes
+    # @since 0.1.0
+    module Promo
+      attr_accessor :api_detail_url, :date_added, :deck, :id, :image, :link, :name, :resource_type, :user
+    end
+
+    ##
+    # Module to hold publisher resource attributes
+    # @since 0.1.0
+    module Publisher
+      attr_accessor :aliases, :api_detail_url, :characters, :date_added, :date_last_updated, :deck, :description, :id,
+                    :image, :location_address, :location_city, :location_state, :name, :site_detail_url, :story_arcs,
+                    :teams, :volumes
+    end
+    ##
+    # Module to hold series resource attributes
+    # @since 0.1.0
+    module Series
+      attr_accessor :aliases, :api_detail_url, :character_credits, :count_of_episodes, :date_added, :date_last_updated,
+                    :deck, :description, :first_episode, :id, :image, :last_episode, :location_credits, :name,
+                    :publisher, :site_detail_url, :start_year
+    end
+
+    ##
+    # Module to hold story_arc resource attributes
+    # @since 0.1.0
+    module StoryArc
+      attr_accessor :aliases, :api_detail_url, :count_of_issue_appearances, :date_added, :date_last_updated, :deck,
+                    :description, :first_appeared_in_issue, :id, :image, :issues, :movies, :name, :publisher,
+                    :site_detail_url
+    end
+
+    ##
+    # Module to hold team resource attributes
+    # @since 0.1.0
+    module Team
+      attr_accessor :aliases, :api_detail_url, :character_enemies, :character_friends, :characters,
+                    :count_of_issue_appearances, :count_of_team_members, :date_added, :date_last_updated, :deck,
+                    :description, :disbanded_in_issues, :first_appeared_in_issue, :id, :image, :issue_credits,
+                    :issues_disbanded_in, :movies, :name, :publisher, :site_detail_url, :story_arc_credits,
+                    :volume_credits
+    end
+
+    ##
+    # Module to hold type resource attributes
+    # @since 0.1.0
+    module Type
+      attr_accessor :detail_resource_name, :list_resource_name, :id
+    end
+
+    ##
+    # Module to hold video resource attributes
+    # @since 0.1.0
+    module Video
+      attr_accessor :api_detail_url, :deck, :hd_url, :high_url, :id, :image, :length_seconds, :low_url, :name,
+                    :publish_date, :site_detail_url, :url, :user
+    end
+
+    ##
+    # Module to hold video_category resource attributes
+    # @since 0.1.0
+    module VideoCategory
+      attr_accessor :api_detail_url, :deck, :id, :name, :site_detail_url
+    end
+
+    ##
+    # Module to hold video_type resource attributes
+    # @since 0.1.0
+    module VideoType
+      attr_accessor :api_detail_url, :deck, :id, :name, :site_detail_url
+    end
+
+    ##
+    # Module to hold volume resource attributes
+    # @since 0.1.0
+    module Volume
+      attr_accessor :aliases, :api_detail_url, :character_credits, :concept_credits, :count_of_issues, :date_added,
+                    :date_last_updated, :deck, :description, :first_issue, :id, :image, :last_issue, :location_credits,
+                    :name, :object_credits, :person_credits, :publisher, :site_detail_url, :start_year, :team_credits
+    end
+
+  end
+end
+

data/lib/comicvine/resource.rb

@@ -0,0 +1,53 @@
+module ComicVine
+
+  ##
+  # Class container for a singular ComicVine resource
+  # @since 0.1.0
+  class Resource
+
+    def initialize(args)
+      args.each do |k, v|
+        # Add an attribute reader for each key
+        # noinspection RubyResolve
+        self.class.class_eval { attr_reader k } unless self.respond_to? k
+
+        # Convert sub arrays to objects
+        v.collect! { |i| Resource.new i } if v.kind_of?(Array) && !v.empty? && v.first.key?('api_detail_url')
+
+        # Convert sub hashes to objects
+        v = Resource.new v if v.kind_of?(Hash) && v.key?('api_detail_url')
+
+        # Set the instance variable to value
+        instance_variable_set "@#{k}", v
+      end
+    end
+
+    # @return [ComicVine::Resource]
+    def fetch
+      ComicVine::API.get_details_by_url(self.api_detail_url)
+    end
+
+    # @private
+    def method_missing(method_sym, *arguments, &block)
+      if method_sym.to_s =~ /^get_(.*)$/
+        key = method_sym.to_s.sub 'get_', ''
+        if instance_variable_defined?("@#{key}")
+          item = instance_variable_get("@#{key}")
+          if item.kind_of?(Array) && item.first.kind_of?(Resource)
+            res = []
+            item.each do |i|
+              res << i.fetch
+            end
+            return res
+          end
+          if item.kind_of?(Resource)
+            return item.fetch
+          end
+        else
+          super
+        end
+      elsif super
+      end
+    end
+  end
+end

data/lib/comicvine/version.rb

@@ -0,0 +1,4 @@
+module ComicVine
+  # Current gem version number
+  VERSION = '0.1.1'
+end

metadata

@@ -0,0 +1,206 @@
+--- !ruby/object:Gem::Specification
+name: comicvine
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Holden Omans
+autorequire: 
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDgDCCAmigAwIBAgIBATANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxob2xk
+  ZW4ub21hbnMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+  A2NvbTAeFw0xNjExMDkxNTU5MTdaFw0xNzExMDkxNTU5MTdaMEMxFTATBgNVBAMM
+  DGhvbGRlbi5vbWFuczEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2V7yrTuO
+  4FNzWlhQL2R8Vdx5LKX/oewZ7bKh/2GJcR5R7mowdqejlfzJb7abtmYsQfyvwNfy
+  NrKneghJ/rLflQ1NrlehYSYLlBFTVuymPvejG+EH5C2/RJqhm2zyfjkisasqhWk8
+  Bq6IUPX1l8C78Kkd6t3QR/n3zr1Ip25NicpJ2flBMHPg3IV9qaNXywkCzutkEMoW
+  FuHdHMN2cDMUnhM9qGOK7nvRk7rkP/yJAp+sf2nv+C99s5CMNuvnGeSgnX7IMcRV
+  Ks2FrSvqKDj24Xf5kHdlcpDrS1VcFsAkIT6bVBm19KO8pFvZkDJE76Yshy80FRpQ
+  bijjrYQhYXiM4QIDAQABo38wfTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNV
+  HQ4EFgQUbbbHhJ0Z4S/c5FcDSqEVx7Yk1agwIQYDVR0RBBowGIEWaG9sZGVuLm9t
+  YW5zQGdtYWlsLmNvbTAhBgNVHRIEGjAYgRZob2xkZW4ub21hbnNAZ21haWwuY29t
+  MA0GCSqGSIb3DQEBBQUAA4IBAQCoC/7FnCsRFIV/rwAJRXY3Ao0qdbnksPrqUhP0
+  7A8m8PccIDuUspq/WtkhzSMLZvzurlXEw1qdLtRLS2LnftQQuo5YPz6PQj4XAx8w
+  yF48j5e3XvUZJiMQ+cIsXPnjes13JgnP/KOfILgfIz9ad0pGMMUCTLYahu+fXqxE
+  if+otWjB2is7MBxd+krcr8vCJ4E46a8H3zyBN/tSgGw4RwkxHnXekTJvMy4skcSB
+  VpDNqh/BlGMQ0mqAEuBFZFSNaroph6JLUz1ykVvQENOQLThxAjolK7SAUrdoBDOc
+  fXEVP1s+hpJB6IEU8/LW016TU8WpnA+MHGfJRtkrUm/cEsWU
+  -----END CERTIFICATE-----
+date: 2016-11-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.9.1
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.12
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.2.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Interface to ComicVine API
+email:
+- holden.omans@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- certs/homans.pem
+- checksum/comicvine-0.1.0.gem.sha512
+- comicvine.gemspec
+- lib/comicvine.rb
+- lib/comicvine/list.rb
+- lib/comicvine/modules.rb
+- lib/comicvine/resource.rb
+- lib/comicvine/version.rb
+homepage: https://github.com/kalinon/ruby-comicvine-api
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Api interface to ComicVine.  Allows for searches and returning specific information
+  on resources.
+test_files: []