totter 0.2.0

data/lib/totter/client/slugs.rb

@@ -0,0 +1,19 @@
+module Totter
+  class Client
+    # Client methods for working with slugs
+    module Slugs
+      # Get a slug.
+      #
+      # @param id [String] the slug id
+      # @param unique_id [String] an optional tracking string
+      # @return [Hashie::Mash]
+      # @example
+      #   Seesaw.slug('d/3I0n0g')
+      def slug(id, unique_id = nil)
+        path =  "slugs/#{id}"
+        path += "?unique_id=#{unique_id}" if unique_id
+        get path
+      end
+    end
+  end
+end

data/lib/totter/client/timelines.rb

@@ -0,0 +1,16 @@
+module Totter
+  class Client
+    # Client methods for working with timelines
+    module Timelines
+      # Get recent decisions from the global timeline.
+      #
+      # @param limit [Fixnum] Number of decisions to return.
+      # @return [Array]
+      # @example
+      #   Seesaw.recent_decisions
+      def global_timeline(limit = 10)
+        get "timelines/global?limit=#{limit}"
+      end
+    end
+  end
+end

data/lib/totter/client/users.rb

@@ -0,0 +1,54 @@
+module Totter
+  class Client
+    # Client methods for working with users
+    module Users
+      # Get the current user
+      #
+      # Requires authenticatied client.
+      #
+      # @return [Hashie::Mash]
+      # @see Totter::Client
+      # @example
+      #   client.me
+      def me
+        get 'me'
+      end
+
+      # Get a single user
+      #
+      # @param user [String] A Seeaw username or ID.
+      # @return [Hashie::Mash]
+      # @example
+      #   Seesaw.user('soffes')
+      def user(user)
+        get "users/#{user}"
+      end
+
+      # Follow a user.
+      #
+      # Requires authenticatied client.
+      #
+      # @param user [String] Username or ID of the user to follow.
+      # @return [Boolean] True if follow was successful, false otherwise.
+      # @see Totter::Client
+      # @example
+      #   client.follow('gotwalt')
+      def follow(user)
+        boolean_from_response :post, "users/#{user}/follow"
+      end
+
+      # Unfollow a user.
+      #
+      # Requires authenticatied client.
+      #
+      # @param user [String] Username or ID of the user to unfollow.
+      # @return [Boolean] True if unfollow was successful, false otherwise.
+      # @see Totter::Client
+      # @example
+      #   client.unfollow('kyle')
+      def unfollow(user)
+        boolean_from_response :post, "users/#{user}/unfollow"
+      end
+    end
+  end
+end

data/lib/totter/client/votes.rb

@@ -0,0 +1,25 @@
+module Totter
+  class Client
+    # Client methods for working with votes
+    module Votes
+      # Create a vote.
+      #
+      # @param decision_user_id [Fixnum] the decision's owner's ID
+      # @param decision_id [Fixnum] the decision's ID
+      # @param choice_id [Fixnum] the choice's ID
+      # @param options [Hash] specifiy `:unique_id` or `:invitation_slug`
+      def create_vote(decision_user_id, decision_id, choice_id, options = {})
+        unique_id = options[:unique_id]
+        raise UniqueIDRequired unless unique_id or self.authenticated?
+
+        path = "users/#{decision_user_id}/decisions/#{decision_id}/votes"
+        params = { choice_id: choice_id, unique_id: unique_id }
+
+        slug = options[:invitation_slug]
+        params[:invitation] = { slug: slug } if slug and slug[0] == 'i'
+
+        post path, params
+      end
+    end
+  end
+end

data/lib/totter/error.rb

@@ -0,0 +1,51 @@
+module Totter
+  # Standard Totter error
+  class Error < StandardError; end
+
+  # Raised when Totter returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when Totter returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when Totter returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when Totter returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when Totter returns a 406 HTTP status code
+  class NotAcceptable < Error; end
+
+  # Raised when Totter returns a 422 HTTP status code
+  class UnprocessableEntity < Error; end
+
+  # Raised when Totter returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when Totter returns a 501 HTTP status code
+  class NotImplemented < Error; end
+
+  # Raised when Totter returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when Totter returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+
+  # Raised when a unique ID is required but not provided
+  class UniqueIDRequired < Error; end
+
+  # Status code to exception map
+  ERROR_MAP = {
+    400 => Totter::BadRequest,
+    401 => Totter::Unauthorized,
+    403 => Totter::Forbidden,
+    404 => Totter::NotFound,
+    406 => Totter::NotAcceptable,
+    422 => Totter::UnprocessableEntity,
+    500 => Totter::InternalServerError,
+    501 => Totter::NotImplemented,
+    502 => Totter::BadGateway,
+    503 => Totter::ServiceUnavailable
+  }
+end

data/lib/totter/version.rb

