terminal-shop 1.8.0 → 2.1.0

data/rbi/lib/terminal-shop/base_model.rbi

@@ -1,622 +0,0 @@
-# typed: strong
-
-module TerminalShop
-  # @api private
-  module Converter
-    Input = T.type_alias { T.any(TerminalShop::Converter, T::Class[T.anything]) }
-
-    # @api private
-    sig { overridable.params(value: T.anything).returns(T.anything) }
-    def coerce(value)
-    end
-
-    # @api private
-    sig { overridable.params(value: T.anything).returns(T.anything) }
-    def dump(value)
-    end
-
-    # @api private
-    sig do
-      overridable
-        .params(value: T.anything)
-        .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-    end
-    def try_strict_coerce(value)
-    end
-
-    class << self
-      # @api private
-      sig do
-        params(
-          spec: T.any(
-            {
-              const: T.nilable(T.any(NilClass, T::Boolean, Integer, Float, Symbol)),
-              enum: T.nilable(T.proc.returns(TerminalShop::Converter::Input)),
-              union: T.nilable(T.proc.returns(TerminalShop::Converter::Input))
-            },
-            T.proc.returns(TerminalShop::Converter::Input),
-            TerminalShop::Converter::Input
-          )
-        )
-          .returns(T.proc.returns(T.anything).void)
-      end
-      def self.type_info(spec)
-      end
-
-      # @api private
-      #
-      # Based on `target`, transform `value` into `target`, to the extent possible:
-      #
-      #   1. if the given `value` conforms to `target` already, return the given `value`
-      #   2. if it's possible and safe to convert the given `value` to `target`, then the
-      #      converted value
-      #   3. otherwise, the given `value` unaltered
-      sig { params(target: TerminalShop::Converter::Input, value: T.anything).returns(T.anything) }
-      def self.coerce(target, value)
-      end
-
-      # @api private
-      sig { params(target: TerminalShop::Converter::Input, value: T.anything).returns(T.anything) }
-      def self.dump(target, value)
-      end
-
-      # @api private
-      #
-      # The underlying algorithm for computing maximal compatibility is subject to
-      #   future improvements.
-      #
-      #   Similar to `#.coerce`, used to determine the best union variant to decode into.
-      #
-      #   1. determine if strict-ish coercion is possible
-      #   2. return either result of successful coercion or if loose coercion is possible
-      #   3. return a score for recursively tallied count for fields that can be coerced
-      sig { params(target: TerminalShop::Converter::Input, value: T.anything).returns(T.anything) }
-      def self.try_strict_coerce(target, value)
-      end
-    end
-  end
-
-  # @api private
-  #
-  # When we don't know what to expect for the value.
-  class Unknown
-    extend TerminalShop::Converter
-
-    abstract!
-    final!
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def self.===(other)
-    end
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def self.==(other)
-    end
-
-    class << self
-      # @api private
-      sig(:final) { override.params(value: T.anything).returns(T.anything) }
-      def coerce(value)
-      end
-
-      # @api private
-      sig(:final) { override.params(value: T.anything).returns(T.anything) }
-      def dump(value)
-      end
-
-      # @api private
-      sig(:final) do
-        override
-          .params(value: T.anything)
-          .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-      end
-      def try_strict_coerce(value)
-      end
-    end
-  end
-
-  # @api private
-  #
-  # Ruby has no Boolean class; this is something for models to refer to.
-  class BooleanModel
-    extend TerminalShop::Converter
-
-    abstract!
-    final!
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def self.===(other)
-    end
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def self.==(other)
-    end
-
-    class << self
-      # @api private
-      sig(:final) do
-        override.params(value: T.any(T::Boolean, T.anything)).returns(T.any(T::Boolean, T.anything))
-      end
-      def coerce(value)
-      end
-
-      # @api private
-      sig(:final) do
-        override.params(value: T.any(T::Boolean, T.anything)).returns(T.any(T::Boolean, T.anything))
-      end
-      def dump(value)
-      end
-
-      # @api private
-      sig(:final) do
-        override
-          .params(value: T.anything)
-          .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-      end
-      def try_strict_coerce(value)
-      end
-    end
-  end
-
-  # @api private
-  #
-  # A value from among a specified list of options. OpenAPI enum values map to Ruby
-  #   values in the SDK as follows:
-  #
-  #   1. boolean => true | false
-  #   2. integer => Integer
-  #   3. float => Float
-  #   4. string => Symbol
-  #
-  #   We can therefore convert string values to Symbols, but can't convert other
-  #   values safely.
-  class Enum
-    extend TerminalShop::Converter
-
-    abstract!
-
-    Value = type_template(:out)
-
-    class << self
-      # All of the valid Symbol values for this enum.
-      sig { overridable.returns(T::Array[Value]) }
-      def values
-      end
-
-      # @api private
-      #
-      # Guard against thread safety issues by instantiating `@values`.
-      sig { void }
-      private def finalize!
-      end
-    end
-
-    sig { params(other: T.anything).returns(T::Boolean) }
-    def self.===(other)
-    end
-
-    sig { params(other: T.anything).returns(T::Boolean) }
-    def self.==(other)
-    end
-
-    class << self
-      # @api private
-      sig { override.params(value: T.any(String, Symbol, T.anything)).returns(T.any(Symbol, T.anything)) }
-      def coerce(value)
-      end
-
-      # @api private
-      sig { override.params(value: T.any(Symbol, T.anything)).returns(T.any(Symbol, T.anything)) }
-      def dump(value)
-      end
-
-      # @api private
-      sig do
-        override
-          .params(value: T.anything)
-          .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-      end
-      def try_strict_coerce(value)
-      end
-    end
-  end
-
-  # @api private
-  class Union
-    extend TerminalShop::Converter
-
-    abstract!
-
-    Variants = type_template(:out)
-
-    class << self
-      # @api private
-      #
-      # All of the specified variant info for this union.
-      sig { returns(T::Array[[T.nilable(Symbol), T.proc.returns(Variants)]]) }
-      private def known_variants
-      end
-
-      # @api private
-      sig { returns(T::Array[[T.nilable(Symbol), Variants]]) }
-      protected def derefed_variants
-      end
-
-      # All of the specified variants for this union.
-      sig { overridable.returns(T::Array[Variants]) }
-      def variants
-      end
-
-      # @api private
-      sig { params(property: Symbol).void }
-      private def discriminator(property)
-      end
-
-      # @api private
-      sig do
-        params(
-          key: T.any(Symbol, T::Hash[Symbol, T.anything], T.proc.returns(Variants), Variants),
-          spec: T.any(T::Hash[Symbol, T.anything], T.proc.returns(Variants), Variants)
-        )
-          .void
-      end
-      private def variant(key, spec = nil)
-      end
-
-      # @api private
-      sig { params(value: T.anything).returns(T.nilable(Variants)) }
-      private def resolve_variant(value)
-      end
-    end
-
-    sig { params(other: T.anything).returns(T::Boolean) }
-    def self.===(other)
-    end
-
-    sig { params(other: T.anything).returns(T::Boolean) }
-    def self.==(other)
-    end
-
-    class << self
-      # @api private
-      sig { override.params(value: T.anything).returns(T.anything) }
-      def coerce(value)
-      end
-
-      # @api private
-      sig { override.params(value: T.anything).returns(T.anything) }
-      def dump(value)
-      end
-
-      # @api private
-      sig do
-        override
-          .params(value: T.anything)
-          .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-      end
-      def try_strict_coerce(value)
-      end
-    end
-  end
-
-  # @api private
-  #
-  # Array of items of a given type.
-  class ArrayOf
-    include TerminalShop::Converter
-
-    abstract!
-    final!
-
-    Elem = type_member(:out)
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def ===(other)
-    end
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def ==(other)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.any(T::Enumerable[T.anything], T.anything))
-        .returns(T.any(T::Array[T.anything], T.anything))
-    end
-    def coerce(value)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.any(T::Enumerable[T.anything], T.anything))
-        .returns(T.any(T::Array[T.anything], T.anything))
-    end
-    def dump(value)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.anything)
-        .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-    end
-    def try_strict_coerce(value)
-    end
-
-    # @api private
-    sig(:final) { returns(Elem) }
-    protected def item_type
-    end
-
-    # @api private
-    sig(:final) do
-      params(
-        type_info: T.any(
-          T::Hash[Symbol, T.anything],
-          T.proc.returns(TerminalShop::Converter::Input),
-          TerminalShop::Converter::Input
-        ),
-        spec: T::Hash[Symbol, T.anything]
-      )
-        .returns(T.attached_class)
-    end
-    def self.new(type_info, spec = {})
-    end
-  end
-
-  # @api private
-  #
-  # Hash of items of a given type.
-  class HashOf
-    include TerminalShop::Converter
-
-    abstract!
-    final!
-
-    Elem = type_member(:out)
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def ===(other)
-    end
-
-    sig(:final) { params(other: T.anything).returns(T::Boolean) }
-    def ==(other)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.any(T::Hash[T.anything, T.anything], T.anything))
-        .returns(T.any(T::Hash[Symbol, T.anything], T.anything))
-    end
-    def coerce(value)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.any(T::Hash[T.anything, T.anything], T.anything))
-        .returns(T.any(T::Hash[Symbol, T.anything], T.anything))
-    end
-    def dump(value)
-    end
-
-    # @api private
-    sig(:final) do
-      override
-        .params(value: T.anything)
-        .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-    end
-    def try_strict_coerce(value)
-    end
-
-    # @api private
-    sig(:final) { returns(Elem) }
-    protected def item_type
-    end
-
-    # @api private
-    sig(:final) do
-      params(
-        type_info: T.any(
-          T::Hash[Symbol, T.anything],
-          T.proc.returns(TerminalShop::Converter::Input),
-          TerminalShop::Converter::Input
-        ),
-        spec: T::Hash[Symbol, T.anything]
-      )
-        .returns(T.attached_class)
-    end
-    def self.new(type_info, spec = {})
-    end
-  end
-
-  class BaseModel
-    extend TerminalShop::Converter
-
-    abstract!
-
-    KnownFieldShape = T.type_alias { {mode: T.nilable(Symbol), required: T::Boolean} }
-
-    class << self
-      # @api private
-      #
-      # Assumes superclass fields are totally defined before fields are accessed /
-      #   defined on subclasses.
-      sig do
-        returns(
-          T::Hash[
-          Symbol,
-          T.all(
-            TerminalShop::BaseModel::KnownFieldShape,
-            {type_fn: T.proc.returns(TerminalShop::Converter::Input)}
-          )
-          ]
-        )
-      end
-      def known_fields
-      end
-
-      # @api private
-      sig do
-        returns(
-          T::Hash[Symbol,
-                  T.all(TerminalShop::BaseModel::KnownFieldShape, {type: TerminalShop::Converter::Input})]
-        )
-      end
-      def fields
-      end
-
-      # @api private
-      sig { returns(T::Hash[Symbol, T.proc.returns(T::Class[T.anything])]) }
-      def defaults
-      end
-
-      # @api private
-      sig do
-        params(
-          name_sym: Symbol,
-          required: T::Boolean,
-          type_info: T.any(
-            {
-              const: T.nilable(T.any(NilClass, T::Boolean, Integer, Float, Symbol)),
-              enum: T.nilable(T.proc.returns(TerminalShop::Converter::Input)),
-              union: T.nilable(T.proc.returns(TerminalShop::Converter::Input)),
-              api_name: Symbol,
-              nil?: T::Boolean
-            },
-            T.proc.returns(TerminalShop::Converter::Input),
-            TerminalShop::Converter::Input
-          ),
-          spec: T::Hash[Symbol, T.anything]
-        )
-          .void
-      end
-      private def add_field(name_sym, required:, type_info:, spec:)
-      end
-
-      # @api private
-      sig do
-        params(
-          name_sym: Symbol,
-          type_info: T.any(
-            T::Hash[Symbol, T.anything],
-            T.proc.returns(TerminalShop::Converter::Input),
-            TerminalShop::Converter::Input
-          ),
-          spec: T::Hash[Symbol, T.anything]
-        )
-          .void
-      end
-      def required(name_sym, type_info, spec = {})
-      end
-
-      # @api private
-      sig do
-        params(
-          name_sym: Symbol,
-          type_info: T.any(
-            T::Hash[Symbol, T.anything],
-            T.proc.returns(TerminalShop::Converter::Input),
-            TerminalShop::Converter::Input
-          ),
-          spec: T::Hash[Symbol, T.anything]
-        )
-          .void
-      end
-      def optional(name_sym, type_info, spec = {})
-      end
-
-      # @api private
-      #
-      # `request_only` attributes not excluded from `.#coerce` when receiving responses
-      #   even if well behaved servers should not send them
-      sig { params(blk: T.proc.void).void }
-      private def request_only(&blk)
-      end
-
-      # @api private
-      #
-      # `response_only` attributes are omitted from `.#dump` when making requests
-      sig { params(blk: T.proc.void).void }
-      private def response_only(&blk)
-      end
-    end
-
-    sig { params(other: T.anything).returns(T::Boolean) }
-    def ==(other)
-    end
-
-    class << self
-      # @api private
-      sig do
-        override
-          .params(value: T.any(TerminalShop::BaseModel, T::Hash[T.anything, T.anything], T.anything))
-          .returns(T.any(T.attached_class, T.anything))
-      end
-      def coerce(value)
-      end
-
-      # @api private
-      sig do
-        override
-          .params(value: T.any(T.attached_class, T.anything))
-          .returns(T.any(T::Hash[T.anything, T.anything], T.anything))
-      end
-      def dump(value)
-      end
-
-      # @api private
-      sig do
-        override
-          .params(value: T.anything)
-          .returns(T.any([T::Boolean, T.anything, NilClass], [T::Boolean, T::Boolean, Integer]))
-      end
-      def try_strict_coerce(value)
-      end
-    end
-
-    # Returns the raw value associated with the given key, if found. Otherwise, nil is
-    #   returned.
-    #
-    #   It is valid to lookup keys that are not in the API spec, for example to access
-    #   undocumented features. This method does not parse response data into
-    #   higher-level types. Lookup by anything other than a Symbol is an ArgumentError.
-    sig { params(key: Symbol).returns(T.nilable(T.anything)) }
-    def [](key)
-    end
-
-    # Returns a Hash of the data underlying this object. O(1)
-    #
-    #   Keys are Symbols and values are the raw values from the response. The return
-    #   value indicates which values were ever set on the object. i.e. there will be a
-    #   key in this hash if they ever were, even if the set value was nil.
-    #
-    #   This method is not recursive. The returned value is shared by the object, so it
-    #   should not be mutated.
-    sig { overridable.returns(T::Hash[Symbol, T.anything]) }
-    def to_h
-    end
-
-    alias_method :to_hash, :to_h
-
-    sig { params(keys: T.nilable(T::Array[Symbol])).returns(T::Hash[Symbol, T.anything]) }
-    def deconstruct_keys(keys)
-    end
-
-    # Create a new instance of a model.
-    sig { params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(T.attached_class) }
-    def self.new(data = {})
-    end
-
-    sig { returns(String) }
-    def to_s
-    end
-
-    sig { returns(String) }
-    def inspect
-    end
-  end
-end

