slice-ruby 0.0.2

data/lib/slice/command_builder.rb

@@ -0,0 +1,35 @@
+# ## Slice::CommandBuilder
+# Creates a new command object from the given ARGV.
+#
+# ```ruby
+# builder = Slice::CommandBuilder.new(ARGV)
+# builder.call
+# ```
+#
+module Slice
+  class CommandBuilder
+    ### Slice::CommandBuilder.new(argv)
+    # Creates a new instance of Slice::CommandBuilder from the given command line arguments.
+    #
+    def initialize(argv)
+      @argv = argv
+    end
+
+    ### Slice::CommandBuilder#call
+    # Returns a new instance of command class that inherits from Slice::Commands::Base.
+    #
+    def call
+      if arguments.valid?
+        Slice::Commands::Request.new(arguments)
+      else
+        Slice::Commands::Error.new(arguments)
+      end
+    end
+
+    private
+
+    def arguments
+      @arguments ||= Arguments.new(@argv)
+    end
+  end
+end

data/lib/slice/commands/base.rb

@@ -0,0 +1,13 @@
+module Slice
+  module Commands
+    class Base
+      def initialize(arguments)
+        @arguments = arguments
+      end
+
+      def call
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/slice/commands/error.rb

@@ -0,0 +1,9 @@
+module Slice
+  module Commands
+    class Error < Base
+      def call
+        abort(@arguments.error_message)
+      end
+    end
+  end
+end

data/lib/slice/commands/request.rb

@@ -0,0 +1,29 @@
+module Slice
+  module Commands
+    class Request < Base
+      def call
+        response = client.send(
+          @arguments.method_name,
+          *@arguments.arguments,
+          @arguments.params,
+          @arguments.headers,
+        )
+        print ResponseRenderer.new(
+          response,
+          color: @arguments.color,
+          show_body: @arguments.show_body,
+          show_header: @arguments.show_header,
+        )
+      end
+
+      private
+
+      def client
+        Client.new(
+          access_token: @arguments.access_token,
+          host: @arguments.host,
+        )
+      end
+    end
+  end
+end

data/lib/slice/oauth.rb

@@ -0,0 +1,21 @@
+require "oauth2"
+
+module Slice
+  class OAuth
+    def initialize(client_id, client_secret, redirect_url)
+      @client_id = client_id
+      @client_secret = client_secret
+      @redirect_url = redirect_url
+    end
+
+    def generate_auth_url
+      @client = OAuth2::Client.new(@client_id, @client_secret,
+                                   :site => "https://#{Slice::Client::DEFAULT_HOST}")
+      @client.auth_code.authorize_url(:redirect_uri => @redirect_url)
+    end
+
+    def authenticate! auth_code
+      @client.auth_code.get_token(auth_code, :redirect_uri => @redirect_url)
+    end
+  end
+end

data/lib/slice/resource_based_methods.rb