@@ -0,0 +1,4 @@
+module Totter
+  # Verion of the Totter gem
+  VERSION = '0.2.0'
+end

data/test/cassettes/choices/create_choice_upload.yml

@@ -0,0 +1,85 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"fe72872af6d81e7ab492d6b1ee9e2abd"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - a82f122c9397d644523d410f90be50c7
+      X-Runtime:
+      - '0.027279'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:44:41Z","final_vote_id":null,"flag_count":null,"id":32,"is_private":false,"meta":null,"published_at":null,"question":null,"updated_at":"2013-01-30T21:44:41Z","user_id":1,"pusher_channel":"decision-1-32","timeline_key":"1,32","analytics":{"views":0,"unique_viewers":0,"referrers":{},"votes":{},"total_votes":0},"user_vote":null,"choices":[],"invitations":[],"user":{"biography":null,"created_at":"2013-01-23T03:22:06Z","family_name":null,"given_name":null,"id":1,"meta":null,"moderated_decisions_count":null,"updated_at":"2013-01-23T03:22:06Z","username":null,"website":null,"avatar_url":"https://recess-dev.s3.amazonaws.com/default_avatars/v1/photo_1.png","full_name":"1","short_name":"1","display_name":"1","short_display_name":"1","analytics":{"votes":0,"decisions":0,"followers":0,"following":0}},"slug":"d/2r2v2A"}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:44:41 GMT
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions/32/choices
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"02b23992abdf817ee5c383ca29056d3b"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 0666dd6a3a6bcbfa11b75f33fab2c63c
+      X-Runtime:
+      - '0.022490'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:44:41Z","decision_id":32,"decision_user_id":1,"id":19,"meta":null,"position":1,"subject":null,"type":"ImageChoice","updated_at":"2013-01-30T21:44:41Z","image_uri":"https://s3.amazonaws.com/","upload":{"url":"https://recess-dev.s3.amazonaws.com/","params":{"AWSAccessKeyId":"AKIAIYAL2IUDRW6PBPUQ","key":"gotwalt-pro.sf.gotwalt.com/decisions/32/19/1359582281/${filename}","policy":"eyJleHBpcmF0aW9uIjoiMjAxMy0wMS0zMFQyMjo0NDo0MVoiLCJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJyZWNlc3MtZGV2In0sWyJzdGFydHMtd2l0aCIsIiRrZXkiLCJnb3R3YWx0LXByby5zZi5nb3R3YWx0LmNvbS9kZWNpc2lvbnMvMzIvMTkvMTM1OTU4MjI4MS8iXSx7ImFjbCI6InB1YmxpYy1yZWFkIn0seyJzdWNjZXNzX2FjdGlvbl9yZWRpcmVjdCI6Imh0dHA6Ly9sb2NhbGhvc3Q6NTAwMC92MS91c2Vycy8xL2RlY2lzaW9ucy8zMi9jaG9pY2VzLzMwNDAybzBMMTgyZjJGMTYzMC9zMyJ9LFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3Nl1dfQ==","signature":"2Sgsgg8nWp2A7FP6fG0EEN6MztY=","acl":"public-read","success_action_redirect":"http://localhost:5000/v1/users/1/decisions/32/choices/30402o0L182f2F1630/s3"}}}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:44:41 GMT
+recorded_with: VCR 2.4.0

data/test/cassettes/choices/create_for_image.yml

@@ -0,0 +1,87 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"17c9b6356fae36d9b359dd0e2e56915f"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - fddf25eccf2dea50779bcc1268429bea
+      X-Runtime:
+      - '0.075714'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:44:41Z","final_vote_id":null,"flag_count":null,"id":33,"is_private":false,"meta":null,"published_at":null,"question":null,"updated_at":"2013-01-30T21:44:41Z","user_id":1,"pusher_channel":"decision-1-33","timeline_key":"1,33","analytics":{"views":0,"unique_viewers":0,"referrers":{},"votes":{},"total_votes":0},"user_vote":null,"choices":[],"invitations":[],"user":{"biography":null,"created_at":"2013-01-23T03:22:06Z","family_name":null,"given_name":null,"id":1,"meta":null,"moderated_decisions_count":null,"updated_at":"2013-01-23T03:22:06Z","username":null,"website":null,"avatar_url":"https://recess-dev.s3.amazonaws.com/default_avatars/v1/photo_1.png","full_name":"1","short_name":"1","display_name":"1","short_display_name":"1","analytics":{"votes":0,"decisions":0,"followers":0,"following":0}},"slug":"d/1W362T"}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:44:41 GMT
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions/33/choices
+    body:
+      encoding: UTF-8
+      string: ! '{"choice":{"type":"image","image_url":"http://recess.s3.amazonaws.com/default_avatars/v1/photo_1.png","subject":"Test
+        Image","meta":{"link_url":"http://seesaw.co","link_title":"Seesaw"}}}'
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"6bd2e538cb6c096628df5e5e8c52b8bb"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 6cab0f1f8d22dedc4920106aed2852ff
+      X-Runtime:
+      - '0.604433'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:44:41Z","decision_id":33,"decision_user_id":1,"id":20,"meta":{"link_url":"http://seesaw.co","link_title":"Seesaw"},"position":1,"subject":"Test
+        Image","type":"ImageChoice","updated_at":"2013-01-30T21:44:41Z","image_uri":"https://recess-dev.s3.amazonaws.com/gotwalt-pro.sf.gotwalt.com/decisions/33/20/1359582281/photo.png"}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:44:41 GMT
+recorded_with: VCR 2.4.0

