llm_ruby 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0de9e01920a472c7a04f9f794747090e3bf279b403d4efa206b1db7c2b006987
-  data.tar.gz: bd77b3a4c5540a82d4a6f1b93213a8b3da60cc9342e581335adeac6fe93c999f
+  metadata.gz: 44e89bad9131f49c40cf578fac3790c1e3e5f266aead751ecea606ac2a4ad5aa
+  data.tar.gz: 03ccc6124c9c3d92dda0828100cec0c9beb0d4bb90baa464c47640528265cc3c
 SHA512:
-  metadata.gz: bc4b0263dfeaf1db4dded66667ea13e65dfc035d27579a2b032a59ae63f29fd588630d749d492d281322269fbc9d3909f8648f464d250baa99ff5b2afd582193
-  data.tar.gz: a4c5713df43e27127afa0b3cbf044ce8d805235f73abd05b3f79dc9fc7a814c193caac9192392a8670523cf74be96da2b52dc648d965116e8e9bbc3f8a2aaaaa
+  metadata.gz: c5bee46644a205067b9e33a749e042a971b066f978de234bec0841f89cea4aa8b3d2b42e0d890b073ad78ebd770416aaae2fbe5181e5e6926d59bd7b9c7dc58d
+  data.tar.gz: f35f5f988cb54f199d52e324385a0a16e1eee720585a6118d21459e4a1ad7e526f7e77618d0124ea4b35da18a0c078f6f00648cd90203bd5517806289956d2f1

data/CLAUDE.md

@@ -0,0 +1,22 @@
+# LLM Ruby Development Guide
+
+## Build & Test Commands
+- Setup: `bin/setup`
+- Install locally: `bundle exec rake install`
+- Run all tests: `bundle exec rake spec`
+- Run single test: `bundle exec rspec spec/path/to_spec.rb:LINE_NUMBER`
+- Run linter: `bundle exec rake standard`
+- Interactive console: `bin/console`
+
+## Code Style Guidelines
+- Use `frozen_string_literal: true` at the top of all Ruby files
+- Follow Standard Ruby style (`standard` gem)
+- Naming: snake_case for methods/variables, CamelCase for classes
+- Use double quotes consistently for strings
+- Explicit returns are optional (prefer implicit returns when possible)
+- Class organization: constants first, then class methods, then initialize, then instance methods
+- Keep methods and classes small and focused (single responsibility)
+- Cover all code with tests in the `spec` directory
+- API credentials should be read from environment variables
+- Use proper type inflection (e.g., "llm" => "LLM", "open_ai" => "OpenAI")
+- Use VCR/webmock for testing HTTP interactions

data/README.md

@@ -5,7 +5,6 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 
-
 LLMRuby is a Ruby gem that provides a consistent interface for interacting with multiple Large Language Model (LLM) APIs. Most OpenAI, Anthropic and Gemini models are currently supported.
 
 ## Installation
@@ -172,6 +171,26 @@ export ANTHROPIC_API_KEY=your_api_key_here
 export GEMINI_API_KEY=your_api_key_here
 ```
 
+## Structured Outputs
+
+OpenAI and Gemini models can be configured to generate responses that adhere to a provided schema. Even though each use a different format for configuring this schema, `llm_ruby` can handle the translation for you, so that you can share a single schema definition across models.
+
+```ruby
+
+llm = LLM.from_string!("gpt-4o")
+
+# Create a client
+client = llm.client
+
+# Send a chat message
+response_format = LLM::Schema.new("test_schema", {"type" => "object", "properties" => {"name" => {"type" => "string"}, "age" => {"type" => "integer"}}, "additionalProperties" => false, "required" => ["name", "age"]})
+# or load the schema from a file: LLM::Schema.from_file('myschema.json')
+response = client.chat([{role: :user, content: "Hello, world!"}], response_format: response_format)
+
+response.structured_output[:name] # Alex
+response.structured_output_object.name # Alex
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/llm/clients/open_ai.rb

@@ -11,6 +11,7 @@ class LLM
 
       def initialize(llm:)
         @llm = llm
+        @logger = LLM.config.logger
       end
 
       def chat(messages, options = {})
@@ -95,7 +96,10 @@ class LLM
       end
 
       def post_url(url, **kwargs)
-        self.class.post(url, **kwargs.merge(headers: default_headers))
+        @logger.debug("Request: #{kwargs.inspect}")
+        resp = self.class.post(url, **kwargs.merge(headers: default_headers))
+        @logger.debug("Response: #{resp.body}")
+        resp
       end
 
       def post_url_streaming(url, **kwargs, &block)

data/lib/llm/config.rb

@@ -0,0 +1,12 @@
+require "logger"
+
+class LLM
+  class Config
+    attr_accessor :logger
+
+    def initialize
+      @logger = ::Logger.new($stderr)
+      @logger.level = ::Logger::INFO
+    end
+  end
+end

data/lib/llm.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 require "zeitwerk"
+
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect(
   "llm" => "LLM",
   "open_ai" => "OpenAI"
 )
+loader.ignore("#{__dir__}/llm_ruby.rb")
 loader.setup
 
 class LLM
@@ -31,6 +33,10 @@ class LLM
     @supports_structured_outputs
   end
 
+  def self.config
+    @config ||= LLM::Config.new
+  end
+
   private
 
   attr_reader :client_class

data/lib/llm_ruby.rb

@@ -0,0 +1 @@
+require "llm"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Alex Gamble
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.6.0
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -141,6 +155,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".standard.yml"
+- CLAUDE.md
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -152,12 +167,14 @@ files:
 - lib/llm/clients/gemini/response.rb
 - lib/llm/clients/open_ai.rb
 - lib/llm/clients/open_ai/response.rb
+- lib/llm/config.rb
 - lib/llm/info.rb
 - lib/llm/provider.rb
 - lib/llm/response.rb
 - lib/llm/schema.rb
 - lib/llm/stop_reason.rb
 - lib/llm/version.rb
+- lib/llm_ruby.rb
 homepage: https://github.com/agamble/llm_ruby
 licenses:
 - MIT