last_llm 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8d63b9fe1cfc2adcf7d290b1deee351c2dbdde0922931f6bdc950b47e882884
-  data.tar.gz: 2ce5e77677f5734d6aa300083e1d62345e7da9b57db87dec88b4eb0945f5a35f
+  metadata.gz: c45436277c2f585b851688ade72bbd838d33f0c51b0792942e56734e534a9a2e
+  data.tar.gz: 0ad94566719d472ccfcea83cb5bce21cd4142df80b2ffdda0f139ff561d6c9d8
 SHA512:
-  metadata.gz: 99ebc99586238fa7bdc6464d01dba3ec0bb933488f2a9b61ca2201f93e97689cca59893628185649524582d4fa2da9be86867ebb7a4373b8b32ca0cc5e1459ea
-  data.tar.gz: ed0ebd17190f1797ff6f45523461fca9813066aedbb05fa13e7e9660cad567aa10d1f082655ab6d5c498116a330347a4f998d6e0118ee5cf940a76d81b3fff3e
+  metadata.gz: c77932637b424601a950f6ad655c3886773be3b9880f4ce5607d4af18f0036876dd9463c973f64628c1a97ef50d73b56af9d6cd7f492144da164177dc628d4dc
+  data.tar.gz: 51709ae9cfee0d6047b5076ca0926f6395ebae1cbaa7c3b6621787dca86e8f0ff3a5d3e5f44a1d1038315effeae118b32352b963ae12f23fdd43c7356b99ca1e

data/README.md

@@ -45,128 +45,28 @@ LastLLM.configure do |config|
 end
 ```
 
-### Rails Integration
+### Logging
 
-LastLLM automatically integrates with Rails applications. Create a `config/last_llm.yml` file:
-
-```yaml
-default_provider: openai
-default_model: gpt-3.5-turbo
-globals:
-  timeout: 30
-  max_retries: 3
-```
-
-## Usage
-
-### Basic Text Generation
+LastLLM supports custom logging for monitoring requests, responses, and errors. You can configure a custom logger to integrate with your existing logging system:
 
 ```ruby
-client = LastLLM.client
-response = client.generate_text("What is the capital of France?")
-```
-
-### Structured Data Generation
+LastLLM.configure do |config|
+  # Use Rails logger
+  config.logger = Rails.logger
 
-```ruby
-schema = Dry::Schema.JSON do
-  required(:name).filled(:string)
-  required(:age).filled(:integer)
-  optional(:email).maybe(:string)
+  # Set log level (optional, defaults to :info)
+  config.log_level = :debug
 end
