wreq 1.2.3-x64-mingw-ucrt

data/lib/wreq_ruby/cookie.rb

@@ -0,0 +1,156 @@
+unless defined?(Wreq)
+  module Wreq
+    # Cookie SameSite attribute.
+    #
+    # Values follow the Rust enum exposed by the native extension.
+    class SameSite
+      # Lax same-site policy.
+      Strict = nil
+      # Strict same-site policy.
+      Lax = nil
+      # None same-site policy.
+      None = nil
+    end
+
+    # A single HTTP cookie.
+    #
+    # Thread-safe: instances are backed by an immutable Rust value and can be
+    # shared across threads safely. This mirrors the native `Wreq::Cookie`.
+    # Constructor accepts `name`, `value`, plus optional keyword arguments for
+    # other attributes.
+    class Cookie
+      # Create a new Cookie instance.
+      #
+      # Note: This matches the native binding which defines `new` (not `initialize`).
+      #
+      # @param name [String] Cookie name
+      # @param value [String] Cookie value
+      # @param options [Hash] Optional keyword arguments
+      # @option options [String] :domain Domain attribute
+      # @option options [String] :path Path attribute
+      # @option options [Integer] :max_age Max-Age in seconds
+      # @option options [Float] :expires Unix timestamp (seconds, float)
+      # @option options [Boolean] :http_only HttpOnly flag
+      # @option options [Boolean] :secure Secure flag
+      # @option options [Wreq::SameSite] :same_site SameSite attribute
+      # @return [Wreq::Cookie]
+      # @example
+      #   c = Wreq::Cookie.new(
+      #     "sid", "abc",
+      #     domain: "example.com",
+      #     path: "/",
+      #     max_age: 3600,
+      #     http_only: true,
+      #     secure: true,
+      #     same_site: Wreq::SameSite::Lax
+      #   )
+      def self.new(name, value, **options)
+      end
+
+      # @return [String] Cookie name
+      def name
+      end
+
+      # @return [String] Cookie value
+      def value
+      end
+
+      # Returns true if the HttpOnly directive is enabled.
+      # @return [Boolean]
+      def http_only
+      end
+
+      # Predicate version of http_only.
+      # @return [Boolean]
+      def http_only?
+      end
+
+      # Returns true if the Secure directive is enabled.
+      # @return [Boolean]
+      def secure
+      end
+
+      # Predicate version of secure.
+      # @return [Boolean]
+      def secure?
+      end
+
+      # Returns true if SameSite is Lax.
+      # @return [Boolean]
+      def same_site_lax?
+      end
+
+      # Returns true if SameSite is Strict.
+      # @return [Boolean]
+      def same_site_strict?
+      end
+
+      # @return [String, nil] Path attribute
+      def path
+      end
+
+      # @return [String, nil] Domain attribute
+      def domain
+      end
+
+      # @return [Integer, nil] Max-Age in seconds
+      def max_age
+      end
+
+      # @return [Float, nil] Expires as Unix timestamp (seconds)
+      def expires
+      end
+    end
+
+    # A cookie store (jar) used by the client to manage cookies across requests.
+    class Jar
+      # Create a new, empty cookie jar.
+      # @return [Wreq::Jar]
+      def self.new
+      end
+
+      # Get all cookies currently stored.
+      # @return [Array<Wreq::Cookie>]
+      def get_all
+      end
+
+      # Add a cookie from a Set-Cookie string for the given URL.
+      # @param cookie [String, Wreq::Cookie] A Set-Cookie string
+      # @param url [String]
+      # @return [void]
+      def add(cookie, url)
+      end
+
+      # Remove a cookie by name for the given URL.
+      # @param name [String]
+      # @param url [String]
+      # @return [void]
+      def remove(name, url)
+      end
+
+      # Clear all cookies from the jar.
+      # @return [void]
+      def clear
+      end
+    end
+  end
+end
+
+module Wreq
+  class Cookie
+    def inspect
+      parts = ["#<Wreq::Cookie", name]
+      parts << "domain=#{domain}" if domain
+      parts << "path=#{path}" if path
+      parts << "secure" if secure?
+      parts << "http_only" if http_only?
+      parts.join(" ") + ">"
+    end
+  end
+
+  class Jar
+    def inspect
+      "#<Wreq::Jar [#{get_all.length} cookies]>"
+    end
+  end
+end

