chatgpt-ruby 2.1.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fb132d30e599a50c8d7f9772fec8fed575883f5cfd3d3f42f91f0b9db9d345e
-  data.tar.gz: 68790d6783d57b4cbfaae685e0f8e6048f531959852bc91df4b62a8e61712532
+  metadata.gz: 538f8eab513f3dba9966108690eb3e744d6381cf401b656c7c5780e3e141b2d4
+  data.tar.gz: 2ba9e1b0a888d03419f40efcef0c4e85aa88d6b8b1a9d7986e6b86475e1defe6
 SHA512:
-  metadata.gz: 9729ae2cea19ff37e8b7fe0c810bc4a2c05d273078aad4702effe989c8fa393690605114a59c4022b4e758aad5e0451fe6667b68ee688bfe8e6f5594a31574bb
-  data.tar.gz: 4d42361f982bb0448bc9cceba09646ef14fd83b03b1940e6fed650aaf695e677e2da5e3caefbec57253c9adf38d9fae4384c311fae5f5d1d8c4a764343769c51
+  metadata.gz: 02ebe81d6af9b9fd3a1b2cfa03508e93917d764d5e873224575ee7d3fc986768c853027c9b1af8a7a6a2280b51a9531792a846b570b7e4eb3a1e114f29b3f32c
+  data.tar.gz: 074ba1aade1f0c6f20afa93e371b411c919afb7fceb38ce5ea898fd4efa5edb5206a0ca09867e803a72aa244c437c92c8562a1359258a5413723c75a159eee34

data/README.md

@@ -1,27 +1,20 @@
 # ChatGPT Ruby
 
