anthropic 0.1.0.pre.beta.9 → 0.1.0

data/lib/anthropic/internal/type/converter.rb

@@ -1,292 +0,0 @@
-# frozen_string_literal: true
-
-module Anthropic
-  module Internal
-    module Type
-      # @api private
-      module Converter
-        extend Anthropic::Internal::Util::SorbetRuntimeSupport
-
-        # rubocop:disable Lint/UnusedMethodArgument
-
-        # @api private
-        #
-        # @param value [Object]
-        #
-        # @param state [Hash{Symbol=>Object}] .
-        #
-        #   @option state [Boolean, :strong] :strictness
-        #
-        #   @option state [Hash{Symbol=>Object}] :exactness
-        #
-        #   @option state [Integer] :branched
-        #
-        # @return [Object]
-        def coerce(value, state:) = (raise NotImplementedError)
-
-        # @api private
-        #
-        # @param value [Object]
-        #
-        # @param state [Hash{Symbol=>Object}] .
-        #
-        #   @option state [Boolean] :can_retry
-        #
-        # @return [Object]
-        def dump(value, state:)
-          case value
-          in Array
-            value.map { Anthropic::Internal::Type::Unknown.dump(_1, state: state) }
-          in Hash
-            value.transform_values { Anthropic::Internal::Type::Unknown.dump(_1, state: state) }
-          in Anthropic::Internal::Type::BaseModel
-            value.class.dump(value, state: state)
-          in StringIO
-            value.string
-          in Pathname | IO
-            state[:can_retry] = false if value.is_a?(IO)
-            Anthropic::FilePart.new(value)
-          in Anthropic::FilePart
-            state[:can_retry] = false if value.content.is_a?(IO)
-            value
-          else
-            value
-          end
-        end
-
-        # @api private
-        #
-        # @param depth [Integer]
-        #
-        # @return [String]
-        def inspect(depth: 0)
-          super()
-        end
-
-        # rubocop:enable Lint/UnusedMethodArgument
-
-        class << self
-          # @api private
-          #
-          # @param spec [Hash{Symbol=>Object}, Proc, Anthropic::Internal::Type::Converter, Class] .
-          #
-          #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
-          #
-          #   @option spec [Proc] :enum
-          #
-          #   @option spec [Proc] :union
-          #
-          #   @option spec [Boolean] :"nil?"
-          #
-          # @return [Proc]
-          def type_info(spec)
-            case spec
-            in Proc
-              spec
-            in Hash
-              type_info(spec.slice(:const, :enum, :union).first&.last)
-            in true | false
-              -> { Anthropic::Internal::Type::Boolean }
-            in Anthropic::Internal::Type::Converter | Class | Symbol
-              -> { spec }
-            in NilClass | Integer | Float
-              -> { spec.class }
-            end
-          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
-          #
-          # The coercion process is subject to improvement between minor release versions.
-          # See https://docs.pydantic.dev/latest/concepts/unions/#smart-mode
-          #
-          # @param target [Anthropic::Internal::Type::Converter, Class]
-          #
-          # @param value [Object]
-          #
-          # @param state [Hash{Symbol=>Object}] The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-          # coercion strategy when we have to decide between multiple possible conversion
-          # targets:
-          #
-          # - `true`: the conversion must be exact, with minimum coercion.
-          # - `false`: the conversion can be approximate, with some coercion.
-          # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-          #   if not possible.
-          #
-          # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
-          # any given conversion attempt, the exactness will be updated based on how closely
-          # the value recursively matches the target type:
-          #
-          # - `yes`: the value can be converted to the target type with minimum coercion.
-          # - `maybe`: the value can be converted to the target type with some reasonable
-          #   coercion.
-          # - `no`: the value cannot be converted to the target type.
-          #
-          # See implementation below for more details.
-          #
-          #   @option state [Boolean, :strong] :strictness
-          #
-          #   @option state [Hash{Symbol=>Object}] :exactness
-          #
-          #   @option state [Integer] :branched
-          #
-          # @return [Object]
-          def coerce(
-            target,
-            value,
-            state: {strictness: true, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
-          )
-            # rubocop:disable Lint/SuppressedException
-            # rubocop:disable Metrics/BlockNesting
-            strictness, exactness = state.fetch_values(:strictness, :exactness)
-
-            case target
-            in Anthropic::Internal::Type::Converter
-              return target.coerce(value, state: state)
-            in Class
-              if value.is_a?(target)
-                exactness[:yes] += 1
-                return value
-              end
-
-              case target
-              in -> { _1 <= NilClass }
-                exactness[value.nil? ? :yes : :maybe] += 1
-                return nil
-              in -> { _1 <= Integer }
-                if value.is_a?(Integer)
-                  exactness[:yes] += 1
-                  return value
-                elsif strictness == :strong && Integer(value, exception: false) != value
-                  message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                  raise value.is_a?(Numeric) ? ArgumentError.new(message) : TypeError.new(message)
-                else
-                  Kernel.then do
-                    return Integer(value).tap { exactness[:maybe] += 1 }
-                  rescue ArgumentError, TypeError
-                  end
-                end
-              in -> { _1 <= Float }
-                if value.is_a?(Numeric)
-                  exactness[:yes] += 1
-                  return Float(value)
-                elsif strictness == :strong
-                  message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                  raise TypeError.new(message)
-                else
-                  Kernel.then do
-                    return Float(value).tap { exactness[:maybe] += 1 }
-                  rescue ArgumentError, TypeError
-                  end
-                end
-              in -> { _1 <= String }
-                case value
-                in String | Symbol | Numeric
-                  exactness[value.is_a?(Numeric) ? :maybe : :yes] += 1
-                  return value.to_s
-                in StringIO
-                  exactness[:yes] += 1
-                  return value.string
-                else
-                  if strictness == :strong
-                    message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                    raise TypeError.new(message)
-                  end
-                end
-              in -> { _1 <= Date || _1 <= Time }
-                Kernel.then do
-                  return target.parse(value).tap { exactness[:yes] += 1 }
-                rescue ArgumentError, TypeError => e
-                  raise e if strictness == :strong
-                end
-              in -> { _1 <= StringIO } if value.is_a?(String)
-                exactness[:yes] += 1
-                return StringIO.new(value.b)
-              else
-              end
-            in Symbol
-              case value
-              in Symbol | String
-                if value.to_sym == target
-                  exactness[:yes] += 1
-                  return target
-                else
-                  exactness[:maybe] += 1
-                  return value
-                end
-              else
-                if strictness == :strong
-                  message = "cannot convert non-matching #{value.class} into #{target.inspect}"
-                  raise ArgumentError.new(message)
-                end
-              end
-            else
-            end
-
-            exactness[:no] += 1
-            value
-            # rubocop:enable Metrics/BlockNesting
-            # rubocop:enable Lint/SuppressedException
-          end
-
-          # @api private
-          #
-          # @param target [Anthropic::Internal::Type::Converter, Class]
-          #
-          # @param value [Object]
-          #
-          # @param state [Hash{Symbol=>Object}] .
-          #
-          #   @option state [Boolean] :can_retry
-          #
-          # @return [Object]
-          def dump(target, value, state: {can_retry: true})
-            case target
-            in Anthropic::Internal::Type::Converter
-              target.dump(value, state: state)
-            else
-              Anthropic::Internal::Type::Unknown.dump(value, state: state)
-            end
-          end
-
-          # @api private
-          #
-          # @param target [Object]
-          # @param depth [Integer]
-          #
-          # @return [String]
-          def inspect(target, depth:)
-            case target
-            in Anthropic::Internal::Type::Converter
-              target.inspect(depth: depth.succ)
-            else
-              target.inspect
-            end
-          end
-        end
-
-        define_sorbet_constant!(:Input) do
-          T.type_alias { T.any(Anthropic::Internal::Type::Converter, T::Class[T.anything]) }
-        end
-        define_sorbet_constant!(:CoerceState) do
-          T.type_alias do
-            {
-              strictness: T.any(T::Boolean, Symbol),
-              exactness: {yes: Integer, no: Integer, maybe: Integer},
-              branched: Integer
-            }
-          end
-        end
-        define_sorbet_constant!(:DumpState) do
-          T.type_alias { {can_retry: T::Boolean} }
-        end
-      end
-    end
-  end
-end

data/lib/anthropic/internal/type/enum.rb

@@ -1,145 +0,0 @@
-# frozen_string_literal: true
-
-module Anthropic
-  module Internal
-    module Type
-      # @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.
-      #
-      # @example
-      #   # `stop_reason` is a `Anthropic::StopReason`
-      #   case stop_reason
-      #   when Anthropic::StopReason::END_TURN
-      #     # ...
-      #   when Anthropic::StopReason::MAX_TOKENS
-      #     # ...
-      #   when Anthropic::StopReason::STOP_SEQUENCE
-      #     # ...
-      #   else
-      #     puts(stop_reason)
-      #   end
-      #
-      # @example
-      #   case stop_reason
-      #   in :end_turn
-      #     # ...
-      #   in :max_tokens
-      #     # ...
-      #   in :stop_sequence
-      #     # ...
-      #   else
-      #     puts(stop_reason)
-      #   end
-      module Enum
-        include Anthropic::Internal::Type::Converter
-        include Anthropic::Internal::Util::SorbetRuntimeSupport
-
-        # All of the valid Symbol values for this enum.
-        #
-        # @return [Array<NilClass, Boolean, Integer, Float, Symbol>]
-        def values = constants.map { const_get(_1) }
-
-        # @api public
-        #
-        # @param other [Object]
-        #
-        # @return [Boolean]
-        def ===(other) = values.include?(other)
-
-        # @api public
-        #
-        # @param other [Object]
-        #
-        # @return [Boolean]
-        def ==(other)
-          # rubocop:disable Style/CaseEquality
-          Anthropic::Internal::Type::Enum === other && other.values.to_set == values.to_set
-          # rubocop:enable Style/CaseEquality
-        end
-
-        # @api public
-        #
-        # @return [Integer]
-        def hash = values.to_set.hash
-
-        # @api private
-        #
-        # Unlike with primitives, `Enum` additionally validates that the value is a member
-        # of the enum.
-        #
-        # @param value [String, Symbol, Object]
-        #
-        # @param state [Hash{Symbol=>Object}] .
-        #
-        #   @option state [Boolean, :strong] :strictness
-        #
-        #   @option state [Hash{Symbol=>Object}] :exactness
-        #
-        #   @option state [Integer] :branched
-        #
-        # @return [Symbol, Object]
-        def coerce(value, state:)
-          exactness = state.fetch(:exactness)
-          val = value.is_a?(String) ? value.to_sym : value
-
-          if values.include?(val)
-            exactness[:yes] += 1
-            val
-          else
-            exactness[values.first&.class == val.class ? :maybe : :no] += 1
-            value
-          end
-        end
-
-        # @!method dump(value, state:)
-        #   @api private
-        #
-        #   @param value [Symbol, Object]
-        #
-        #   @param state [Hash{Symbol=>Object}] .
-        #
-        #     @option state [Boolean] :can_retry
-        #
-        #   @return [Symbol, Object]
-
-        # @api private
-        #
-        # @return [Object]
-        def to_sorbet_type
-          case values
-          in []
-            T.noreturn
-          in [value, *_]
-            T.all(Anthropic::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(value), self)
-          end
-        end
-
-        # @api private
-        #
-        # @param depth [Integer]
-        #
-        # @return [String]
-        def inspect(depth: 0)
-          if depth.positive?
-            return is_a?(Module) ? super() : self.class.name
-          end
-
-          members = values.map { Anthropic::Internal::Type::Converter.inspect(_1, depth: depth.succ) }
-          prefix = is_a?(Module) ? name : self.class.name
-
-          "#{prefix}[#{members.join(' | ')}]"
-        end
-      end
-    end
-  end
-end

data/lib/anthropic/internal/type/file_input.rb

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-module Anthropic
-  module Internal
-    module Type
-      # @api private
-      #
-      # @abstract
-      #
-      # Either `Pathname` or `StringIO`, or `IO`, or
-      # `Anthropic::Internal::Type::FileInput`.
-      #
-      # Note: when `IO` is used, all retries are disabled, since many IO` streams are
-      # not rewindable.
-      class FileInput
-        extend Anthropic::Internal::Type::Converter
-
-        private_class_method :new
-
-        # @api public
-        #
-        # @param other [Object]
-        #
-        # @return [Boolean]
-        def self.===(other)
-          case other
-          in Pathname | StringIO | IO | String | Anthropic::FilePart
-            true
-          else
-            false
-          end
-        end
-
-        # @api public
-        #
-        # @param other [Object]
-        #
-        # @return [Boolean]
-        def self.==(other) = other.is_a?(Class) && other <= Anthropic::Internal::Type::FileInput
-
-        class << self
-          # @api private
-          #
-          # @param value [StringIO, String, Object]
-          #
-          # @param state [Hash{Symbol=>Object}] .
-          #
-          #   @option state [Boolean, :strong] :strictness
-          #
-          #   @option state [Hash{Symbol=>Object}] :exactness
-          #
-          #   @option state [Integer] :branched
-          #
-          # @return [StringIO, Object]
-          def coerce(value, state:)
-            exactness = state.fetch(:exactness)
-            case value
-            in String
-              exactness[:yes] += 1
-              StringIO.new(value)
-            in StringIO
-              exactness[:yes] += 1
-              value
-            else
-              exactness[:no] += 1
-              value
-            end
-          end
-
-          # @api private
-          #
-          # @param value [Pathname, StringIO, IO, String, Object]
-          #
-          # @param state [Hash{Symbol=>Object}] .
-          #
-          #   @option state [Boolean] :can_retry
-          #
-          # @return [Pathname, StringIO, IO, String, Object]
-          def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
-            case value
-            in IO
-              state[:can_retry] = false
-            in Anthropic::FilePart if value.content.is_a?(IO)
-              state[:can_retry] = false
-            else
-            end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
-          end
-
-          # @api private
-          #
-          # @return [Object]
-          def to_sorbet_type
-            T.any(Pathname, StringIO, IO, String, Anthropic::FilePart)
-          end
-        end
-      end
-    end
-  end
-end