data/lib/wreq_ruby/emulate.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module Wreq
+  # Browser and client fingerprint profile enumeration backed by Rust.
+  #
+  # Variants are exposed as constants under this class.
+  # Each constant is an instance of {Wreq::Profile} and can be passed to
+  # {Wreq::Emulation.new} via the `profile:` keyword.
+  #
+  # @example Using a predefined profile
+  #   profile = Wreq::Profile::Chrome117
+  #   profile.class #=> Wreq::Profile
+  #
+  # @example Applying a profile to emulation
+  #   emu = Wreq::Emulation.new(profile: Wreq::Profile::Chrome117)
+  class Profile
+    # Constants are set by the native extension at initialization.
+    # These stubs are for documentation only.
+    unless const_defined?(:Chrome100)
+      Chrome100 = nil
+      Chrome101 = nil
+      Chrome104 = nil
+      Chrome105 = nil
+      Chrome106 = nil
+      Chrome107 = nil
+      Chrome108 = nil
+      Chrome109 = nil
+      Chrome110 = nil
+      Chrome114 = nil
+      Chrome116 = nil
+      Chrome117 = nil
+      Chrome118 = nil
+      Chrome119 = nil
+      Chrome120 = nil
+      Chrome123 = nil
+      Chrome124 = nil
+      Chrome126 = nil
+      Chrome127 = nil
+      Chrome128 = nil
+      Chrome129 = nil
+      Chrome130 = nil
+      Chrome131 = nil
+      Chrome132 = nil
+      Chrome133 = nil
+      Chrome134 = nil
+      Chrome135 = nil
+      Chrome136 = nil
+      Chrome137 = nil
+      Chrome138 = nil
+      Chrome139 = nil
+      Chrome140 = nil
+      Chrome141 = nil
+      Chrome142 = nil
+      Chrome143 = nil
+      Chrome144 = nil
+      Chrome145 = nil
+      Chrome146 = nil
+      Chrome147 = nil
+      Chrome148 = nil
+      Chrome149 = nil
+
+      Edge101 = nil
+      Edge122 = nil
+      Edge127 = nil
+      Edge131 = nil
+      Edge134 = nil
+      Edge135 = nil
+      Edge136 = nil
+      Edge137 = nil
+      Edge138 = nil
+      Edge139 = nil
+      Edge140 = nil
+      Edge141 = nil
+      Edge142 = nil
+      Edge143 = nil
+      Edge144 = nil
+      Edge145 = nil
+      Edge146 = nil
+      Edge147 = nil
+      Edge148 = nil
+
+      Firefox109 = nil
+      Firefox117 = nil
+      Firefox128 = nil
+      Firefox133 = nil
+      Firefox135 = nil
+      FirefoxPrivate135 = nil
+      FirefoxAndroid135 = nil
+      Firefox136 = nil
+      FirefoxPrivate136 = nil
+      Firefox139 = nil
+      Firefox142 = nil
+      Firefox143 = nil
+      Firefox144 = nil
+      Firefox145 = nil
+      Firefox146 = nil
+      Firefox147 = nil
+      Firefox148 = nil
+      Firefox149 = nil
+      Firefox150 = nil
+      Firefox151 = nil
+
+      SafariIos17_2 = nil
+      SafariIos17_4_1 = nil
+      SafariIos16_5 = nil
+      Safari15_3 = nil
+      Safari15_5 = nil
+      Safari15_6_1 = nil
+      Safari16 = nil
+      Safari16_5 = nil
+      Safari17_0 = nil
+      Safari17_2_1 = nil
+      Safari17_4_1 = nil
+      Safari17_5 = nil
+      Safari17_6 = nil
+      Safari18 = nil
+      SafariIPad18 = nil
+      Safari18_2 = nil
+      Safari18_3 = nil
+      Safari18_3_1 = nil
+      SafariIos18_1_1 = nil
+      Safari18_5 = nil
+      Safari26 = nil
+      Safari26_1 = nil
+      Safari26_2 = nil
+      Safari26_3 = nil
+      Safari26_4 = nil
+      SafariIos26 = nil
+      SafariIos26_2 = nil
+      SafariIPad26 = nil
+      SafariIpad26_2 = nil
+
+      OkHttp3_9 = nil
+      OkHttp3_11 = nil
+      OkHttp3_13 = nil
+      OkHttp3_14 = nil
+      OkHttp4_9 = nil
+      OkHttp4_10 = nil
+      OkHttp4_12 = nil
+      OkHttp5 = nil
+
+      Opera116 = nil
+      Opera117 = nil
+      Opera118 = nil
+      Opera119 = nil
+      Opera120 = nil
+      Opera121 = nil
+      Opera122 = nil
+      Opera123 = nil
+      Opera124 = nil
+      Opera125 = nil
+      Opera126 = nil
+      Opera127 = nil
+      Opera128 = nil
+      Opera129 = nil
+      Opera130 = nil
+      Opera131 = nils
+    end
+
+    unless method_defined?(:to_s)
+      # Returns the profile name.
+      # @return [String] Profile name as a string
+      def to_s
+      end
+    end
+  end
+
+  # Operating system platform enumeration backed by Rust.
+  #
+  # Variants are exposed as constants under this class.
+  # Each constant is an instance of {Wreq::Platform} and can be passed to
+  # {Wreq::Emulation.new} via the `platform:` keyword.
+  #
+  # @example Using a predefined platform
+  #   platform = Wreq::Platform::Windows
+  #   platform.class #=> Wreq::Platform
+  #
+  # @example Applying a platform to emulation
+  #   emu = Wreq::Emulation.new(platform: Wreq::Platform::Windows)
+  class Platform
+    # Constants are set by the native extension at initialization.
+    # These stubs are for documentation only.
+    unless const_defined?(:Windows)
+      Windows = nil
+      MacOS = nil
+      Linux = nil
+      Android = nil
+      IOS = nil
+    end
+
+    unless method_defined?(:to_s)
+      # Returns the platform name.
+      # @return [String] Platform name as a string
+      def to_s
+      end
+    end
+  end
+
+  # Emulation option wrapper.
+  #
+  # This class combines a fingerprint `profile`, an OS `platform`, and toggles
+  # for HTTP/2 and automatic default headers. The actual implementation is
+  # provided by Rust.
+  #
+  # `profile:` defaults to the library's default profile when omitted.
+  # `platform:` defaults to the library's default platform when omitted.
+  #
+  # @example Create an emulation option
+  #   emu = Wreq::Emulation.new(
+  #     profile: Wreq::Profile::Chrome117,
+  #     platform: Wreq::Platform::Windows,
+  #     http2: true,
+  #     headers: true
+  #   )
+  #
+  # @param profile [Wreq::Profile, nil] Fingerprint profile to emulate
+  # @param platform [Wreq::Platform, nil] Operating system platform to emulate
+  # @param http2 [Boolean] Whether HTTP/2 support is enabled
+  # @param headers [Boolean] Whether default emulation headers are enabled
+  class Emulation
+    # Native fields and methods are set by the extension.
+    # This stub is for documentation only.
+    unless method_defined?(:new)
+      # @param profile [Wreq::Profile, nil] Fingerprint profile to emulate
+      # @param platform [Wreq::Platform, nil] Operating system platform to emulate
+      # @param http2 [Boolean] Whether HTTP/2 support is enabled
+      # @param headers [Boolean] Whether default emulation headers are enabled
+      def self.new(profile: nil, platform: nil, http2: true, headers: true)
+      end
+    end
+  end
+end