@@ -0,0 +1,229 @@
+module Slice
+  module ResourceBasedMethods
+
+    # ## 'Users' Resources
+
+    # ### Slice::Client#whoami(params = nil, headers = nil)
+    # Get the user object corresponding to the OAuth token
+    #
+    def whoami(params = nil, headers = nil)
+      get("/api/v1/users/self", params, headers)
+    end
+
+
+    # ## 'Mailboxes' Resources
+
+    # ### Slice::Client#list_mailboxes(params = nil, headers = nil)
+    # List mailboxes
+    #
+    def list_mailboxes(params = nil, headers = nil)
+      get("/api/v1/mailboxes", params, headers)
+    end
+
+    # ### Slice::Client#get_mailbox(params = nil, headers = nil)
+    # Get a particular mailbox
+    #
+    def get_mailbox(id, params = nil, headers = nil)
+      get("/api/v1/mailboxes/#{id}", params, headers)
+    end
+
+
+    # ## 'Orders' Resources
+
+    # ### Slice::Client#list_orders(params = nil, headers = nil)
+    # List orders
+    #
+    def list_orders(params = nil, headers = nil)
+      get("/api/v1/orders", params, headers)
+    end
+
+    # ### Slice::Client#create_order(params = nil, headers = nil)
+    # Create a new order
+    #
+    def create_order(params = nil, headers = nil)
+      post("/api/v1/orders", params, headers)
+    end
+
+    # ### Slice::Client#get_order(params = nil, headers = nil)
+    # Get a particular order
+    #
+    def get_order(id, params = nil, headers = nil)
+      get("/api/v1/orders/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#update_order(params = nil, headers = nil)
+    # Update a particular order
+    #
+    def update_order(id, params = nil, headers = nil)
+      put("/api/v1/orders/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#delete_order(params = nil, headers = nil)
+    # Delete a particular order
+    #
+    def delete_order(id, params = nil, headers = nil)
+      delete("/api/v1/orders/#{id}", params, headers)
+    end
+
+    # ## 'Items' Resources
+
+    # ### Slice::Client#list_items(params = nil, headers = nil)
+    # List items
+    #
+    def list_items(params = nil, headers = nil)
+      get("/api/v1/items", params, headers)
+    end
+
+    # ### Slice::Client#create_item(params = nil, headers = nil)
+    # Create a new item
+    #
+    def create_item(params = nil, headers = nil)
+      post("/api/v1/items", params, headers)
+    end
+
+    # ### Slice::Client#get_item(params = nil, headers = nil)
+    # Get a particular item
+    #
+    def get_item(id, params = nil, headers = nil)
+      get("/api/v1/items/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#update_item(params = nil, headers = nil)
+    # Update a particular item
+    #
+    def update_item(id, params = nil, headers = nil)
+      put("/api/v1/items/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#delete_item(params = nil, headers = nil)
+    # Delete a particular item
+    #
+    def delete_item(id, params = nil, headers = nil)
+      delete("/api/v1/items/#{id}", params, headers)
+    end
+
+
+    # ## 'Shipments' Resources
+
+    # ### Slice::Client#list_shipments(params = nil, headers = nil)
+    # List shipments
+    #
+    def list_shipments(params = nil, headers = nil)
+      get("/api/v1/shipments", params, headers)
+    end
+
+    # ### Slice::Client#create_shipment(params = nil, headers = nil)
+    # Create a new shipment
+    #
+    def create_shipment(params = nil, headers = nil)
+      post("/api/v1/shipments", params, headers)
+    end
+
+    # ### Slice::Client#get_shipment(params = nil, headers = nil)
+    # Get a particular shipment
+    #
+    def get_shipment(id, params = nil, headers = nil)
+      get("/api/v1/shipments/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#update_shipment(params = nil, headers = nil)
+    # Update a particular shipment
+    #
+    def update_shipment(id, params = nil, headers = nil)
+      put("/api/v1/shipments/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#delete_shipment(params = nil, headers = nil)
+    # Delete a particular shipment
+    #
+    def delete_shipment(id, params = nil, headers = nil)
+      delete("/api/v1/shipments/#{id}", params, headers)
+    end
+
+
+    # ## 'Merchants' Resources
+
+    # ### Slice::Client#get_merchant(params = nil, headers = nil)
+    # Get a particular merchant
+    #
+    def get_merchant(id, params = nil, headers = nil)
+      get("/api/v1/merchants/#{id}", params, headers)
+    end
+
+
+    # ## 'Recalls' Resources
+
+    # ### Slice::Client#list_recalls(params = nil, headers = nil)
+    # List recalls for the user
+    #
+    def list_recalls(params = nil, headers = nil)
+      get("/api/v1/recalls", params, headers)
+    end
+
+    # ### Slice::Client#get_recall(params = nil, headers = nil)
+    # Get a particular recall for the user
+    #
+    def get_recall(id, params = nil, headers = nil)
+      get("/api/v1/recalls/#{id}", params, headers)
+    end
+
+
+    # ## 'Email' Resources
+
+    # ### Slice::Client#get_email(params = nil, headers = nil)
+    # Get a particular email
+    #
+    def get_email(id, params = nil, headers = nil)
+      get("/api/v1/emails/#{id}", params, headers)
+    end
+
+    # ### Slice::Client#get_email(params = nil, headers = nil)
+    # Get a particular email
+    #
+    def get_email_content(id, params = nil, headers = nil)
+      get("/api/v1/emails/#{id}/content", params, headers)
+    end
+
+
+    # ## Dictionary (static) Resources
+
+    # ### Slice::Client#list_categories(params = nil, headers = nil)
+    # List categories of items that a user may have purchased
+    #
+    def list_categories(params = nil, headers = nil)
+      get("/api/v1/categories", params, headers)
+    end
+
+    # ### Slice::Client#list_providers(params = nil, headers = nil)
+    # List providers of items that a user may have purchased
+    #
+    def list_providers(params = nil, headers = nil)
+      get("/api/v1/providers", params, headers)
+    end
+
+    # ### Slice::Client#list_purchasetypes(params = nil, headers = nil)
+    # List different types of purchases
+    #
+    def list_purchasetypes(params = nil, headers = nil)
+      get("/api/v1/purchasetypes", params, headers)
+    end
+
+    # ### Slice::Client#list_shippers(params = nil, headers = nil)
+    # List shippers that may be used to deliver packages
+    #
+    def list_shippers(params = nil, headers = nil)
+      get("/api/v1/shippers", params, headers)
+    end
+
+
+    # ## 'Action' Resources
+
+    # ### Slice::Client#update(params = nil, headers = nil)
+    # Tell Slice to recrawl the mailboxes of the user
+    #
+    def update(params = nil, headers = nil)
+      post("/api/v1/actions/update", params, headers)
+    end
+
+  end
+end

data/lib/slice/response.rb

@@ -0,0 +1,92 @@
+# ## Slice::Response
+# A class for response data returned from API.
+#
+module Slice
+  class Response
+    def initialize(faraday_response)
+      @raw_body = faraday_response.body
+      @raw_headers = faraday_response.headers
+      @raw_status = faraday_response.status
+    end
+
+    # ### Slice::Response#body
+    # Returns response body returned from API as a `Hash` or an `Array` of `Hash`.
+    #
+    # ```rb
+    # response.body #=> { ... }
+    # ```
+    #
+    def body
+      @raw_body
+    end
+
+    # ### Slice::Response#first_page_url
+    # Returns first page URL or nil.
+    #
+    def first_page_url
+      links_table["first"]
+    end
+
+    # ### Slice::Response#last_page_url
+    # Returns last page URL or nil.
+    #
+    def last_page_url
+      links_table["last"]
+    end
+
+    # ### Slice::Response#next_page_url
+    # Returns next page URL or nil.
+    #
+    def next_page_url
+      links_table["next"]
+    end
+
+    # ### Slice::Response#previous_page_url
+    # Returns previous page URL or nil.
+    #
+    def previous_page_url
+      links_table["prev"]
+    end
+
+    # ### Slice::Response#headers
+    # Returns response headers returned from API as a `Hash`.
+    #
+    # ```rb
+    # response.headers #=> { "Content-Type" => "application/json" }
+    # ```
+    #
+    def headers
+      @headers ||= @raw_headers.inject({}) do |result, (key, value)|
+        result.merge(key.split("-").map(&:capitalize).join("-") => value)
+      end
+    end
+
+    # ### Slice::Response#status
+    # Returns response status code returned from API as a `Fixnum`.
+    #
+    # ```rb
+    # response.status #=> 200
+    # ```
+    #
+    def status
+      @raw_status
+    end
+
+    def to_s
+      @to_s ||= ResponseRenderer.new(self, show_body: true, show_header: true).to_s
+    end
+
+    def status_message
+      Rack::Utils::HTTP_STATUS_CODES[status]
+    end
+
+    private
+
+    def links_table
+      @links_table ||= (headers["Link"] || "").split(", ").inject({}) do |table, section|
+        url, rel = section.match(/\A<(.+)>; rel="(.+)"\z/)[1..2]
+        table.merge(rel => url)
+      end
+    end
+  end
+end

data/lib/slice/response_renderer.rb

@@ -0,0 +1,79 @@
+module Slice
+  class ResponseRenderer
+    def initialize(response, color: nil, show_header: nil, show_body: nil)
+      @response = response
+      @color = color
+      @show_body = show_body
+      @show_header = show_header
+    end
+
+    def to_s
+      template % {
+        status: status,
+        headers: headers,
+        body: body,
+      }
+    end
+
+    private
+
+    def template
+      str = ""
+      str << <<-EOS.strip_heredoc if @show_header
+        HTTP/1.1 %{status}
+        %{headers}
+      EOS
+      if has_body? && @show_body
+        str << "\n" if @show_header
+        str << "%{body}"
+      end
+      str
+    end
+
+    def headers
+      @response.headers.sort_by do |key, value|
+        key
+      end.map do |key, value|
+        "%{key}: %{value}" % {
+          key: Rainbow(key.split("-").map(&:camelize).join("-")).underline,
+          value: Rainbow(value).green,
+        }
+      end.join("\n")
+    end
+
+    def status
+      Rainbow("#{@response.status} #{@response.status_message}").bright
+    end
+
+    def body
+      if @color
+        Rouge::Formatters::Terminal256.format(
+          Rouge::Lexers::Ruby.new.lex(plain_body),
+          theme: "github"
+        )
+      else
+        plain_body
+      end
+    end
+
+    def plain_body
+      if has_body?
+        JSON.pretty_generate(@response.body) + "\n"
+      else
+        ""
+      end
+    end
+
+    def Rainbow(str)
+      if @color
+        super
+      else
+        Rainbow::NullPresenter.new(str.to_s)
+      end
+    end
+
+    def has_body?
+      @response.status != 204
+    end
+  end
+end