openai 0.75.0 → 0.76.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f37ed6a1d2d71172c0518b0084e33f43eccb810d556234a8a94a6b2436fe481
-  data.tar.gz: 4e5d4364cf54131f78c0d7ed39b699a55b4b87a9354a5ea46336157afdf097ff
+  metadata.gz: cab767061478241e5accb3482ec747785aff81c5b375a726d9e90d7d28401e88
+  data.tar.gz: 8d127b01f66be6a38f85530c93d7c33f8abf4f3b61d5750080f7f1308dbfa46b
 SHA512:
-  metadata.gz: 38784a4f8a73c2d4c0d1126e6f88d47649879f18835c24a6c2411efcca52cbc84211cfbb19e45524aca10c3c9951f1b7ee8fa736d16811325577e791e85ed3ef
-  data.tar.gz: a391891d80016f08701d8906cf3800adf32ca3966af91eec7636fe59884edaf46532056a40cfffb66a56f6138c264efd2f7e15d5b6cf2b0f64ace1ead0d56dc7
+  metadata.gz: e0a6982a093b6263fd2484b2ee50c9b3d712a0548015cda1b6401157fddef8ae802a9fc6a4b2fbfdea8e2e37ad6f8173500f9b97884008690fc2a8ced51cddbd
+  data.tar.gz: 9688ca923096844c3c6cd4205d448f7c06474214562cf28af350471e1ed8a726694960dd8733de94a9249bd86d0da4b06c3f52cdbe3ac5fcc1bdae6dd77890c2

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.76.0 (2026-07-31)
+
+Full Changelog: [v0.75.0...v0.76.0](https://github.com/openai/openai-ruby/compare/v0.75.0...v0.76.0)
+
+### Features
+
+* require Ruby 3.3 or newer ([#322](https://github.com/openai/openai-ruby/issues/322)) ([f40aef1](https://github.com/openai/openai-ruby/commit/f40aef1892a4ebafaf4c254522dbf12f3c04ba78))
+
+
+### Bug Fixes
+
+* preserve generic Linux ffi lock entry ([#323](https://github.com/openai/openai-ruby/issues/323)) ([491eacb](https://github.com/openai/openai-ruby/commit/491eacbe59aa77586731a7929f487a4dcd6f7113))
+
 ## 0.75.0 (2026-07-31)
 
 Full Changelog: [v0.74.0...v0.75.0](https://github.com/openai/openai-ruby/compare/v0.74.0...v0.75.0)

data/README.md

@@ -1,6 +1,6 @@
 # OpenAI Ruby API library
 
-The OpenAI Ruby library provides convenient access to the OpenAI REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/openai/openai-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+The OpenAI Ruby library provides convenient access to the OpenAI REST API from any Ruby 3.3.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/openai/openai-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 ## Documentation
 
@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.75.0"
+gem "openai", "~> 0.76.0"
 ```
 
 <!-- x-release-please-end -->
@@ -80,7 +80,7 @@ end
 
 ### File uploads
 
-Request parameters that correspond to file uploads can be passed as raw contents, a [`Pathname`](https://rubyapi.org/3.2/o/pathname) instance, [`StringIO`](https://rubyapi.org/3.2/o/stringio), or more.
+Request parameters that correspond to file uploads can be passed as raw contents, a [`Pathname`](https://rubyapi.org/3.3/o/pathname) instance, [`StringIO`](https://rubyapi.org/3.3/o/stringio), or more.
 
 ```ruby
 require "pathname"
@@ -633,13 +633,14 @@ openai.chat.completions.create(
 
 ## Versioning
 
-This package follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions. As the library is in initial development and has a major version of `0`, APIs may change at any time.
-
-This package considers improvements to the (non-runtime) `*.rbi` and `*.rbs` type definitions to be non-breaking changes.
+This package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html). See the [versioning policy](VERSIONING.md) for how releases, breaking changes, Ruby support, dependencies, and type definitions are managed.
 
 ## Requirements
 
-Ruby 3.2.0 or higher.
+Ruby 3.3.0 or higher.
+
+Ruby 3.2 users can continue using v0.75.x, the final compatible release line.
+This line will not receive separate maintenance.
 
 ## Contributing
 

data/VERSIONING.md

@@ -0,0 +1,77 @@
+# Versioning policy
+
+The OpenAI Ruby SDK follows [Semantic Versioning](https://semver.org/). This
+policy covers the public gem API, supported Ruby runtimes, dependencies, and
+type definitions.
+
+## Gem releases
+
+| Change | While the gem is `0.x` | After `1.0` |
+| --- | --- | --- |
+| Backwards-compatible bug or security fix | Patch | Patch |
+| Additive endpoint, optional argument, response field, or public type | Minor | Minor |
+| Higher minimum Ruby version | Minor | Major by default |
+| Other user-visible breaking change | Minor, with migration guidance | Major |
+
+Breaking changes include removing or renaming public behavior and incompatible
+changes to required arguments, return types, exception families,
+serialization, retries, or authentication. A dependency upgrade follows the
+same rule: its version number does not determine the SDK release; its effect on
+SDK users does.
+
+Corrections to non-runtime RBI or RBS definitions are normally patches. Use a
+minor release when a type-only change is likely to create substantial new type
+errors for users.
+
+Security may require an accelerated breaking release, but an incompatible
+change is never shipped as a routine patch.
+
+## Ruby support
+
+The SDK supports released CRuby versions that are in Ruby Core's normal or
+security maintenance phases. An EOL Ruby may receive up to six months of grace
+only through an explicit SDK and Security exception. See [Ruby maintenance
+branches](https://www.ruby-lang.org/en/downloads/branches/) for the upstream
+lifecycle.
+
+The current supported versions are Ruby 3.3, 3.4, and 4.0. The authoritative
+minimum is `required_ruby_version` in `openai.gemspec`.
+
+When the minimum Ruby version changes:
+
+1. Ship the change in the release category defined above, never in a patch.
+2. Name the final compatible gem release line in the README and release notes.
+3. Keep old releases available, without promising fixes or backports.
+4. Test every supported Ruby minor and verify the built gem rejects the old
+   runtime while installing on the new minimum.
+
+CRuby is the supported implementation and its CI jobs are blocking. JRuby and
+TruffleRuby are best effort until each has an explicitly owned compatibility
+matrix and support decision.
+
+## Dependencies
+
+- Keep the runtime dependency graph small and framework-neutral.
+- Declare standard-library components that are distributed as independent gems.
+- Prefer minimum or open-ended requirements. Add upper bounds only for known
+  incompatibilities.
+- Test the minimum and latest resolvable dependency sets when practical.
+- Keep framework and transport integrations optional or in separate gems when
+  adding them to the core gem would expand its compatibility surface.
+
+## Maintaining the policy
+
+The Ruby version settings serve different purposes:
+
+- `openai.gemspec` declares the customer support floor.
+- `.rubocop.yml` targets the syntax of the oldest supported Ruby minor.
+- The CI matrix tests every supported Ruby minor.
+- `.ruby-version` pins the latest patch of the newest supported Ruby for local
+  development; it is not the customer support floor.
+- Routine lint, package, and release jobs use the newest supported Ruby minor.
+
+After each annual Ruby release, add the new minor to CI and move routine
+development jobs to it once the suite is green. Around each March/April Ruby
+EOL window, explicitly decide whether to raise the customer floor. A floor
+increase must update the gemspec, README, RuboCop target, CI matrix, and release
+notes together; automation must not make that decision by itself.

data/lib/openai/internal/type/base_stream.rb

@@ -9,7 +9,7 @@ module OpenAI
       #
       # This module provides a base implementation for streaming responses in the SDK.
       #
-      # @see https://rubyapi.org/3.2/o/enumerable
+      # @see https://rubyapi.org/3.3/o/enumerable
       module BaseStream
         include Enumerable
 

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.75.0"
+  VERSION = "0.76.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.75.0
+  version: 0.76.0
 platform: ruby
 authors:
 - OpenAI
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-31 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -52,17 +51,18 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
 email: support@openai.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
+- VERSIONING.md
 files:
 - ".ignore"
 - CHANGELOG.md
 - README.md
 - SECURITY.md
+- VERSIONING.md
 - lib/openai.rb
 - lib/openai/auth/subject_token_provider.rb
 - lib/openai/auth/subject_token_providers/azure_managed_identity_token_provider.rb
@@ -3734,7 +3734,6 @@ metadata:
   homepage_uri: https://gemdocs.org/gems/openai
   source_code_uri: https://github.com/openai/openai-ruby
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -3742,15 +3741,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Ruby library to access the OpenAI API
 test_files: []