data/lib/wreq_ruby/error.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+unless defined?(Wreq)
+  module Wreq
+    # System-level and runtime errors
+
+    # Memory allocation failed.
+    class MemoryError < StandardError; end
+
+    # Network connection errors
+
+    # Connection to the server failed.
+    #
+    # Raised when the client cannot establish a connection to the server.
+    #
+    # @example
+    #   begin
+    #     client.get("http://localhost:9999")
+    #   rescue Wreq::ConnectionError => e
+    #     puts "Connection failed: #{e.message}"
+    #     retry_with_backoff
+    #   end
+    class ConnectionError < StandardError; end
+
+    # Proxy Connection to the server failed.
+    #
+    # Raised when the client cannot establish a connection to the proxy server.
+    # @example
+    #   begin
+    #     client.get("http://example.com", proxy: "http://invalid-proxy:8080")
+    #   rescue Wreq::ProxyConnectionError => e
+    #     puts "Proxy connection failed: #{e.message}"
+    #     retry_with_different_proxy
+    #   end
+    class ProxyConnectionError < StandardError; end
+
+    # Connection was reset by the server.
+    #
+    # Raised when the server closes the connection unexpectedly.
+    #
+    # @example
+    #   rescue Wreq::ConnectionResetError => e
+    #     puts "Connection reset: #{e.message}"
+    #   end
+    class ConnectionResetError < StandardError; end
+
+    # TLS/SSL error occurred.
+    #
+    # Raised when there's an error with TLS/SSL, such as certificate
+    # verification failure or protocol mismatch.
+    #
+    # @example
+    #   begin
+    #     client.get("https://self-signed.badssl.com")
+    #   rescue Wreq::TlsError => e
+    #     puts "TLS error: #{e.message}"
+    #   end
+    class TlsError < StandardError; end
+
+    # HTTP protocol and request/response errors
+
+    # Request failed.
+    #
+    # Generic error for request failures that don't fit other categories.
+    #
+    # @example
+    #   rescue Wreq::RequestError => e
+    #     puts "Request failed: #{e.message}"
+    #   end
+    class RequestError < StandardError; end
+
+    # HTTP status code indicates an error.
+    #
+    # Raised when the server returns an error status code (4xx or 5xx).
+    #
+    # @example
+    #   begin
+    #     response = client.get("https://httpbin.io/status/404")
+    #   rescue Wreq::StatusError => e
+    #     puts "HTTP error: #{e.message}"
+    #     # e.response contains the full response
+    #   end
+    class StatusError < StandardError; end
+
+    # Redirect handling failed.
+    #
+    # Raised when too many redirects occur or redirect logic fails.
+    #
+    # @example
+    #   begin
+    #     client = Wreq::Client.new(max_redirects: 3)
+    #     client.get("https://httpbin.io/redirect/10")
+    #   rescue Wreq::RedirectError => e
+    #     puts "Too many redirects: #{e.message}"
+    #   end
+    class RedirectError < StandardError; end
+
+    # Request timed out.
+    #
+    # Raised when the request exceeds the configured timeout.
+    #
+    # @example
+    #   begin
+    #     client = Wreq::Client.new(timeout: 5)
+    #     client.get("https://httpbin.io/delay/10")
+    #   rescue Wreq::TimeoutError => e
+    #     puts "Request timed out: #{e.message}"
+    #     retry_with_longer_timeout
+    #   end
+    class TimeoutError < StandardError; end
+
+    # Data processing and encoding errors
+
+    # Response body processing failed.
+    #
+    # Raised when there's an error reading or processing the response body.
+    #
+    # @example
+    #   rescue Wreq::BodyError => e
+    #     puts "Body error: #{e.message}"
+    #   end
+    class BodyError < StandardError; end
+
+    # Decoding response failed.
+    #
+    # Raised when response content cannot be decoded (e.g., invalid UTF-8,
+    # malformed JSON, corrupted compression).
+    #
+    # @example
+    #   begin
+    #     response = client.get("https://example.com/invalid-utf8")
+    #     response.text  # May raise DecodingError
+    #   rescue Wreq::DecodingError => e
+    #     puts "Decoding error: #{e.message}"
+    #     # Fall back to binary data
+    #     data = response.body
+    #   end
+    class DecodingError < StandardError; end
+
+    # Configuration and builder errors
+
+    # Client configuration is invalid.
+    #
+    # Raised when the client is configured with invalid options.
+    #
+    # @example
+    #   begin
+    #     client = Wreq::Client.new(
+    #       proxy: "invalid://proxy",
+    #       timeout: -1
+    #     )
+    #   rescue Wreq::BuilderError => e
+    #     puts "Invalid configuration: #{e.message}"
+    #   end
+    class BuilderError < StandardError; end
+  end
+end