finch-api 0.1.0.pre.alpha.3 → 0.1.0.pre.alpha.5

data/rbi/lib/finch-api/pooled_net_requester.rbi

@@ -1,59 +0,0 @@
-# typed: strong
-
-module FinchAPI
-  # @api private
-  class PooledNetRequester
-    RequestShape =
-      T.type_alias do
-        {
-          method: Symbol,
-          url: URI::Generic,
-          headers: T::Hash[String, String],
-          body: T.anything,
-          deadline: Float
-        }
-      end
-
-    # from the golang stdlib
-    #   https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
-    KEEP_ALIVE_TIMEOUT = 30
-
-    class << self
-      # @api private
-      sig { params(url: URI::Generic).returns(Net::HTTP) }
-      def connect(url)
-      end
-
-      # @api private
-      sig { params(conn: Net::HTTP, deadline: Float).void }
-      def calibrate_socket_timeout(conn, deadline)
-      end
-
-      # @api private
-      sig do
-        params(request: FinchAPI::PooledNetRequester::RequestShape, blk: T.proc.params(arg0: String).void)
-          .returns(Net::HTTPGenericRequest)
-      end
-      def build_request(request, &blk)
-      end
-    end
-
-    # @api private
-    sig { params(url: URI::Generic, deadline: Float, blk: T.proc.params(arg0: Net::HTTP).void).void }
-    private def with_pool(url, deadline:, &blk)
-    end
-
-    # @api private
-    sig do
-      params(request: FinchAPI::PooledNetRequester::RequestShape)
-        .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
-    end
-    def execute(request)
-    end
-
-    # @api private
-    sig { params(size: Integer).returns(T.attached_class) }
-    def self.new(size: Etc.nprocessors)
-    end
-  end
-end

data/sig/finch-api/base_client.rbs

@@ -1,106 +0,0 @@
-module FinchAPI
-  class BaseClient
-    type request_components =
-      {
-        method: Symbol,
-        path: String | ::Array[String],
-        query: ::Hash[String, (::Array[String] | String)?]?,
-        headers: ::Hash[String, (String
-        | Integer
-        | ::Array[(String | Integer)?])?]?,
-        body: top?,
-        unwrap: Symbol?,
-        page: Class?,
-        stream: Class?,
-        model: FinchAPI::Converter::input?,
-        options: FinchAPI::request_opts?
-      }
-
-    type request_input =
-      {
-        method: Symbol,
-        url: URI::Generic,
-        headers: ::Hash[String, String],
-        body: top,
-        max_retries: Integer,
-        timeout: Float
-      }
-
-    MAX_REDIRECTS: 20
-
-    PLATFORM_HEADERS: ::Hash[String, String]
-
-    def self.validate!: (FinchAPI::BaseClient::request_components req) -> void
-
-    def self.should_retry?: (
-      Integer status,
-      headers: ::Hash[String, String]
-    ) -> bool
-
-    def self.follow_redirect: (
-      FinchAPI::BaseClient::request_input request,
-      status: Integer,
-      response_headers: ::Hash[String, String]
-    ) -> FinchAPI::BaseClient::request_input
-
-    def self.reap_connection!: (
-      Integer | FinchAPI::APIConnectionError status,
-      stream: Enumerable[String]?
-    ) -> void
-
-    # @api private
-    attr_accessor requester: top
-
-    def initialize: (
-      base_url: String,
-      ?timeout: Float,
-      ?max_retries: Integer,
-      ?initial_retry_delay: Float,
-      ?max_retry_delay: Float,
-      ?headers: ::Hash[String, (String
-      | Integer
-      | ::Array[(String | Integer)?])?],
-      ?idempotency_header: String?
-    ) -> void
-
-    private def auth_headers: -> ::Hash[String, String]
-
-    private def generate_idempotency_key: -> String
-
-    private def build_request: (
-      FinchAPI::BaseClient::request_components req,
-      FinchAPI::request_options opts
-    ) -> FinchAPI::BaseClient::request_input
-
-    private def retry_delay: (
-      ::Hash[String, String] headers,
-      retry_count: Integer
-    ) -> Float
-
-    private def send_request: (
-      FinchAPI::BaseClient::request_input request,
-      redirect_count: Integer,
-      retry_count: Integer,
-      send_retry_header: bool
-    ) -> [Integer, top, Enumerable[String]]
-
-    def request:
-      (
-        Symbol method,
-        String | ::Array[String] path,
-        ?query: ::Hash[String, (::Array[String] | String)?]?,
-        ?headers: ::Hash[String, (String
-        | Integer
-        | ::Array[(String | Integer)?])?]?,
-        ?body: top?,
-        ?unwrap: Symbol?,
-        ?page: Class?,
-        ?stream: Class?,
-        ?model: FinchAPI::Converter::input?,
-        ?options: FinchAPI::request_opts?
-      ) -> top
-      | (FinchAPI::BaseClient::request_components req) -> top
-
-    def inspect: -> String
-  end
-end