data/test/cassettes/choices/destroy.yml

@@ -0,0 +1,122 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"a065c212f634cce169159f9e66c40e42"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 11b81d00325361beeb6dda08b5eca88d
+      X-Runtime:
+      - '0.027600'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:45:41Z","final_vote_id":null,"flag_count":null,"id":34,"is_private":false,"meta":null,"published_at":null,"question":null,"updated_at":"2013-01-30T21:45:41Z","user_id":1,"pusher_channel":"decision-1-34","timeline_key":"1,34","analytics":{"views":0,"unique_viewers":0,"referrers":{},"votes":{},"total_votes":0},"user_vote":null,"choices":[],"invitations":[],"user":{"biography":null,"created_at":"2013-01-23T03:22:06Z","family_name":null,"given_name":null,"id":1,"meta":null,"moderated_decisions_count":null,"updated_at":"2013-01-23T03:22:06Z","username":null,"website":null,"avatar_url":"https://recess-dev.s3.amazonaws.com/default_avatars/v1/photo_1.png","full_name":"1","short_name":"1","display_name":"1","short_display_name":"1","analytics":{"votes":0,"decisions":0,"followers":0,"following":0}},"slug":"d/3H2Y0T"}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:45:42 GMT
+- request:
+    method: post
+    uri: http://localhost:5000/v1/users/1/decisions/34/choices
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Ua-Compatible:
+      - IE=Edge
+      Etag:
+      - ! '"ee3e37e9de385d6218a89aa990e974a7"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - d89c73e6a43d0a2deb90538b92533b0f
+      X-Runtime:
+      - '0.021898'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ! '{"created_at":"2013-01-30T21:45:42Z","decision_id":34,"decision_user_id":1,"id":21,"meta":null,"position":1,"subject":null,"type":"ImageChoice","updated_at":"2013-01-30T21:45:42Z","image_uri":"https://s3.amazonaws.com/","upload":{"url":"https://recess-dev.s3.amazonaws.com/","params":{"AWSAccessKeyId":"AKIAIYAL2IUDRW6PBPUQ","key":"gotwalt-pro.sf.gotwalt.com/decisions/34/21/1359582342/${filename}","policy":"eyJleHBpcmF0aW9uIjoiMjAxMy0wMS0zMFQyMjo0NTo0MloiLCJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJyZWNlc3MtZGV2In0sWyJzdGFydHMtd2l0aCIsIiRrZXkiLCJnb3R3YWx0LXByby5zZi5nb3R3YWx0LmNvbS9kZWNpc2lvbnMvMzQvMjEvMTM1OTU4MjM0Mi8iXSx7ImFjbCI6InB1YmxpYy1yZWFkIn0seyJzdWNjZXNzX2FjdGlvbl9yZWRpcmVjdCI6Imh0dHA6Ly9sb2NhbGhvc3Q6NTAwMC92MS91c2Vycy8xL2RlY2lzaW9ucy8zNC9jaG9pY2VzLzN6MzgzRDJwM2szajJEMkkwVi9zMyJ9LFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3Nl1dfQ==","signature":"L+fuJLNpquy1z/dQgkDFanvhEWY=","acl":"public-read","success_action_redirect":"http://localhost:5000/v1/users/1/decisions/34/choices/3z383D2p3k3j2D2I0V/s3"}}}'
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:45:42 GMT
+- request:
+    method: delete
+    uri: http://localhost:5000/v1/users/1/decisions/34/choices/21
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Bearer 9774e653f7b3c1de5f21b61adc08ba24
+      Content-Type:
+      - application/json
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      X-Ua-Compatible:
+      - IE=Edge
+      Cache-Control:
+      - no-cache
+      X-Request-Id:
+      - a7961b4c7ba620f19eeab109ac8b2378
+      X-Runtime:
+      - '0.013544'
+      Connection:
+      - close
+      Server:
+      - thin 1.5.0 codename Knife
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Wed, 30 Jan 2013 21:45:42 GMT
+recorded_with: VCR 2.4.0