teespring 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 47d395a0046f7c60bd1125d662f68565e716c9e1
-  data.tar.gz: ce4287baf0a8c7c34336cceb17d8cffe5042bcca
+  metadata.gz: 7523636f6488a09cfee2991b1ae426977a310fc3
+  data.tar.gz: c640d1cbdce46177d65948868765a4e02d6745de
 SHA512:
-  metadata.gz: 849cdf0be66efd108c651317ab8bf956c01fa2eb786b19add502f1a39560e35975ce9dae394ef4b9ed48b9742e99205752c396c14693427e08c899ff3f71b4ae
-  data.tar.gz: fc22c441d513ae5dd9e2271b1a05c427de3a1e83d17454d8ee21a9001f2609d07bb64c22b5e6f6b96aa9f804ea5c74b6adb97067543c51b9a686985f83df5768
+  metadata.gz: 35cf607b92d2de3d792286b9a634fc27e174a830c1116850489f2cdf6632e34bb9779d8a57c64a5d5e7e420fc2139b7f6789a40dc1efb07ed1992c94379e9f79
+  data.tar.gz: 04e792e74e104fd3258074dadbb32baebea412e0494d1f4500a8ba0ccad557df8bc6749a9dcd7799b0a893f57c4de75b7b124c0a422a956a50f4dd3d2a16d7c1

data/.gitignore

@@ -7,3 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+*.gem

data/README.md

@@ -20,7 +20,42 @@ Or install it yourself as:
 
 ## Usage
 
-In order to use this gem you must obtain an `app_id` from [Teespring](https://teespring.com/support). 
+In order to use this gem you must obtain an `app_id` from [Teespring](https://teespring.com/help). 
+
+Create a client:
+
+```ruby
+client = Teespring::Client.new(app_id: "APP_ID_YOU_REQUESTED_FROM_TEESPRING")
+```
+
+Authenticate (this will create a new access token):
+
+```ruby
+token = client.authenticate("youremail@example.com", "yourpassword")
+```
+
+Alternatively, if you already have an access token you can create the client with the token directly:
+
+```ruby
+client = Teespring::Client.new(app_id: "APP_ID_YOU_REQUESTED_FROM_TEESPRING", access_token: "YOUR_ACCESS_TOKEN")
+```
+
+Once the client is authenticated you can retrieve information about the authenticated (via the access token) user:
+
+```ruby
+response = client.me
+response.body
+=> {"users"=>[{"id"=>12345, "email"=>"youremail@example.com"}]}
+
+```
+
+You can also retrieve a list of campaigns:
+
+```ruby
+response = client.campaigns(nil, "active")
+```
+
+Additional endpoints and details are available in the [Teespring Documentation](https://api.teespring.com/docs). Additional endpoints can be accessed directly through the `client.get` and `client.post` methods.
 
 ## Development
 
@@ -28,6 +63,13 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## TODO
+
+* More Endpoints and response specific adapters
+* Rate limiting
+* Pagination
+* Auto-pagination
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/teespring.

data/lib/teespring.rb

@@ -1,5 +1,7 @@
 require "teespring/version"
+require "teespring/client"
+require "teespring/response"
+require "teespring/error"
 
 module Teespring
-  # Your code goes here...
 end

data/lib/teespring/client.rb

@@ -0,0 +1,65 @@
+require 'faraday'
+require 'json'
+
+module Teespring
+  class Client
+    attr_accessor :access_token
+
+    def initialize(options = {})
+      @app_id = options.delete(:app_id)
+    end
+
+    def connection
+      @connection ||= ::Faraday.new(url: endpoint)
+    end
+
+    def reset
+      @connection = nil
+    end
+
+    def authenticate(email, password)
+      @response = post '/v1/auth-tokens', email: email, password: password, app_id: @app_id
+
+      @access_token = @response.body['token']
+    end
+
+    def me
+      @response = get '/me', { access_token: @access_token }
+    end
+
+    def campaigns(search = nil, states = nil)
+      @response = get '/seller/v1/campaigns', { access_token: @access_token, search: search, states: states, page: 1, per_page: 100 }
+    end
+
+    def get(url, params)
+      request(:get, url, params)
+    end
+
+    def post(url, params)
+      request(:post, url, params)
+    end
+
+    private
+
+    def request(method, url, params)
+      response = connection.send(method, url, params)
+
+      case response.status
+      when 200..299
+        Teespring::Response.new(response)
+      when 301
+        raise Teespring::Error.new('Not found', response)
+      when 400
+        message = JSON.parse(response.body)['error']['message'] rescue response.reason_phrase
+
+        raise Teespring::Error.new(message, response)
+      else
+        raise Teespring::Error.new('Unknown error', response)
+      end
+    end
+
+    def endpoint
+      "https://api.teespring.com"
+    end
+  end
+end

data/lib/teespring/error.rb

@@ -0,0 +1,11 @@
+module Teespring
+  class Error < StandardError
+    attr_reader :response
+
+    def initialize(message, response)
+      @response = response
+
+      super(message)
+    end
+  end
+end

data/lib/teespring/response.rb

@@ -0,0 +1,19 @@
+require 'json'
+
+module Teespring
+  class Response
+    attr_reader :response
+
+    def initialize(response)
+      @response = response
+    end
+
+    def body
+      @body ||= JSON.parse(response.body)
+    end
+
+    def status
+      response.status
+    end
+  end
+end

data/lib/teespring/version.rb

@@ -1,3 +1,3 @@
 module Teespring
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/teespring.gemspec

@@ -22,4 +22,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.12"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+
+  spec.add_dependency "faraday", "~> 0.10"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: teespring
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - jeffrafter
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
 description: Teespring provides a number of public and private APIs for creating,
   managing, and purchasing tee-shirts through their platform.
 email:
@@ -70,6 +84,9 @@ files:
 - bin/console
 - bin/setup
 - lib/teespring.rb
+- lib/teespring/client.rb
+- lib/teespring/error.rb
+- lib/teespring/response.rb
 - lib/teespring/version.rb
 - teespring.gemspec
 homepage: https://github.com/jeffrafter/teespring