data/rbi/lib/terminal-shop/base_page.rbi

@@ -1,38 +0,0 @@
-# typed: strong
-
-module TerminalShop
-  module BasePage
-    Elem = type_member(:out)
-
-    sig { overridable.returns(T::Boolean) }
-    def next_page?
-    end
-
-    sig { overridable.returns(T.self_type) }
-    def next_page
-    end
-
-    sig { overridable.params(blk: T.proc.params(arg0: Elem).void).void }
-    def auto_paging_each(&blk)
-    end
-
-    sig { returns(T::Enumerable[Elem]) }
-    def to_enum
-    end
-
-    alias_method :enum_for, :to_enum
-
-    # @api private
-    sig do
-      params(
-        client: TerminalShop::BaseClient,
-        req: TerminalShop::BaseClient::RequestComponentsShape,
-        headers: T.any(T::Hash[String, String], Net::HTTPHeader),
-        page_data: T.anything
-      )
-        .void
-    end
-    def initialize(client:, req:, headers:, page_data:)
-    end
-  end
-end

data/rbi/lib/terminal-shop/extern.rbi

@@ -1,7 +0,0 @@
-# typed: strong
-
-module TerminalShop
-  # @api private
-  module Extern
-  end
-end

data/rbi/lib/terminal-shop/pooled_net_requester.rbi

@@ -1,48 +0,0 @@
-# typed: strong
-
-module TerminalShop
-  # @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
-
-    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: TerminalShop::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: TerminalShop::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