-
-client = LastLLM.client
-result = client.generate_object("Generate information about a person", schema)
 ```
 
-### Tool Calling
-
-```ruby
-calculator = LastLLM::Tool.new(
-  name: "calculator",
-  description: "Perform mathematical calculations",
-  parameters: {
-    type: "object",
-    properties: {
-      operation: {
-        type: "string",
-        enum: ["add", "subtract", "multiply", "divide"]
-      },
-      a: { type: "number" },
-      b: { type: "number" }
-    },
-    required: ["operation", "a", "b"]
-  },
-  function: ->(params) {
-    case params[:operation]
-    when "add"
-      { result: params[:a] + params[:b] }
-    end
-  }
-)
-```
-
-## Error Handling
-
-LastLLM provides several error classes:
-- `LastLLM::Error`: Base error class
-- `LastLLM::ConfigurationError`: Configuration-related errors
-- `LastLLM::ValidationError`: Schema validation errors
-- `LastLLM::ApiError`: API request errors
-
-## Development
+In a Rails application, you can also configure this in your `config/last_llm.yml`:
 
-After checking out the repo, run `bundle install` to install dependencies. Then, run `rspec` to run the tests.
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub.
-# LastLLM
-
-LastLLM is a unified client for interacting with various LLM (Large Language Model) providers. It provides a consistent interface for text generation, structured data generation, and tool calling across different LLM services.
-
-## Features
-
-- Unified interface for multiple LLM providers:
-  - OpenAI
-  - Anthropic
-  - Google Gemini
-  - Deepseek
-  - Ollama
-- Text generation
-- Structured data generation with schema validation
-- Tool/function calling support
-- Rails integration
-- Configuration management
-- Error handling
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'last_llm'
+```yaml
+logger: Rails.logger
+log_level: debug
 ```
 
-## Configuration
-
-Configure LastLLM globally or per instance:
-
-```ruby
-LastLLM.configure do |config|
-  config.default_provider = :openai
-  config.default_model = 'gpt-3.5-turbo'
-
-  # Configure OpenAI
-  config.configure_provider(:openai, api_key: 'your-api-key')
-
-  # Configure Anthropic
-  config.configure_provider(:anthropic, api_key: 'your-api-key')
-
-  # Configure Ollama
-  config.configure_provider(:ollama, host: 'http://localhost:11434')
-end
-```
+This will log LLM requests, responses, and errors to your Rails application logs, helping you debug and monitor your AI interactions.
 
 ### Rails Integration
 

data/lib/generators/last_llm/install/install_generator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module LastLLM
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Creates a LastLLM configuration file and initializer'
+
+      def create_config_file
+        template 'last_llm.yml', 'config/last_llm.yml'
+      end
+
+      def create_initializer
+        template 'initializer.rb', 'config/initializers/last_llm.rb'
+      end
+
+      def show_readme
+        readme 'README.md'
+      end
+    end
+  end
+end

data/lib/generators/last_llm/install/templates/README.md

@@ -0,0 +1,20 @@
+LastLLM Installation
+===================
+
+LastLLM has been installed. Here's what was created:
+
+* config/last_llm.yml - Main configuration file
+* config/initializers/last_llm.rb - Rails initializer
+
+Next steps:
+
+1. Edit config/last_llm.yml and add your API keys
+2. Set up environment variables for your API keys
+3. Test the installation:
+
+```ruby
+client = LastLLM.client
+response = client.generate_text("Hello, world!")
+```
+
+For more information, visit: https://github.com/joemocha/last_llm

data/lib/generators/last_llm/install/templates/initializer.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Configure LastLLM
+LastLLM.configure do |config|
+  # Load configuration from config/last_llm.yml
+  config_file = Rails.root.join('config', 'last_llm.yml')
+  if File.exist?(config_file)
+    yaml_config = YAML.safe_load_file(config_file, symbolize_names: true)
+    
+    # Set default provider
+    config.default_provider = yaml_config[:default_provider].to_sym if yaml_config[:default_provider]
+    
+    # Set default model
+    config.default_model = yaml_config[:default_model] if yaml_config[:default_model]
+    
+    # Configure providers
+    yaml_config[:providers]&.each do |provider, settings|
+      settings.each do |key, value|
+        config.set_provider_config(provider, key, value)
+      end
+    end
+    
+    # Configure global settings
+    yaml_config[:globals]&.each do |key, value|
+      config.set_global(key.to_sym, value)
+    end
+  end
+end

data/lib/generators/last_llm/install/templates/last_llm.yml

@@ -0,0 +1,29 @@
+# LastLLM Configuration
+
+# Default provider to use (options: :openai, :anthropic, :google_gemini, :deepseek, :ollama)
+default_provider: :openai
+
+# Default model to use (provider-specific)
+default_model: gpt-3.5-turbo
+
+# Global settings
+globals:
+  temperature: 0.7
+  max_tokens: 1000
+
+# Provider-specific configurations
+providers:
+  openai:
+    api_key: <%= ENV['OPENAI_API_KEY'] %>
+    
+  anthropic:
+    api_key: <%= ENV['ANTHROPIC_API_KEY'] %>
+    
+  google_gemini:
+    api_key: <%= ENV['GOOGLE_GEMINI_API_KEY'] %>
+    
+  deepseek:
+    api_key: <%= ENV['DEEPSEEK_API_KEY'] %>
+    
+  ollama:
+    host: http://localhost:11434

data/lib/last_llm/provider.rb

@@ -148,5 +148,91 @@ module LastLLM
         end
       end
     end
+
+    def make_request(prompt, options = {})
+      log_request(prompt, options)
+
+      response = yield
+
+      log_response(response)
+
+      handle_response(response) do |result|
+        yield(result)
+      end
+    rescue Faraday::Error => e
+      @logger&.error("[#{@name}] Request failed: #{e.message}")
+      handle_provider_error(e)
+    end
+
+    private
+
+    def log_request(prompt, options)
+      return unless @logger
+
+      sanitized_options = options.dup
+      # Remove sensitive data
+      sanitized_options.delete(:api_key)
+
+      @logger.info("[#{@name}] Request - Model: #{options[:model]}")
+      @logger.debug("[#{@name}] Prompt: #{prompt}")
+      @logger.debug("[#{@name}] Options: #{sanitized_options.inspect}")
+    end
+
+    def log_response(response)
+      return unless @logger
+
+      @logger.info("[#{@name}] Response received - Status: #{response.status}")
+      @logger.debug("[#{@name}] Response body: #{response.body}")
+    rescue StandardError => e
+      @logger.error("[#{@name}] Failed to log response: #{e.message}")
+    end
+
+    def handle_provider_error(error)
+      @logger&.error("[#{@name}] #{error.class}: #{error.message}")
+      raise ApiError.new(error.message, error.response&.status)
+    end
+
+    def make_request(prompt, options = {})
+      log_request(prompt, options)
+
+      response = yield
+
+      log_response(response)
+
+      handle_response(response) do |result|
+        yield(result)
+      end
+    rescue Faraday::Error => e
+      @logger&.error("[#{@name}] Request failed: #{e.message}")
+      handle_provider_error(e)
+    end
+
+    private
+
+    def log_request(prompt, options)
+      return unless @logger
+
+      sanitized_options = options.dup
+      # Remove sensitive data
+      sanitized_options.delete(:api_key)
+
+      @logger.info("[#{@name}] Request - Model: #{options[:model]}")
+      @logger.debug("[#{@name}] Prompt: #{prompt}")
+      @logger.debug("[#{@name}] Options: #{sanitized_options.inspect}")
+    end
+
+    def log_response(response)
+      return unless @logger
+
+      @logger.info("[#{@name}] Response received - Status: #{response.status}")
+      @logger.debug("[#{@name}] Response body: #{response.body}")
+    rescue StandardError => e
+      @logger.error("[#{@name}] Failed to log response: #{e.message}")
+    end
+
+    def handle_provider_error(error)
+      @logger&.error("[#{@name}] #{error.class}: #{error.message}")
+      raise ApiError.new(error.message, error.response&.status)
+    end
   end
 end

data/lib/last_llm/providers/google_gemini.rb

@@ -32,7 +32,7 @@ module LastLLM
       end
 
       def generate_text(prompt, options = {})
-        make_request(prompt, options) do |response|
+          make_request(prompt, options) do |response|
           extract_text_content(response)
         end
       end

data/lib/last_llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LastLLM
-  VERSION = '0.0.5'
+  VERSION = '0.0.7'
 end

data/lib/tasks/release.rake

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+
+namespace :version do
+  desc 'Bump major version (X.y.z)'
+  task :major do
+    bump_version(:major)
+  end
+
+  desc 'Bump minor version (x.Y.z)'
+  task :minor do
+    bump_version(:minor)
+  end
+
+  desc 'Bump patch version (x.y.Z)'
+  task :patch do
+    bump_version(:patch)
+  end
+
+  def bump_version(type)
+    version_file = 'lib/last_llm/version.rb'
+    content = File.read(version_file)
+    current_version = content.match(/VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/)[1]
+    major, minor, patch = current_version.split('.').map(&:to_i)
+
+    case type
+    when :major
+      major += 1
+      minor = 0
+      patch = 0
+    when :minor
+      minor += 1
+      patch = 0
+    when :patch
+      patch += 1
+    end
+
+    new_version = "#{major}.#{minor}.#{patch}"
+    new_content = content.gsub(/VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/, "VERSION = '#{new_version}'")
+    
+    File.write(version_file, new_content)
+    puts "Version bumped to #{new_version}"
+  end
+end
+
+namespace :release do
+  desc 'Build and push gem to RubyGems'
+  task :push do
+    system('gem build last_llm.gemspec') || abort('Gem build failed')
+    gem_file = Dir['last_llm-*.gem'].sort_by { |f| File.mtime(f) }.last
+    system("gem push #{gem_file}") || abort('Gem push failed')
+    FileUtils.rm(gem_file)
+    puts "Successfully released #{gem_file}"
+  end
+end
+
+desc 'Bump version, build and push gem (usage: rake release[patch])'
+task :release, [:type] => [:clean] do |_, args|
+  type = (args[:type] || 'patch').to_sym
+  unless %i[major minor patch].include?(type)
+    abort "Invalid version type. Use 'major', 'minor', or 'patch'"
+  end
+
+  Rake::Task["version:#{type}"].invoke
+  Rake::Task['release:push'].invoke
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: last_llm
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - Sam Obukwelu
@@ -101,6 +101,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- lib/generators/last_llm/install/install_generator.rb
+- lib/generators/last_llm/install/templates/README.md
+- lib/generators/last_llm/install/templates/initializer.rb
+- lib/generators/last_llm/install/templates/last_llm.yml
 - lib/last_llm.rb
 - lib/last_llm/client.rb
 - lib/last_llm/completion.rb
@@ -119,6 +123,7 @@ files:
 - lib/last_llm/structured_output.rb
 - lib/last_llm/tool.rb
 - lib/last_llm/version.rb
+- lib/tasks/release.rake
 homepage: https://github.com/joemocha/last_llm
 licenses:
 - MIT