data/sig/finch-api/base_model.rbs

@@ -1,260 +0,0 @@
-module FinchAPI
-  module Converter
-    type input = FinchAPI::Converter | Class
-
-    def coerce: (top value) -> top
-
-    def dump: (top value) -> top
-
-    def try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-
-    def self.type_info: (
-      {
-        const: (nil | bool | Integer | Float | Symbol)?,
-        enum: ^-> FinchAPI::Converter::input?,
-        union: ^-> FinchAPI::Converter::input?
-      }
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input spec
-    ) -> (^-> top)
-
-    def self.coerce: (FinchAPI::Converter::input target, top value) -> top
-
-    def self.dump: (FinchAPI::Converter::input target, top value) -> top
-
-    def self.try_strict_coerce: (
-      FinchAPI::Converter::input target,
-      top value
-    ) -> top
-  end
-
-  class Unknown
-    extend FinchAPI::Converter
-
-    def self.===: (top other) -> bool
-
-    def self.==: (top other) -> bool
-
-    def self.coerce: (top value) -> top
-
-    def self.dump: (top value) -> top
-
-    def self.try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-  end
-
-  class BooleanModel
-    extend FinchAPI::Converter
-
-    def self.===: (top other) -> bool
-
-    def self.==: (top other) -> bool
-
-    def self.coerce: (bool | top value) -> (bool | top)
-
-    def self.dump: (bool | top value) -> (bool | top)
-
-    def self.try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-  end
-
-  module Enum
-    include FinchAPI::Converter
-
-    def self.values: -> ::Array[(nil | bool | Integer | Float | Symbol)]
-
-    private def self.finalize!: -> void
-
-    def ===: (top other) -> bool
-
-    def ==: (top other) -> bool
-
-    def coerce: (String | Symbol | top value) -> (Symbol | top)
-
-    def dump: (Symbol | top value) -> (Symbol | top)
-
-    def try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-  end
-
-  module Union
-    include FinchAPI::Converter
-
-    private def self.known_variants: -> ::Array[[Symbol?, (^-> FinchAPI::Converter::input)]]
-
-    def self.derefed_variants: -> ::Array[[Symbol?, top]]
-
-    def self.variants: -> ::Array[top]
-
-    private def self.discriminator: (Symbol property) -> void
-
-    private def self.variant: (
-      Symbol
-      | ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input key,
-      ?::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input spec
-    ) -> void
-
-    private def self.resolve_variant: (top value) -> FinchAPI::Converter::input?
-
-    def ===: (top other) -> bool
-
-    def ==: (top other) -> bool
-
-    def coerce: (top value) -> top
-
-    def dump: (top value) -> top
-
-    def try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-  end
-
-  class ArrayOf
-    include FinchAPI::Converter
-
-    def self.[]: (
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> instance
-
-    def ===: (top other) -> bool
-
-    def ==: (top other) -> bool
-
-    def coerce: (Enumerable[top] | top value) -> (::Array[top] | top)
-
-    def dump: (Enumerable[top] | top value) -> (::Array[top] | top)
-
-    def try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-
-    def item_type: -> top
-
-    def initialize: (
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> void
-  end
-
-  class HashOf
-    include FinchAPI::Converter
-
-    def self.[]: (
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> instance
-
-    def ===: (top other) -> bool
-
-    def ==: (top other) -> bool
-
-    def coerce: (::Hash[top, top] | top value) -> (::Hash[Symbol, top] | top)
-
-    def dump: (::Hash[top, top] | top value) -> (::Hash[Symbol, top] | top)
-
-    def try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-
-    def item_type: -> top
-
-    def initialize: (
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> void
-  end
-
-  class BaseModel
-    extend FinchAPI::Converter
-
-    type known_field = { mode: (:coerce | :dump)?, required: bool }
-
-    def self.known_fields: -> ::Hash[Symbol, (FinchAPI::BaseModel::known_field
-    & { type_fn: (^-> FinchAPI::Converter::input) })]
-
-    def self.reverse_map: -> ::Hash[Symbol, Symbol]
-
-    def self.fields: -> ::Hash[Symbol, (FinchAPI::BaseModel::known_field
-    & { type: FinchAPI::Converter::input })]
-
-    def self.defaults: -> ::Hash[Symbol, (^-> Class)]
-
-    private def self.add_field: (
-      Symbol name_sym,
-      required: bool,
-      type_info: {
-        const: (nil | bool | Integer | Float | Symbol)?,
-        enum: ^-> FinchAPI::Converter::input?,
-        union: ^-> FinchAPI::Converter::input?,
-        api_name: Symbol
-      }
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input,
-      spec: ::Hash[Symbol, top]
-    ) -> void
-
-    def self.required: (
-      Symbol name_sym,
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> void
-
-    def self.optional: (
-      Symbol name_sym,
-      ::Hash[Symbol, top]
-      | ^-> FinchAPI::Converter::input
-      | FinchAPI::Converter::input type_info,
-      ?::Hash[Symbol, top] spec
-    ) -> void
-
-    private def self.request_only: { -> void } -> void
-
-    private def self.response_only: { -> void } -> void
-
-    def ==: (top other) -> bool
-
-    def self.coerce: (
-      FinchAPI::BaseModel | ::Hash[top, top] | top value
-    ) -> (instance | top)
-
-    def self.dump: (instance | top value) -> (::Hash[top, top] | top)
-
-    def self.try_strict_coerce: (
-      top value
-    ) -> ([true, top, nil] | [false, bool, Integer])
-
-    def []: (Symbol key) -> top?
-
-    def to_h: -> ::Hash[Symbol, top]
-
-    alias to_hash to_h
-
-    def deconstruct_keys: (::Array[Symbol]? keys) -> ::Hash[Symbol, top]
-
-    def initialize: (?::Hash[Symbol, top] | self data) -> void
-
-    def to_s: -> String
-
-    def inspect: -> String
-  end
-end

data/sig/finch-api/base_page.rbs

@@ -1,20 +0,0 @@
-module FinchAPI
-  module BasePage[Elem]
-    def next_page?: -> bool
-
-    def next_page: -> self
-
-    def auto_paging_each: { (Elem arg0) -> void } -> void
-
-    def to_enum: -> Enumerable[Elem]
-
-    alias enum_for to_enum
-
-    def initialize: (
-      client: FinchAPI::BaseClient,
-      req: FinchAPI::BaseClient::request_components,
-      headers: ::Hash[String, String],
-      page_data: top
-    ) -> void
-  end
-end

data/sig/finch-api/extern.rbs

@@ -1,4 +0,0 @@
-module FinchAPI
-  module Extern
-  end
-end

data/sig/finch-api/pooled_net_requester.rbs

@@ -1,37 +0,0 @@
-module FinchAPI
-  class PooledNetRequester
-    type request =
-      {
-        method: Symbol,
-        url: URI::Generic,
-        headers: ::Hash[String, String],
-        body: top,
-        deadline: Float
-      }
-
-    KEEP_ALIVE_TIMEOUT: 30
-
-    def self.connect: (URI::Generic url) -> top
-
-    def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
-
-    def self.build_request: (
-      FinchAPI::PooledNetRequester::request request
-    ) {
-      (String arg0) -> void
-    } -> top
-
-    private def with_pool: (
-      URI::Generic url,
-      deadline: Float
-    ) {
-      (top arg0) -> void
-    } -> void
-
-    def execute: (
-      FinchAPI::PooledNetRequester::request request
-    ) -> [Integer, top, Enumerable[String]]
-
-    def initialize: (?size: Integer) -> void
-  end
-end