spotted 0.1.0

data/lib/spotted/file_part.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Spotted
+  class FilePart
+    # @return [Pathname, StringIO, IO, String]
+    attr_reader :content
+
+    # @return [String, nil]
+    attr_reader :content_type
+
+    # @return [String, nil]
+    attr_reader :filename
+
+    # @api private
+    #
+    # @return [String]
+    private def read
+      case content
+      in Pathname
+        content.read(binmode: true)
+      in StringIO
+        content.string
+      in IO
+        content.read
+      in String
+        content
+      end
+    end
+
+    # @param a [Object]
+    #
+    # @return [String]
+    def to_json(*a) = read.to_json(*a)
+
+    # @param a [Object]
+    #
+    # @return [String]
+    def to_yaml(*a) = read.to_yaml(*a)
+
+    # @param content [Pathname, StringIO, IO, String]
+    # @param filename [Pathname, String, nil]
+    # @param content_type [String, nil]
+    def initialize(content, filename: nil, content_type: nil)
+      @content_type = content_type
+      @filename =
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
+        else
+          filename
+        end
+    end
+  end
+end

data/lib/spotted/internal/cursor_url_page.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if cursor_url_page.has_next?
+    #     cursor_url_page = cursor_url_page.next_page
+    #   end
+    #
+    # @example
+    #   cursor_url_page.auto_paging_each do |album|
+    #     puts(album)
+    #   end
+    class CursorURLPage
+      include Spotted::Internal::Type::BasePage
+
+      # @return [String]
+      attr_accessor :next_
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :items
+
+      # @return [Boolean]
+      def next_page?
+        !items.to_a.empty? && !next_.to_s.empty?
+      end
+
+      # @raise [Spotted::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Spotted::Internal::Util.deep_merge(@req, {path: @next_})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.items&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        @next_ = page_data[:next]
+        case page_data
+        in {items: Array => items}
+          @items = items.map { Spotted::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        model = Spotted::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} next_=#{next_.inspect}>"
+      end
+    end
+  end
+end

data/lib/spotted/internal/oauth2.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Internal
+    class OAuth2ClientCredentials
+      # @param token_url [String]
+      # @param client_id [String]
+      # @param client_secret [String]
+      # @param timeout [Integer]
+      # @param client [Object]
+      def initialize(token_url:, client_id:, client_secret:, timeout:, client:)
+        @token_url = token_url
+        @client_id = client_id
+        @client_secret = client_secret
+        @client = client
+        @timeout = timeout
+        @token = nil
+        @token_expires_at = nil
+        @mutex = Thread::Mutex.new
+      end
+
+      # @api private
+      #
+      # @return [Hash{String=>String}]
+      def auth_headers
+        @mutex.synchronize do
+          if @token && !token_expired?
+            return {"Authorization" => "Bearer #{@token}"}
+          end
+
+          @token = nil
+          @token_expires_at = nil
+
+          token_response = fetch_token
+          if token_response
+            @token = token_response[:access_token]
+            @token_expires_at = Time.now + token_response[:expires_in]
+
+            return {"Authorization" => "Bearer #{@token}"}
+          end
+
+          {}
+        end
+      end
+
+      # @api private
+      #
+      # @return [Boolean]
+      private def token_expired?
+        return true if @token_expires_at.nil? || @token.nil?
+
+        # Consider token expired if it expires within 10 seconds
+        Time.now > (@token_expires_at - 10)
+      end
+
+      # @api private
+      #
+      # @return [Object]
+      private def fetch_token
+        body = URI.encode_www_form(
+          {
+            grant_type: "client_credentials",
+            client_id: @client_id,
+            client_secret: @client_secret
+          }
+        )
+        request = {
+          method: :post,
+          url: URI(@token_url),
+          headers: {
+            "Content-Type" => "application/x-www-form-urlencoded"
+          },
+          body: body,
+          max_retries: @client.max_retries,
+          timeout: @timeout
+        }
+        _status, response, stream = @client.send_request(
+          request,
+          redirect_count: 0,
+          retry_count: 0,
+          send_retry_header: true
+        )
+        Spotted::Internal::Util.decode_content(response, stream: stream)
+      end
+    end
+  end
+end