printful_api 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ab40c8602c1fed1d573a8fa4d72a4f30142534df
+  data.tar.gz: c5f7c5ba10a4096a227fb446dd4977dd1dc2ea08
+SHA512:
+  metadata.gz: 255311dbf606b5cf05ddb6b3b5a22dc2fd1854491bc57332952dfa5f78b80d8bb540cd65db6764a06daa72df963ea50bbc21eea5e390758fb6e2fe85d3120375
+  data.tar.gz: 294b885561272ac8aa28ea013baef04f7c006aaf2357629a292d6752b7f02495483c1af97eba857a224b022160eec61e0c0f149647b41db3b2d992068bc43371

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development do
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017- Groundswell Enterprises (http://www.groundswellenterprises.com)
+
+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,211 @@
+# Printful API Ruby Bindings
+
+The Printful API gem provides a ruby bindings SDK for quick and easy access to
+the Printful service.  Printful is a online company that will print custom
+designs onto a variety of different apparel/accessories, then ship that item
+with custom packaging directly to your customer.  Printful make custom:
+
+* T-shirts
+* Sweatshirts
+* Wall art (prints, posters, canvas, ...)
+* Mugs
+* Pillows
+* Totes
+* Hats
+* Leggings
+* Phone Cases
+* Socks
+* Dresses
+* Skirts
+* and more
+
+[Sign up here](https://printful.com/a/amrap) to explore the full list of products, start creating,
+previewing, and selling your designs.
+
+We provide a comprehensive list of classes which map to the Printful data model,
+allowing developers to pull and manipulate data with ease. This gem wraps
+[the official Printful client library](https://www.printful.com/docs/libraries).
+
+
+## Installation
+
+You don't need this source code unless you want to modify the gem. If you just
+want to use the Printful API Ruby bindings, you should run:
+
+    gem install printful_api
+
+If you want to build the gem from source:
+
+    gem build printful_api.gemspec
+
+### Requirements
+
+* Ruby 1.9.3 or above.
+* A Printful account, and api key.  [Sign up here](https://printful.com/a/amrap)
+
+### Bundler
+
+If you are installing via bundler, you should be sure to use the https rubygems
+source in your Gemfile, as any gems fetched over http could potentially be
+compromised in transit and alter the code of gems fetched securely over https:
+
+``` ruby
+source 'https://rubygems.org'
+
+gem 'rails'
+gem 'printful_api'
+```
+
+## Usage
+
+In order to access the Printful API you must first have an api key, which get
+after creating [a Printful account](https://printful.com/a/amrap).  After signing in, go to your
+[store dashboard](https://www.printful.com/dashboard/store).  If you haven't yet
+create a store, otherwise click on the store to get to the "Update Store" screen.
+Click on the "API" tab, to get to the "API Access" view.  In a box below, there
+will be a random set of letters and numbers, this is your api key.  You will
+need to assign the api to `PrintfulAPI.api_key` so the gem can give you access
+to your store.
+
+Or you can set the api key into the `PRINTFUL_API_KEY` environment variable.
+
+``` ruby
+require "printful_api"
+PrintfulAPI.api_key = "g1n1h..."
+
+# list all products
+PrintfulAPI::Product.all
+
+# get a single order by external ID (your order id)
+PrintfulAPI::Order.get( '@YOUR_ORDER_ID' )
+
+
+# get a single order by Printful's order ID
+PrintfulAPI::Order.get( 342342 )
+```
+
+Once assigned, the gem will use it as necessary to authenticate requests for your
+store.
+
+## Products / Variations
+
+``` ruby
+
+# get a single product, in this case a T-SHIRT
+product = PrintfulAPI::Product.get(5)
+
+product.type # "T-SHIRT"
+product.brand # "American Apparel"
+product.model # "2001 Fine Jersey Short Sleeve Men T-Shirt"
+product.image # "https://d1yg28hrivmbqm.cloudfront.net/products/5/product_1483514498.jpg"
+product.variant_count # 270
+
+# a list of different file types you can provide for printing, and the cost for using them
+product.files # FileType[]
+
+# list the various, some 260+ variations, cut, color, etc
+product.variants # Variant[]
+
+# list the different options, options for configuring the process
+product.options # OptionType[]
+
+# a list of dimensions for the product
+product.dimensions # Hash
+
+```
+
+
+## Orders
+
+``` ruby
+
+order = PrintfulAPI::Order.create( {
+    "recipient": {
+        "name": "John Doe",
+        "address1": "19749 Dearborn St",
+        "city": "Chatsworth",
+        "state_code": "CA",
+        "country_code": "US",
+        "zip": "91311"
+    },
+	"external_id": 'order_1112',
+    "items": [{
+        "variant_id": 1,
+        "quantity": 1,
+        "files": [{
+            "url": "http://example.com/files/posters/poster_1.jpg"
+        }]
+    }]
+} )
+
+order.id # 2071687
+order.external_id # "order_1112"
+order.status # "draft"
+order.shipping # "FEDEX_SMART_POST"
+order.created # 1485550869
+order.updated # 1485550869
+order.recipient # PrintfulAPI::Address
+order.items # PrintfulAPI::Item[]
+order.costs # PrintfulAPI::Cost
+order.retail_costs # PrintfulAPI::Cost
+order.shipments # []
+order.gift # nil
+order.packing_slip # nil
+
+# once all order information is confirmed and correct, run the confirm command
+# and the store owner will be charged, and the printing begins.
+order.confirm_for_fulfillment()
+
+# didn't mean to process the order?  delete it and the order will be canceled,
+# and money returned to the store owner.
+order.delete()
+
+```
+
+## Shipping and Tax Rates
+
+``` ruby
+
+# shipping options available for a set of items
+shipping_rates = PrintfulAPI::ShippingRate.list( { address1: '12372 Carmel Country Rd', city: 'San Diego', country_code: 'US', state_code: 'CA', zip: 92130}, [{quantity: 2, variant_id: PrintfulAPI::Product.get(1).variants.first.id}], 'USD'  )
+
+shipping_rate = shipping_rates.first
+
+shipping_rate.id # "USPS_FIRST"
+shipping_rate.name # "USPS First Class Mail (3-5 business days after fulfillment)"
+shipping_rate.rate # "3.05"
+shipping_rate.currency # "USD"
+
+```
+
+``` ruby
+
+# tax rates Printful will charge on orders to a specific location
+tax_rate = PrintfulAPI::TaxRate.get( country_code: 'US', state_code: 'CA', city: 'San Diego', zip: 92130  )
+tax_rate.required # true
+tax_rate.rate # 0.775
+tax_rate.shipping_taxable # false
+
+```
+
+## Country/State Lists
+
+``` ruby
+
+# list all countries that are valid for Printful shipping.  A country and State
+# core a required for orders, when available from this api.
+countries = PrintfulAPI::Country.list()
+country = countries.find{|country| country.code == 'US' }
+
+# use the code values when referencing a country or state in an order
+
+country.code # "US"
+country.name # "United States"
+
+# a list of states/provinces/regions for that country
+country.states # State[]
+
+country.states.first.code # "AA"
+country.states.first.name # "Armed Forces Americas (except Canada)"
+
+```

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/lib/printful_api.rb

@@ -0,0 +1,65 @@
+# Printful Ruby bindings
+# API spec at https://www.printful.com/docs
+
+require 'printful_api/version'
+
+require 'printful_client'
+
+require 'printful_api/api_resource'
+require 'printful_api/api_operations/create'
+require 'printful_api/api_operations/delete'
+require 'printful_api/api_operations/get'
+require 'printful_api/api_operations/list'
+require 'printful_api/api_operations/save'
+require 'printful_api/api_operations/update'
+require 'printful_api/address'
+require 'printful_api/card_info'
+require 'printful_api/country'
+require 'printful_api/cost'
+require 'printful_api/file'
+require 'printful_api/file_type'
+require 'printful_api/gift_data'
+require 'printful_api/item'
+require 'printful_api/item_option'
+require 'printful_api/option_type'
+require 'printful_api/order'
+require 'printful_api/packing_slip'
+require 'printful_api/product'
+require 'printful_api/product_variant'
+require 'printful_api/shipping_rate'
+require 'printful_api/state'
+require 'printful_api/store'
+require 'printful_api/tax_rate'
+require 'printful_api/variant'
+require 'printful_api/webhooks'
+
+
+
+module PrintfulAPI
+
+	@@client = PrintfulClient.new( ENV['PRINTFUL_API_KEY'] )
+
+	def self.api_key=( api_key )
+		@@client = PrintfulClient.new( api_key )
+	end
+
+	def self.request( method, path, opts = {} )
+
+		# puts "#{method}, #{path}, #{opts}"
+
+		case method.to_s.upcase
+		when "GET"
+			@@client.get(path, opts[:params])
+		when "DELETE"
+			@@client.delete(path, opts[:params])
+		when "POST"
+			@@client.post(path, opts[:data], opts[:params])
+		when "PUT"
+			@@client.put(path, opts[:data], opts[:params])
+		else
+			die()
+		end
+
+	end
+
+end

data/lib/printful_api/address.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class Address < APIResource
+
+		api_attributes :name, :company, :address1, :address2, :city, :state_code, :country_code, :zip, :phone, :email, :state_name, :country_name
+
+	end
+
+end

data/lib/printful_api/api_operations/create.rb

@@ -0,0 +1,27 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module Create
+
+			def self.included(base)
+				base.extend(ClassMethods)
+			end
+
+			module ClassMethods
+
+				def create( data={}, params={} )
+
+					result = PrintfulAPI.request( :POST, params.delete(:resource_path) || self.resource_path, params: params, data: data )
+
+					self.new.load_data( result )
+
+				end
+
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_operations/delete.rb

@@ -0,0 +1,29 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module Delete
+
+			def self.included(base)
+				base.extend(ClassMethods)
+			end
+
+			module ClassMethods
+
+				def delete( id, opts={} )
+
+					PrintfulAPI.request( :DELETE, "#{opts.delete(:resource_path) || self.resource_path}/#{id}" )
+
+				end
+				
+			end
+
+			def delete()
+				self.class.delete( self.id )
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_operations/get.rb

@@ -0,0 +1,30 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module Get
+
+			def self.included(base)
+				base.extend(ClassMethods)
+			end
+
+			module ClassMethods
+
+				def get( id, opts={} )
+
+					data = PrintfulAPI.request( :GET, "#{opts.delete(:resource_path) || self.resource_path}/#{id}" )
+
+					model = self.new
+					model.load_data( data )
+
+					model
+
+				end
+
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_operations/list.rb

@@ -0,0 +1,35 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module List
+
+			def self.included(base)
+				base.extend(ClassMethods)
+			end
+
+			module ClassMethods
+
+				def list( filters={}, opts={} )
+
+					data_list = PrintfulAPI.request( :GET, opts.delete(:resource_path) || self.resource_path, params: filters )
+
+					data_list.collect do |data|
+
+						model = self.new
+						model.load_data( data )
+
+						model
+
+					end
+				end
+
+				alias :all :list
+
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_operations/save.rb

@@ -0,0 +1,25 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module Save
+
+			def save( opts = {} )
+
+				if self.id.present?
+
+					self.class.update( self.to_h, opts )
+
+				else
+
+					self.class.create( self.to_h, opts )
+
+				end
+
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_operations/update.rb

@@ -0,0 +1,24 @@
+module PrintfulAPI
+
+	module APIOperations
+
+		module Update
+
+			def self.included(base)
+				base.extend(ClassMethods)
+			end
+
+			module ClassMethods
+
+				def update( id, data={}, params={} )
+
+					PrintfulAPI.request( :PUT, "#{self.resource_path}/#{id}", params: params, data: data )
+
+				end
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/api_resource.rb

@@ -0,0 +1,104 @@
+module PrintfulAPI
+	class APIResource
+
+		attr_accessor :raw_data
+
+		class << self; attr_accessor :api_attribute_list end
+
+
+		def self.api_attributes( *args )
+			self.api_attribute_list = (self.api_attribute_list || []).concat(args)
+
+			attr_accessor *args
+		end
+
+		def self.has_many( attribute_name, args = {} )
+			args[:class] = args[:class] if args[:class].is_a? String
+			args[:class] ||= "PrintfulAPI::#{APIResource.singularize( APIResource.camelize(attribute_name.to_s ) )}"
+
+			self.api_attributes *[attribute_name.to_sym]
+
+        	define_method("#{attribute_name}=") do |array|
+				if array.present?
+					array = array.collect do |data|
+						args[:class].constantize.new.load_data(data)
+					end
+				end
+				self.instance_variable_set("@#{attribute_name}", array)
+			end
+		end
+
+		def self.belongs_to( attribute_name, args = {} )
+			args[:class] = args[:class] if args[:class].is_a? String
+			args[:class] ||= "PrintfulAPI::#{APIResource.camelize( attribute_name.to_s )}"
+			args[:foreign_key] ||= "#{attribute_name}_id"
+
+			self.api_attributes *[attribute_name.to_sym]
+
+			define_method("#{attribute_name}") do
+				attribute_value = self.instance_variable_get( "@#{attribute_name}" )
+				attribute_value ||= args[:class].new.get( args[:foreign_key] ) if self.respond_to?( args[:foreign_key] )
+				self.instance_variable_set( "@#{attribute_name}", attribute_value )
+			end
+
+			define_method("#{attribute_name}=") do |data|
+				if data.is_a?(PrintfulAPI::APIResource)
+					self.instance_variable_set("@#{attribute_name}", data)
+				else
+					model = args[:class].constantize.new.load_data(data) if data.present?
+					self.instance_variable_set( "@#{attribute_name}", model )
+				end
+			end
+		end
+
+		def load_data( data )
+			self.raw_data = data
+			data.each do |key,value|
+
+				if self.respond_to? "#{key}="
+					self.send("#{key}=", value)
+				else
+					puts "Accessor doesn't exist #{self.class.name}\##{"#{key}="}"
+				end
+
+			end
+
+			self
+
+		end
+
+		def to_h()
+			hash = {}
+			self.class.api_attribute_list.each do |attribute_name|
+				value = self.send(attribute_name)
+				if value.is_a? Array
+
+					hash[attribute_name] = value.collect do |array_item|
+						if array_item.is_a? APIResource
+							hash[attribute_name] = array_item.to_h
+						else
+							hash[attribute_name] = array_item
+						end
+					end
+
+				elsif value.is_a? APIResource
+					hash[attribute_name] = value.to_h
+				else
+					hash[attribute_name] = value
+				end
+			end
+
+			hash
+		end
+
+		def self.camelize( str )
+			str.split('_').map {|w| w.capitalize}.join
+		end
+
+		def self.singularize( str )
+			str = str[0..-2] if str[-1] == 's'
+			str
+		end
+
+	end
+end

data/lib/printful_api/card_info.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class CardInfo < APIResource
+
+		api_attributes :type, :number_mask, :expires
+
+	end
+
+end

data/lib/printful_api/cost.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class Cost < APIResource
+
+		api_attributes :discount, :shipping, :tax, :subtotal, :total, :digitization
+
+	end
+
+end

data/lib/printful_api/country.rb

@@ -0,0 +1,34 @@
+module PrintfulAPI
+
+	class Country < APIResource
+		include PrintfulAPI::APIOperations::List
+
+		api_attributes :code, :name
+		has_many :states
+
+		def self.list( filters={}, opts={} )
+			taxable = filters.delete(:taxable)
+
+			puts "Country.list taxable: #{taxable}, #{filters}, #{opts}"
+
+			if taxable
+				super( filters, opts.merge( resource_path: '/tax/countries' ) )
+			else
+				super( filters, opts )
+			end
+		end
+
+		def states
+			@states
+		end
+
+		def self.resource_path
+			'/countries'
+		end
+
+
+
+
+	end
+
+end

data/lib/printful_api/file.rb

@@ -0,0 +1,17 @@
+module PrintfulAPI
+
+	class File < APIResource
+		include PrintfulAPI::APIOperations::List
+		include PrintfulAPI::APIOperations::Create
+		include PrintfulAPI::APIOperations::Get
+
+		api_attributes :id, :type, :hash, :url, :filename, :mime_type, :size, :width, :height, :dpi, :status, :created, :thumbnail_url, :preview_url, :visible
+
+
+		def self.resource_path
+			'/files'
+		end
+
+	end
+
+end

data/lib/printful_api/file_type.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class FileType < APIResource
+
+		api_attributes :id, :title, :additional_price
+
+	end
+
+end

data/lib/printful_api/gift_data.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class GiftData < APIResource
+
+		api_attributes :subject, :message
+
+	end
+
+end

data/lib/printful_api/item.rb

@@ -0,0 +1,14 @@
+module PrintfulAPI
+
+	class Item < APIResource
+
+
+		api_attributes :id, :external_id, :variant_id, :quantity, :price, :retail_price, :name, :sku
+		has_many :files
+		has_many :options, class: 'PrintfulAPI::ItemOption'
+		belongs_to :product, class: 'PrintfulAPI::ProductVariant'
+		# belongs_to :variant
+
+	end
+
+end

data/lib/printful_api/item_option.rb

@@ -0,0 +1,11 @@
+module PrintfulAPI
+
+	class ItemOption < APIResource
+
+
+		api_attributes :id, :value
+
+
+	end
+
+end

data/lib/printful_api/option_type.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class OptionType < APIResource
+
+		api_attributes :id, :title, :type, :values, :additional_price
+
+	end
+
+end

data/lib/printful_api/order.rb

@@ -0,0 +1,39 @@
+module PrintfulAPI
+
+	class Order < APIResource
+		include PrintfulAPI::APIOperations::Create
+		include PrintfulAPI::APIOperations::Delete
+		include PrintfulAPI::APIOperations::Get
+		include PrintfulAPI::APIOperations::List
+		include PrintfulAPI::APIOperations::Update
+		include PrintfulAPI::APIOperations::Save
+
+		api_attributes :id, :external_id, :status, :created, :updated, :costs, :shipping, :currency
+		belongs_to :recipient, class: 'PrintfulAPI::Address'
+		has_many :items
+		belongs_to :costs, class: 'PrintfulAPI::Cost'
+		belongs_to :retail_costs, class: 'PrintfulAPI::Cost'
+		belongs_to :gift, class: 'PrintfulAPI::GiftData'
+		belongs_to :packing_slip
+		has_many :shipments
+
+
+		def self.resource_path
+			'/orders'
+		end
+
+		# Confirm draft for fulfillment
+		# Approves for fulfillment an order that was saved as a draft. Store owner's credit card is charged when the order is submitted for fulfillment.
+		def confirm_for_fulfillment
+
+			result = PrintfulAPI.request( :POST, "/orders/#{self.id}/confirm", {} )
+
+			self.load_data( result )
+
+			return true
+
+		end
+
+	end
+
+end

data/lib/printful_api/packing_slip.rb

@@ -0,0 +1,22 @@
+module PrintfulAPI
+
+	class PackingSlip < APIResource
+		include APIOperations::Create
+
+		api_attributes :email, :phone, :message
+
+		def self.get( opts={} )
+
+			store = Store.get()
+
+			store.packing_slip
+
+		end
+
+		def self.resource_path
+			'/store/packing-slip'
+		end
+
+	end
+
+end

data/lib/printful_api/product.rb

@@ -0,0 +1,48 @@
+module PrintfulAPI
+
+	class Product < APIResource
+		include PrintfulAPI::APIOperations::List
+		include PrintfulAPI::APIOperations::Get
+
+		api_attributes :id, :type, :brand, :model, :image, :variant_count, :dimensions
+
+		# has_many :allowed_files, class: 'PrintfulAPI::FileType'
+		has_many :files, class: 'PrintfulAPI::FileType'
+		# has_many :allowed_options, class: 'PrintfulAPI::OptionType'
+		has_many :options, class: 'PrintfulAPI::OptionType'
+
+		def variants
+			@variants ||= PrintfulAPI::Variant.list( product_id: self.id )
+			@variants
+		end
+
+		def self.resource_path
+			'/products'
+		end
+
+		def load_data( data )
+
+			if data['product'].present?
+
+				super(data['product'])
+
+				@variants = data['variants'].collect do |variant_data|
+					variant = PrintfulAPI::Variant.new.load_data( variant_data )
+					variant.product = self
+					variant
+				end
+
+			else
+
+				super( data )
+
+			end
+
+		end
+
+
+
+
+	end
+
+end

data/lib/printful_api/product_variant.rb

@@ -0,0 +1,14 @@
+module PrintfulAPI
+
+	class ProductVariant < APIResource
+
+
+		api_attributes :variant_id, :product_id, :image, :name
+
+		belongs_to :variant
+		belongs_to :product
+
+
+	end
+
+end

data/lib/printful_api/shipment.rb

@@ -0,0 +1,10 @@
+module PrintfulAPI
+
+	class GiftData < APIResource
+
+		api_attributes :id, :carrier, :service, :tracking_number, :tracking_url, :created, :ship_date, :reshipment
+		has_many :items
+
+	end
+
+end

data/lib/printful_api/shipping_rate.rb

@@ -0,0 +1,29 @@
+module PrintfulAPI
+
+	class ShippingRate < APIResource
+
+		api_attributes :id, :name, :rate, :currency
+
+		# PrintfulAPI::ShippingRate.list( { address1: '12372 Carmel Country Rd', city: 'San Diego', country_code: 'US', state_code: 'CA', zip: 92130}, [{quantity: 2, variant_id: PrintfulAPI::Product.get(1).variants.first.id}], 'USD'  )
+		def self.list( recipient = {}, items = [], currency = 'USD', opts = {} )
+
+			request_data = {
+				recipient: recipient,
+				items: items,
+				currency: currency
+			}
+
+			results = PrintfulAPI.request( :POST, "/shipping/rates", data: request_data, params: opts )
+
+			results.collect do |data|
+				model = self.new
+				model.load_data( data )
+
+				model
+			end
+
+		end
+
+	end
+
+end

data/lib/printful_api/state.rb

@@ -0,0 +1,9 @@
+module PrintfulAPI
+
+	class State < APIResource
+
+		api_attributes :code, :name, :shipping_taxable
+
+	end
+
+end

data/lib/printful_api/store.rb

@@ -0,0 +1,29 @@
+module PrintfulAPI
+
+	class Store < APIResource
+
+		api_attributes :id, :name, :website, :created
+		belongs_to :packing_slip
+		belongs_to :return_address, class: 'PrintfulAPI::Address'
+		belongs_to :billing_address, class: 'PrintfulAPI::Address'
+		belongs_to :payment_card, class: 'PrintfulAPI::CardInfo'
+
+
+		def self.get( opts={} )
+
+			data = PrintfulAPI.request( :GET, self.resource_path )
+
+			model = self.new
+			model.load_data( data )
+
+			model
+
+		end
+
+		def self.resource_path
+			'/store'
+		end
+
+	end
+
+end

data/lib/printful_api/tax_rate.rb

@@ -0,0 +1,21 @@
+module PrintfulAPI
+
+	class TaxRate < APIResource
+
+		api_attributes :required, :rate, :shipping_taxable
+
+		# PrintfulAPI::TaxRate.get( country_code: 'US', state_code: 'CA', city: 'San Diego', zip: 92130  )
+		def self.get( recipient = {}, opts = {} )
+
+			data = PrintfulAPI.request( :POST, "/tax/rates", data: { recipient: recipient }, params: opts )
+
+			model = self.new
+			model.load_data( data )
+
+			model
+
+		end
+
+	end
+
+end

data/lib/printful_api/variant.rb

@@ -0,0 +1,16 @@
+module PrintfulAPI
+
+	class Variant < APIResource
+		include PrintfulAPI::APIOperations::Get
+
+		api_attributes :id, :product_id, :name, :size, :color, :color_code, :image, :price, :in_stock
+
+		belongs_to :product
+
+		def self.resource_path
+			'/products/variant'
+		end
+
+	end
+
+end

data/lib/printful_api/version.rb

@@ -0,0 +1,3 @@
+module PrintfulAPI
+  VERSION = '1.0.1'
+end

data/lib/printful_api/webhooks.rb

@@ -0,0 +1,35 @@
+module PrintfulAPI
+
+	class Webhook < APIResource
+		include PrintfulAPI::APIOperations::Create
+
+		api_attributes :url, :types, :params
+
+		def self.get( opts={} )
+
+			data = PrintfulAPI.request( :GET, self.resource_path )
+
+			model = self.new
+			model.load_data( data )
+
+			model
+
+		end
+
+		def self.delete( opts={} )
+
+			PrintfulAPI.request( :DELETE, self.resource_path )
+
+		end
+
+		def delete
+			self.class.delete()
+		end
+
+		def self.resource_path
+			'/webhooks'
+		end
+
+	end
+
+end

data/lib/printful_client.rb

@@ -0,0 +1,144 @@
+##
+#
+# This class helps to use the Printful API
+#
+# version 1.0
+# copyright 2014 Idea Bits LLC
+#
+##
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module PrintfulClientModule
+
+	API_URL = 'https://api.theprintful.com/'
+	USER_AGENT = 'Printful API Ruby Library 1.0'
+
+    @api_key
+    @last_response_raw
+    @last_response
+
+
+    # Initialize API library
+    # key - Printful Store API key
+    def initialize(key)
+        @api_key = key
+    end
+
+
+	# Returns total available item count from the last request if it supports paging (e.g order list) or nil otherwise
+	def item_count
+		return last_response && last_response.key?('paging')  ? last_response['paging']['total'] : nil
+	end
+
+    # Perform a GET request to the API
+    # path - Request path (e.g. 'orders' or 'orders/123')
+    # params - Additional GET parameters as a hash
+    def get(path, params=nil)
+        request('GET', path, params)
+    end
+
+
+    # Perform a DELETE request to the API
+    # path - Request path (e.g. 'orders' or 'orders/123')
+    # params - Additional GET parameters as a hash
+    def delete(path, params=nil)
+        request('DELETE', path, params)
+    end
+
+
+    # Perform a POST request to the API
+    # path - Request path (e.g. 'orders' or 'orders/123')
+    # data - Request body data as a hash
+    # params - Additional GET parameters as a hash
+    def post(path, data=nil, params=nil)
+        request('POST', path, params, data)
+    end
+
+
+    # Perform a PUT request to the API
+    # path - Request path (e.g. 'orders' or 'orders/123')
+    # data - Request body data as a hash
+    # params - Additional GET parameters as a hash
+    def put(path, data=nil, params=nil)
+        request('PUT', path, params, data)
+    end
+
+    # Internal generic request wrapper
+    def request (method, path, params=nil, data=nil)
+
+        @last_response_raw = nil
+        @last_response = nil
+
+        uri = URI.join(API_URL, path)
+        if params
+            query = URI.encode_www_form(params)
+            uri.query = query
+        end
+
+        body = data ? JSON.generate(data) : nil
+
+        headers = {
+            'User-Agent' => USER_AGENT
+        }
+        begin
+            http = Net::HTTP.start(
+                uri.host,
+                uri.port,
+                :use_ssl => uri.scheme=='https',
+                :open_timeout => 10,
+                :read_timeout => 20
+            ) do |http|
+
+                request = Net::HTTPGenericRequest.new(method,(body ? true : false), true, uri.request_uri ,headers)
+                request.basic_auth @api_key, ''
+                response = http.request(request, body)
+
+                @last_response_raw = response.body
+
+                begin
+                    result = JSON.parse(response.body)
+                    @last_response = result
+                rescue JSON::ParserError
+                    raise PrintfulException, "API response was not valid JSON"
+                end
+
+                if !result.key?('code') || !result.key?('result')
+                  raise PrintfulException, "Invalid API response"
+                end
+
+                status = result['code']
+                if status<200 || status >=300
+                    raise PrintfulApiException.new(status), result['result']
+                end
+
+                result['result']
+            end
+        rescue PrintfulException
+            raise
+        rescue Exception => e
+          raise PrintfulException, 'API request failed: ' + e.message
+        end
+    end
+
+    private :request
+    attr_accessor :last_response, :last_response_raw
+end
+
+class PrintfulClient
+   include PrintfulClientModule
+end
+
+# Generic Printful exception
+class PrintfulException < RuntimeError
+end
+
+# Printful exception returned from the API
+class PrintfulApiException < PrintfulException
+  def initialize(code)
+    @code = code
+  end
+  attr_accessor :code
+end

data/printful_api.gemspec

@@ -0,0 +1,18 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'printful_api/version'
+
+Gem::Specification.new do |s|
+  s.name        	= 'printful_api'
+  s.version     	= PrintfulAPI::VERSION
+  s.date        	= '2017-01-25'
+  s.summary     	= "Ruby bindings for the Printful API"
+  s.description 	= "Printful is the easiest way to sell, print and ship custom posters, shirts, mugs, pillows, leggings, totes ..."
+  s.authors     	= ["Michael Ferguson"]
+  s.email       	= 'meister@spacekace.com'
+  s.files 			= `git ls-files`.split("\n")
+  s.require_paths 	= ['lib']
+  s.homepage    =	'https://github.com/Groundswell/printful-ruby'
+  s.license       = 'MIT'
+  s.required_ruby_version = '>= 1.9.3'
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: printful_api
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Michael Ferguson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-25 00:00:00.000000000 Z
+dependencies: []
+description: Printful is the easiest way to sell, print and ship custom posters, shirts,
+  mugs, pillows, leggings, totes ...
+email: meister@spacekace.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- VERSION
+- lib/printful_api.rb
+- lib/printful_api/address.rb
+- lib/printful_api/api_operations/create.rb
+- lib/printful_api/api_operations/delete.rb
+- lib/printful_api/api_operations/get.rb
+- lib/printful_api/api_operations/list.rb
+- lib/printful_api/api_operations/save.rb
+- lib/printful_api/api_operations/update.rb
+- lib/printful_api/api_resource.rb
+- lib/printful_api/card_info.rb
+- lib/printful_api/cost.rb
+- lib/printful_api/country.rb
+- lib/printful_api/file.rb
+- lib/printful_api/file_type.rb
+- lib/printful_api/gift_data.rb
+- lib/printful_api/item.rb
+- lib/printful_api/item_option.rb
+- lib/printful_api/option_type.rb
+- lib/printful_api/order.rb
+- lib/printful_api/packing_slip.rb
+- lib/printful_api/product.rb
+- lib/printful_api/product_variant.rb
+- lib/printful_api/shipment.rb
+- lib/printful_api/shipping_rate.rb
+- lib/printful_api/state.rb
+- lib/printful_api/store.rb
+- lib/printful_api/tax_rate.rb
+- lib/printful_api/variant.rb
+- lib/printful_api/version.rb
+- lib/printful_api/webhooks.rb
+- lib/printful_client.rb
+- printful_api.gemspec
+homepage: https://github.com/Groundswell/printful-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for the Printful API
+test_files: []