gpt 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 63a792b425c4cbce7e97eea48da74efc7d1fab57bb88f8623c683b19d567a55c
+  data.tar.gz: d359d30ae5e9d184330a7922d39416ab80de88a03871a5f6009d2e9d9c65b562
+SHA512:
+  metadata.gz: 87a5832356464d22b9e0b10a346e8e441593ca6a54ba81a76f135b48cb94fe01951fe89954bcff891eba3d2bfae5a0755c99a974900b90fb4615dfe0459ae410
+  data.tar.gz: 4ad05661b2149c090d5e2546d3952b9410cd9d6c0332cca32cfed5499b21972a0953a153768ebff59ddc66458b1122cadf2312ce45fff6a292c0d7b5a43a6da6

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.0.1
+- Primeira versão com cliente para API Responses (create/get/delete/cancel/input_items) e streaming SSE.
+
+

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gedean Dias
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# gpt
+
+Cliente Ruby simples para a API Responses.
+
+Instalação
+```
+gem build gpt.gemspec && gem install ./gpt-0.0.1.gem
+```
+
+Uso básico
+```ruby
+require 'gpt'
+
+client = GPT.client
+
+res = client.responses.create({
+  'model' => 'gpt-4.1',
+  'input' => 'Diga olá em uma frase.'
+})
+
+puts res['id']
+```
+
+Streaming SSE
+```ruby
+require 'gpt'
+
+GPT.responses.stream({
+  'model' => 'gpt-4.1',
+  'input' => 'Conte uma história curta.'
+}) do |chunk|
+  print chunk
+end
+```
+
+Outras operações
+```ruby
+id = res['id']
+GPT.responses.get(id)
+GPT.responses.input_items(id)
+GPT.responses.cancel(id)
+GPT.responses.delete(id)
+```

data/lib/gpt/client.rb