-[![Gem Version](https://badge.fury.io/rb/chatgpt-ruby.svg)](https://badge.fury.io/rb/chatgpt-ruby)
-[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Maintainability](https://api.codeclimate.com/v1/badges/08c7e7b58e9fbe7156eb/maintainability)](https://codeclimate.com/github/nagstler/chatgpt-ruby/maintainability)
-[![Test Coverage](https://api.codeclimate.com/v1/badges/08c7e7b58e9fbe7156eb/test_coverage)](https://codeclimate.com/github/nagstler/chatgpt-ruby/test_coverage)
-[![CI](https://github.com/nagstler/chatgpt-ruby/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/nagstler/chatgpt-ruby/actions/workflows/ci.yml)
+<a href="https://badge.fury.io/rb/chatgpt-ruby"><img src="https://img.shields.io/gem/v/chatgpt-ruby?style=for-the-badge" alt="Gem Version"></a>
+<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"></a>
+<a href="https://codeclimate.com/github/nagstler/chatgpt-ruby/test_coverage"><img src="https://img.shields.io/codeclimate/coverage/nagstler/chatgpt-ruby?style=for-the-badge" alt="Test Coverage"></a>
+<a href="https://github.com/nagstler/chatgpt-ruby/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/nagstler/chatgpt-ruby/ci.yml?branch=main&style=for-the-badge" alt="CI"></a>
+<a href="https://github.com/nagstler/chatgpt-ruby/stargazers"><img src="https://img.shields.io/github/stars/nagstler/chatgpt-ruby?style=for-the-badge" alt="GitHub stars"></a>
 
-🤖💎 A comprehensive Ruby SDK for OpenAI's GPT APIs, providing a robust, feature-rich interface for AI-powered applications.
-
-📚 [Check out the Integration Guide](https://github.com/nagstler/chatgpt-ruby/wiki) to get started!
+🤖💎 A lightweight Ruby wrapper for the OpenAI API, designed for simplicity and ease of integration.
 
 ## Features
 
-- 🚀 Full support for GPT-3.5-Turbo and GPT-4 models
-- 📡 Streaming responses support
-- 🔧 Function calling and JSON mode
-- 🎨 DALL-E image generation
-- 🔄 Fine-tuning capabilities
-- 📊 Token counting and validation
-- ⚡ Async operations support
-- 🛡️ Built-in rate limiting and retries
-- 🎯 Type-safe responses
-- 📝 Comprehensive logging
+- API integration for chat completions and text completions
+- Streaming capability for handling real-time response chunks
+- Custom exception classes for different API error types
+- Configurable timeout, retries and default parameters
+- Complete test suite with mocked API responses
 
 ## Table of Contents
 
@@ -29,17 +22,12 @@
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
-- [Core Features](#core-features)
+- [Rails Integration](#rails-integration)
+- [Error Handling](#error-handling)
+- [Current Capabilities](#current-capabilities)
   - [Chat Completions](#chat-completions)
-  - [Function Calling](#function-calling)
-  - [Image Generation (DALL-E)](#image-generation-dall-e)
-  - [Fine-tuning](#fine-tuning)
-  - [Token Management](#token-management)
-  - [Error Handling](#error-handling)
-- [Advanced Usage](#advanced-usage)
-  - [Async Operations](#async-operations)
-  - [Batch Operations](#batch-operations)
-  - [Response Objects](#response-objects)
+  - [Text Completions](#text-completions)
+- [Roadmap](#roadmap)
 - [Development](#development)
 - [Contributing](#contributing)
 - [License](#license)
@@ -79,155 +67,113 @@ puts response.dig("choices", 0, "text")
 
 ```
 
-## Configuration
+## Rails Integration
+
+In a Rails application, create an initializer:
 
 ```ruby
+# config/initializers/chat_gpt.rb
+require 'chatgpt'
+
 ChatGPT.configure do |config|
-  config.api_key = ENV['OPENAI_API_KEY']
-  config.api_version = 'v1'
+  config.api_key = Rails.application.credentials.openai[:api_key]
   config.default_engine = 'gpt-3.5-turbo'
   config.request_timeout = 30
-  config.max_retries = 3
-  config.default_parameters = {
-    max_tokens: 16,
-    temperature: 0.5,
-    top_p: 1.0,
-    n: 1
-  }
 end
 ```
-
-## Core Features
-
-### Chat Completions
+Then use it in your controllers or services:
 
 ```ruby
-# Chat with system message
-response = client.chat([
-  { role: "system", content: "You are a helpful assistant." },
-  { role: "user", content: "Hello!" }
-])
+# app/services/chat_gpt_service.rb
+class ChatGPTService
+  def initialize
+    @client = ChatGPT::Client.new
+  end
+  
+  def ask_question(question)
+    response = @client.chat([
+      { role: "user", content: question }
+    ])
+    
+    response.dig("choices", 0, "message", "content")
+  end
+end
 
-# With streaming
-client.chat_stream([
-  { role: "user", content: "Tell me a story" }
-]) do |chunk|
-  print chunk.dig("choices", 0, "delta", "content")
+# Usage in controller
+def show
+  service = ChatGPTService.new
+  @response = service.ask_question("Tell me about Ruby on Rails")
 end
 ```
 
-### Function Calling
+## Configuration
 
 ```ruby
-functions = [
-  {
-    name: "get_weather",
-    description: "Get current weather",
-    parameters: {
-      type: "object",
-      properties: {
-        location: { type: "string" },
-        unit: { type: "string", enum: ["celsius", "fahrenheit"] }
-      }
-    }
+ChatGPT.configure do |config|
+  config.api_key = ENV['OPENAI_API_KEY']
+  config.api_version = 'v1'
+  config.default_engine = 'gpt-3.5-turbo'
+  config.request_timeout = 30
+  config.max_retries = 3
+  config.default_parameters = {
+    max_tokens: 16,
+    temperature: 0.5,
+    top_p: 1.0,
+    n: 1
   }
-]
-
-response = client.chat(
-  messages: [{ role: "user", content: "What's the weather in London?" }],
-  functions: functions,
-  function_call: "auto"
-)
-```
-
-### Image Generation (DALL-E)
-
-```ruby
-# Generate image
-image = client.images.generate(
-  prompt: "A sunset over mountains",
-  size: "1024x1024",
-  quality: "hd"
-)
-
-# Create variations
-variation = client.images.create_variation(
-  image: File.read("input.png"),
-  n: 1
-)
-```
-
-### Fine-tuning
-
-```ruby
-# Create fine-tuning job
-job = client.fine_tunes.create(
-  training_file: "file-abc123",
-  model: "gpt-3.5-turbo"
-)
-
-# List fine-tuning jobs
-jobs = client.fine_tunes.list
-
-# Get job status
-status = client.fine_tunes.retrieve(job.id)
-```
-
-### Token Management
-
-```ruby
-# Count tokens
-count = client.tokens.count("Your text here", model: "gpt-4")
-
-# Validate token limits
-client.tokens.validate_messages(messages, max_tokens: 4000)
+end
 ```
 
-### Error Handling
+## Error handling
 
 ```ruby
 begin
-  response = client.chat(messages: [...])
+  response = client.chat([
+    { role: "user", content: "Hello!" }
+  ])
+rescue ChatGPT::AuthenticationError => e
+  puts "Authentication error: #{e.message}"
 rescue ChatGPT::RateLimitError => e
   puts "Rate limit hit: #{e.message}"
+rescue ChatGPT::InvalidRequestError => e
+  puts "Bad request: #{e.message}"
 rescue ChatGPT::APIError => e
   puts "API error: #{e.message}"
-rescue ChatGPT::TokenLimitError => e
-  puts "Token limit exceeded: #{e.message}"
 end
 ```
 
-## Advanced Usage
-
-### Async Operations
+## Current Capabilities
 
+### Chat Completions
 ```ruby
-client.async do
-  response1 = client.chat(messages: [...])
-  response2 = client.chat(messages: [...])
-  [response1, response2]
+# Basic chat
+response = client.chat([
+  { role: "user", content: "What is Ruby?" }
+])
+
+# With streaming
+client.chat_stream([{ role: "user", content: "Tell me a story" }]) do |chunk|
+  print chunk.dig("choices", 0, "delta", "content")
 end
 ```
 
-### Batch Operations
-
+### Text Completions
 ```ruby
-responses = client.batch do |batch|
-  batch.add_chat(messages: [...])
-  batch.add_chat(messages: [...])
-end
+# Basic completion with GPT-3.5-turbo-instruct
+response = client.completions("What is Ruby?")
+puts response.dig("choices", 0, "text")
 ```
 
-### Response Objects
+## Roadmap
 
-```ruby
-response = client.chat(messages: [...])
+While ChatGPT Ruby is functional, there are several areas planned for improvement:
 
-response.content  # Main response content
-response.usage   # Token usage information
-response.finish_reason  # Why the response ended
-response.model   # Model used
-```
+- [ ] Response object wrapper & Rails integration with Railtie (v2.2)
+- [ ] Token counting, function calling, and rate limiting (v2.3)
+- [ ] Batch operations and async support (v3.0)
+- [ ] DALL-E image generation and fine-tuning (Future)
+
+❤️ Contributions in any of these areas are welcome!
 
 ## Development
 

data/lib/chatgpt/client.rb

@@ -31,7 +31,7 @@ module ChatGPT
       url = "#{@endpoint}/chat/completions"
 
       data = @config.default_parameters.merge(
-        model: params[:model] || 'gpt-3.5-turbo',
+        model: params[:model] || @config.default_engine, # Use configured default_engine
         messages: messages,
         temperature: params[:temperature],
         top_p: params[:top_p],
@@ -47,7 +47,7 @@ module ChatGPT
 
       url = "#{@endpoint}/chat/completions"
       data = @config.default_parameters.merge(
-        model: params[:model] || 'gpt-3.5-turbo',
+        model: params[:model] || @config.default_engine,  # Use configured default_engine
         messages: messages,
         stream: true
       ).compact

data/lib/chatgpt/railtie.rb

@@ -0,0 +1,11 @@
+# lib/chatgpt/railtie.rb
+module ChatGPT
+    class Railtie < Rails::Railtie
+      initializer "chatgpt.configure_rails_initialization" do
+        # Register inflection for Rails apps
+        ActiveSupport::Inflector.inflections(:en) do |inflect|
+          inflect.acronym 'GPT'
+        end
+      end
+    end
+end

data/lib/chatgpt/version.rb

@@ -2,5 +2,5 @@
 
 # lib/chatgpt/version.rb
 module ChatGPT
-  VERSION = "2.1.0"
+  VERSION = "2.1.1"
 end

data/lib/chatgpt.rb

@@ -6,6 +6,9 @@ require_relative 'chatgpt/errors'
 require_relative 'chatgpt/configuration'
 require_relative 'chatgpt/client'
 
+# Automatically load Railtie when used with Rails
+require_relative 'chatgpt/railtie' if defined?(Rails)
+
 module ChatGPT
   class << self
     def configuration

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chatgpt-ruby
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Nagendra Dhanakeerthi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-30 00:00:00.000000000 Z
+date: 2025-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -149,6 +149,7 @@ files:
 - lib/chatgpt/client.rb
 - lib/chatgpt/configuration.rb
 - lib/chatgpt/errors.rb
+- lib/chatgpt/railtie.rb
 - lib/chatgpt/version.rb
 homepage: https://github.com/nagstler/chatgpt-ruby
 licenses:
@@ -173,7 +174,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.2
 signing_key:
 specification_version: 4
 summary: Ruby client for OpenAI's ChatGPT API