@@ -0,0 +1,121 @@
+module GPT
+  class Client
+    DEFAULT_BASE_URL = 'https://api.openai.com'.freeze
+    DEFAULT_TIMEOUT = 120
+
+    attr_reader :api_key, :base_url, :timeout, :organization, :project
+
+    def initialize(api_key: ENV['OPENAI_API_KEY'], base_url: nil, timeout: nil, organization: ENV['OPENAI_ORG_ID'], project: ENV['OPENAI_PROJECT_ID'])
+      @api_key = api_key
+      @base_url = base_url || DEFAULT_BASE_URL
+      @timeout = (timeout || DEFAULT_TIMEOUT).to_i
+      @organization = organization
+      @project = project
+    end
+
+    def json_get(path, query: nil)
+      request(:get, path, query: query)
+    end
+
+    def json_post(path, body: nil)
+      request(:post, path, body: body)
+    end
+
+    def json_delete(path)
+      request(:delete, path)
+    end
+
+    def sse_stream(path, body: nil, query: nil)
+      uri = build_uri(path, query: query)
+      http = build_http(uri)
+      req = Net::HTTP::Post.new(uri)
+      apply_headers(req)
+      req['Accept'] = 'text/event-stream'
+      req.content_type = 'application/json'
+      req.body = body ? Oj.dump(body) : nil
+
+      http.request(req) do |res|
+        raise_http_error(res) unless res.is_a?(Net::HTTPSuccess)
+        res.read_body do |chunk|
+          yield chunk if block_given?
+        end
+      end
+      true
+    end
+
+    private
+
+    def request(method, path, body: nil, query: nil)
+      uri = build_uri(path, query: query)
+      http = build_http(uri)
+      req = build_request(method, uri)
+      apply_headers(req)
+      if body
+        req.content_type = 'application/json'
+        req.body = Oj.dump(body)
+      end
+      res = http.request(req)
+      parse_response(res)
+    end
+
+    def build_uri(path, query: nil)
+      uri = URI.join(base_url, path)
+      if query && query.any?
+        uri.query = URI.encode_www_form(query)
+      end
+      uri
+    end
+
+    def build_http(uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.read_timeout = timeout
+      http.open_timeout = timeout
+      http.write_timeout = timeout
+      http
+    end
+
+    def build_request(method, uri)
+      case method
+      when :get then Net::HTTP::Get.new(uri)
+      when :post then Net::HTTP::Post.new(uri)
+      when :delete then Net::HTTP::Delete.new(uri)
+      else
+        raise ArgumentError, 'unsupported method'
+      end
+    end
+
+    def apply_headers(req)
+      req['Authorization'] = "Bearer #{api_key}"
+      req['OpenAI-Organization'] = organization if organization && !organization.empty?
+      req['OpenAI-Project'] = project if project && !project.empty?
+      req['User-Agent'] = 'gpt-ruby/0.0.1'
+    end
+
+    def parse_response(res)
+      body = res.body
+      if res['Content-Type']&.include?('application/json')
+        parsed = body && !body.empty? ? Oj.load(body) : nil
+      else
+        parsed = body
+      end
+
+      unless res.is_a?(Net::HTTPSuccess)
+        message = if parsed.is_a?(Hash) && parsed['error']
+          parsed['error']['message'] || parsed['error'].to_s
+        else
+          body.to_s
+        end
+        raise GPT::Error.new(message, status: res.code.to_i, headers: res.each_header.to_h, response: parsed)
+      end
+
+      parsed
+    end
+
+    def raise_http_error(res)
+      raise GPT::Error.new("HTTP #{res.code}", status: res.code.to_i, headers: res.each_header.to_h, response: res.body)
+    end
+  end
+end
+
+

data/lib/gpt/error.rb

@@ -0,0 +1,12 @@
+class GPT::Error < StandardError
+  attr_reader :status, :headers, :response
+
+  def initialize(message, status: nil, headers: nil, response: nil)
+    super(message)
+    @status = status
+    @headers = headers
+    @response = response
+  end
+end
+
+

data/lib/gpt/responses.rb

@@ -0,0 +1,48 @@
+module GPT
+  class Responses
+    def initialize(client)
+      @client = client
+    end
+
+    def create(payload)
+      @client.json_post('/v1/responses', body: payload)
+    end
+
+    def get(response_id, include: nil, include_obfuscation: nil, starting_after: nil, stream: nil)
+      query = {}
+      query['include[]'] = include if include
+      query['include_obfuscation'] = include_obfuscation unless include_obfuscation.nil?
+      query['starting_after'] = starting_after if starting_after
+      query['stream'] = stream unless stream.nil?
+      @client.json_get("/v1/responses/#{response_id}", query: query)
+    end
+
+    def delete(response_id)
+      @client.json_delete("/v1/responses/#{response_id}")
+    end
+
+    def cancel(response_id)
+      @client.json_post("/v1/responses/#{response_id}/cancel")
+    end
+
+    def input_items(response_id, after: nil, before: nil, include: nil, limit: nil, order: nil)
+      query = {}
+      query['after'] = after if after
+      query['before'] = before if before
+      query['include[]'] = include if include
+      query['limit'] = limit if limit
+      query['order'] = order if order
+      @client.json_get("/v1/responses/#{response_id}/input_items", query: query)
+    end
+
+    def stream(payload)
+      payload = payload.dup
+      payload['stream'] = true
+      @client.sse_stream('/v1/responses', body: payload) do |chunk|
+        yield chunk if block_given?
+      end
+    end
+  end
+end
+
+

data/lib/gpt.rb

@@ -0,0 +1,19 @@
+require 'oj'
+require 'net/http'
+require 'uri'
+
+require_relative 'gpt/error'
+require_relative 'gpt/client'
+require_relative 'gpt/responses'
+
+module GPT
+  def self.client
+    @client ||= Client.new
+  end
+
+  def self.responses
+    @responses ||= Responses.new(client)
+  end
+end
+
+

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: gpt
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gedean Dias
+bindir: bin
+cert_chain: []
+date: 2025-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Based on ruby-openai, adds some extra features for working with OpenAI
+  APIs
+email: gedean.dias@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/gpt.rb
+- lib/gpt/client.rb
+- lib/gpt/error.rb
+- lib/gpt/responses.rb
+homepage: https://github.com/gedean/openaiext
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.1
+specification_version: 4
+summary: GPT >= 5
+test_files: []