langfuse-ruby 0.1.2 → 0.1.3

data/lib/langfuse/trace.rb

@@ -24,23 +24,6 @@ module Langfuse
       create_trace
     end
 
-    def update(name: nil, user_id: nil, session_id: nil, version: nil, release: nil,
-               input: nil, output: nil, metadata: nil, tags: nil, **kwargs)
-      @name = name if name
-      @user_id = user_id if user_id
-      @session_id = session_id if session_id
-      @version = version if version
-      @release = release if release
-      @input = input if input
-      @output = output if output
-      @metadata.merge!(metadata) if metadata
-      @tags.concat(tags) if tags
-      @kwargs.merge!(kwargs)
-
-      update_trace
-      self
-    end
-
     def span(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
              metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
              version: nil, **kwargs)
@@ -84,6 +67,23 @@ module Langfuse
       )
     end
 
+    def event(name:, start_time: nil, input: nil, output: nil, metadata: nil,
+              level: nil, status_message: nil, parent_observation_id: nil, version: nil, **kwargs)
+      @client.event(
+        trace_id: @id,
+        name: name,
+        start_time: start_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        **kwargs
+      )
+    end
+
     def score(name:, value:, data_type: nil, comment: nil, **kwargs)
       @client.score(
         trace_id: @id,
@@ -134,22 +134,5 @@ module Langfuse
 
       @client.enqueue_event('trace-create', data)
     end
-
-    def update_trace
-      data = {
-        id: @id,
-        name: @name,
-        user_id: @user_id,
-        session_id: @session_id,
-        version: @version,
-        release: @release,
-        input: @input,
-        output: @output,
-        metadata: @metadata,
-        tags: @tags
-      }.merge(@kwargs).compact
-
-      @client.enqueue_event('trace-update', data)
-    end
   end
 end

data/lib/langfuse/utils.rb

@@ -26,12 +26,34 @@ module Langfuse
         return hash unless hash.is_a?(Hash)
 
         hash.each_with_object({}) do |(key, value), result|
-          new_key = key.to_s
+          new_key = camelize_key(key.to_s)
           new_value = value.is_a?(Hash) ? deep_stringify_keys(value) : value
           result[new_key] = new_value
         end
       end
 
+      # 将哈希的键名转换为小驼峰格式
+      def deep_camelize_keys(hash)
+        return hash unless hash.is_a?(Hash)
+
+        hash.each_with_object({}) do |(key, value), result|
+          new_key = camelize_key(key.to_s)
+          new_value = value.is_a?(Hash) ? deep_camelize_keys(value) : value
+          result[new_key] = new_value
+        end
+      end
+
+      private
+
+      # 将蛇形命名转换为小驼峰命名
+      def camelize_key(key)
+        return key if key.empty? || !key.include?('_')
+
+        key.split('_').map.with_index do |part, index|
+          index.zero? ? part.downcase : part.capitalize
+        end.join
+      end
+
       def validate_required_fields(data, required_fields)
         missing_fields = required_fields.select { |field| data[field].nil? || data[field].to_s.empty? }
         raise ValidationError, "Missing required fields: #{missing_fields.join(', ')}" unless missing_fields.empty?

data/lib/langfuse/version.rb

@@ -1,3 +1,3 @@
 module Langfuse
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

data/lib/langfuse.rb

@@ -5,6 +5,7 @@ require_relative 'langfuse/client'
 require_relative 'langfuse/trace'
 require_relative 'langfuse/span'
 require_relative 'langfuse/generation'
+require_relative 'langfuse/event'
 require_relative 'langfuse/prompt'
 require_relative 'langfuse/evaluation'
 require_relative 'langfuse/errors'
@@ -30,7 +31,7 @@ module Langfuse
 
   # Configuration class for Langfuse client settings
   class Configuration
-    attr_accessor :public_key, :secret_key, :host, :debug, :timeout, :retries
+    attr_accessor :public_key, :secret_key, :host, :debug, :timeout, :retries, :flush_interval, :auto_flush
 
     def initialize
       @public_key = nil
@@ -39,6 +40,8 @@ module Langfuse
       @debug = false
       @timeout = 30
       @retries = 3
+      @flush_interval = 5
+      @auto_flush = true
     end
   end
 end

data/test_offline.rb

@@ -2,30 +2,30 @@
 
 require_relative 'lib/langfuse'
 
-puts "🚀 Testing Langfuse Ruby SDK (Offline Mode)..."
+puts '🚀 Testing Langfuse Ruby SDK (Offline Mode)...'
 
 # Test 1: Basic configuration
 puts "\n1. Testing configuration..."
 Langfuse.configure do |config|
-  config.public_key = "test_key"
-  config.secret_key = "test_secret"
-  config.host = "https://test.langfuse.com"
-  config.debug = false  # Turn off debug to avoid network calls
+  config.public_key = 'test_key'
+  config.secret_key = 'test_secret'
+  config.host = 'https://test.langfuse.com'
+  config.debug = false # Turn off debug to avoid network calls
 end
 
-puts "✅ Configuration successful"
+puts '✅ Configuration successful'
 
 # Test 2: Client initialization
 puts "\n2. Testing client initialization..."
 begin
   client = Langfuse.new(
-    public_key: "test_key",
-    secret_key: "test_secret",
-    host: "https://test.langfuse.com",
+    public_key: 'test_key',
+    secret_key: 'test_secret',
+    host: 'https://test.langfuse.com',
     debug: false
   )
-  puts "✅ Client initialization successful"
-rescue => e
+  puts '✅ Client initialization successful'
+rescue StandardError => e
   puts "❌ Client initialization failed: #{e.message}"
 end
 
@@ -33,13 +33,13 @@ end
 puts "\n3. Testing trace creation..."
 begin
   trace = client.trace(
-    name: "test-trace",
-    user_id: "test-user",
-    input: { message: "Hello, world!" }
+    name: 'test-trace',
+    user_id: 'test-user',
+    input: { message: 'Hello, world!' }
   )
-  puts "✅ Trace creation successful"
+  puts '✅ Trace creation successful'
   puts "   Trace ID: #{trace.id}"
-rescue => e
+rescue StandardError => e
   puts "❌ Trace creation failed: #{e.message}"
 end
 
@@ -47,14 +47,14 @@ end
 puts "\n4. Testing generation creation..."
 begin
   generation = trace.generation(
-    name: "test-generation",
-    model: "gpt-3.5-turbo",
-    input: [{ role: "user", content: "Hello!" }],
-    output: { content: "Hi there!" }
+    name: 'test-generation',
+    model: 'gpt-3.5-turbo',
+    input: [{ role: 'user', content: 'Hello!' }],
+    output: { content: 'Hi there!' }
   )
-  puts "✅ Generation creation successful"
+  puts '✅ Generation creation successful'
   puts "   Generation ID: #{generation.id}"
-rescue => e
+rescue StandardError => e
   puts "❌ Generation creation failed: #{e.message}"
 end
 
@@ -62,18 +62,18 @@ end
 puts "\n5. Testing prompt template..."
 begin
   template = Langfuse::PromptTemplate.from_template(
-    "Hello {{name}}! How are you feeling {{mood}} today?"
+    'Hello {{name}}! How are you feeling {{mood}} today?'
   )
 
   formatted = template.format(
-    name: "Alice",
-    mood: "happy"
+    name: 'Alice',
+    mood: 'happy'
   )
 
-  puts "✅ Prompt template successful"
+  puts '✅ Prompt template successful'
   puts "   Variables: #{template.input_variables}"
   puts "   Formatted: #{formatted}"
-rescue => e
+rescue StandardError => e
   puts "❌ Prompt template failed: #{e.message}"
 end
 
@@ -81,19 +81,20 @@ end
 puts "\n6. Testing chat prompt template..."
 begin
   chat_template = Langfuse::ChatPromptTemplate.from_messages([
-    { role: "system", content: "You are a helpful {{role}} assistant." },
-    { role: "user", content: "{{user_input}}" }
-  ])
+                                                               { role: 'system',
+                                                                 content: 'You are a helpful {{role}} assistant.' },
+                                                               { role: 'user', content: '{{user_input}}' }
+                                                             ])
 
   messages = chat_template.format(
-    role: "coding",
-    user_input: "Help me with Ruby"
+    role: 'coding',
+    user_input: 'Help me with Ruby'
   )
 
-  puts "✅ Chat prompt template successful"
+  puts '✅ Chat prompt template successful'
   puts "   Variables: #{chat_template.input_variables}"
   puts "   Messages: #{messages.length}"
-rescue => e
+rescue StandardError => e
   puts "❌ Chat prompt template failed: #{e.message}"
 end
 
@@ -103,26 +104,26 @@ begin
   # Exact match evaluator
   exact_match = Langfuse::Evaluators::ExactMatchEvaluator.new
   result = exact_match.evaluate(
-    "What is 2+2?",
-    "4",
-    expected: "4"
+    'What is 2+2?',
+    '4',
+    expected: '4'
   )
   puts "✅ Exact match evaluator: #{result}"
 
   # Similarity evaluator
   similarity = Langfuse::Evaluators::SimilarityEvaluator.new
   result = similarity.evaluate(
-    "What is AI?",
-    "Artificial Intelligence",
-    expected: "AI is artificial intelligence"
+    'What is AI?',
+    'Artificial Intelligence',
+    expected: 'AI is artificial intelligence'
   )
   puts "✅ Similarity evaluator: #{result}"
 
   # Length evaluator
   length = Langfuse::Evaluators::LengthEvaluator.new(min_length: 5, max_length: 20)
   result = length.evaluate(
-    "Test input",
-    "This is a test",
+    'Test input',
+    'This is a test',
     expected: nil
   )
   puts "✅ Length evaluator: #{result}"
@@ -130,22 +131,21 @@ begin
   # Contains evaluator
   contains = Langfuse::Evaluators::ContainsEvaluator.new
   result = contains.evaluate(
-    "Find Ruby",
-    "Ruby programming language",
-    expected: "Ruby"
+    'Find Ruby',
+    'Ruby programming language',
+    expected: 'Ruby'
   )
   puts "✅ Contains evaluator: #{result}"
 
   # Regex evaluator
   regex = Langfuse::Evaluators::RegexEvaluator.new(pattern: /\d+/)
   result = regex.evaluate(
-    "Find numbers",
-    "There are 42 apples",
+    'Find numbers',
+    'There are 42 apples',
     expected: nil
   )
   puts "✅ Regex evaluator: #{result}"
-
-rescue => e
+rescue StandardError => e
   puts "❌ Evaluator failed: #{e.message}"
 end
 
@@ -156,16 +156,16 @@ begin
   timestamp = Langfuse::Utils.current_timestamp
 
   # Test data transformation
-  hash_data = { "key1" => "value1", "nested" => { "key2" => "value2" } }
+  hash_data = { 'key1' => 'value1', 'nested' => { 'key2' => 'value2' } }
   symbolized = Langfuse::Utils.deep_symbolize_keys(hash_data)
   stringified = Langfuse::Utils.deep_stringify_keys(symbolized)
 
-  puts "✅ Utils successful"
+  puts '✅ Utils successful'
   puts "   ID: #{id[0..8]}..."
   puts "   Timestamp: #{timestamp}"
   puts "   Symbolized keys: #{symbolized.keys}"
   puts "   Stringified keys: #{stringified.keys}"
-rescue => e
+rescue StandardError => e
   puts "❌ Utils failed: #{e.message}"
 end
 
@@ -177,26 +177,26 @@ begin
   # Add some events
   client.score(
     trace_id: trace.id,
-    name: "test-score",
+    name: 'test-score',
     value: 0.9
   )
 
   trace.score(
-    name: "trace-score",
+    name: 'trace-score',
     value: 0.8
   )
 
   generation.score(
-    name: "generation-score",
+    name: 'generation-score',
     value: 0.95
   )
 
   queue_size_after = client.instance_variable_get(:@event_queue).length
 
-  puts "✅ Event queue successful"
+  puts '✅ Event queue successful'
   puts "   Events added: #{queue_size_after - queue_size_before}"
   puts "   Total events: #{queue_size_after}"
-rescue => e
+rescue StandardError => e
   puts "❌ Event queue failed: #{e.message}"
 end
 
@@ -205,28 +205,28 @@ puts "\n10. Testing complex workflow..."
 begin
   # Create a complex trace with nested spans
   complex_trace = client.trace(
-    name: "complex-workflow",
-    user_id: "user-456",
-    session_id: "session-789",
-    input: { query: "Explain quantum computing" },
+    name: 'complex-workflow',
+    user_id: 'user-456',
+    session_id: 'session-789',
+    input: { query: 'Explain quantum computing' },
     metadata: {
-      environment: "test",
-      version: "1.0.0",
-      tags: ["physics", "computing"]
+      environment: 'test',
+      version: '1.0.0',
+      tags: %w[physics computing]
     }
   )
 
   # Document retrieval span
   retrieval_span = complex_trace.span(
-    name: "document-retrieval",
-    input: { query: "quantum computing basics" }
+    name: 'document-retrieval',
+    input: { query: 'quantum computing basics' }
   )
 
   # Embedding generation
   embedding_gen = retrieval_span.generation(
-    name: "embedding-generation",
-    model: "text-embedding-ada-002",
-    input: "quantum computing basics",
+    name: 'embedding-generation',
+    model: 'text-embedding-ada-002',
+    input: 'quantum computing basics',
     output: Array.new(1536) { rand(-1.0..1.0) }, # Mock embedding
     usage: { prompt_tokens: 4, total_tokens: 4 }
   )
@@ -234,31 +234,31 @@ begin
   retrieval_span.end(
     output: {
       documents: [
-        "Quantum computing uses quantum bits...",
-        "Quantum algorithms can solve certain problems..."
+        'Quantum computing uses quantum bits...',
+        'Quantum algorithms can solve certain problems...'
       ]
     }
   )
 
   # Answer generation span
   answer_span = complex_trace.span(
-    name: "answer-generation",
+    name: 'answer-generation',
     input: {
-      query: "Explain quantum computing",
-      context: ["Quantum computing uses quantum bits...", "Quantum algorithms can solve certain problems..."]
+      query: 'Explain quantum computing',
+      context: ['Quantum computing uses quantum bits...', 'Quantum algorithms can solve certain problems...']
     }
   )
 
   # LLM generation
   llm_gen = answer_span.generation(
-    name: "openai-completion",
-    model: "gpt-4",
+    name: 'openai-completion',
+    model: 'gpt-4',
     input: [
-      { role: "system", content: "You are a physics expert." },
-      { role: "user", content: "Explain quantum computing based on the context." }
+      { role: 'system', content: 'You are a physics expert.' },
+      { role: 'user', content: 'Explain quantum computing based on the context.' }
     ],
     output: {
-      content: "Quantum computing is a revolutionary approach to computation that leverages quantum mechanical phenomena like superposition and entanglement to process information in fundamentally different ways than classical computers."
+      content: 'Quantum computing is a revolutionary approach to computation that leverages quantum mechanical phenomena like superposition and entanglement to process information in fundamentally different ways than classical computers.'
     },
     usage: {
       prompt_tokens: 120,
@@ -273,22 +273,15 @@ begin
 
   answer_span.end(
     output: {
-      answer: "Quantum computing is a revolutionary approach to computation that leverages quantum mechanical phenomena like superposition and entanglement to process information in fundamentally different ways than classical computers."
+      answer: 'Quantum computing is a revolutionary approach to computation that leverages quantum mechanical phenomena like superposition and entanglement to process information in fundamentally different ways than classical computers.'
     }
   )
 
-  complex_trace.update(
-    output: {
-      answer: "Quantum computing is a revolutionary approach to computation that leverages quantum mechanical phenomena like superposition and entanglement to process information in fundamentally different ways than classical computers."
-    }
-  )
-
-  puts "✅ Complex workflow successful"
+  puts '✅ Complex workflow successful'
   puts "   Trace ID: #{complex_trace.id}"
-  puts "   Spans created: 2"
-  puts "   Generations created: 2"
-
-rescue => e
+  puts '   Spans created: 2'
+  puts '   Generations created: 2'
+rescue StandardError => e
   puts "❌ Complex workflow failed: #{e.message}"
 end
 
@@ -297,33 +290,32 @@ puts "\n11. Testing error handling..."
 begin
   # Test validation error
   begin
-    Langfuse::Utils.validate_required_fields({ name: "test" }, [:name, :required_field])
+    Langfuse::Utils.validate_required_fields({ name: 'test' }, %i[name required_field])
   rescue Langfuse::ValidationError => e
     puts "✅ Validation error caught: #{e.message}"
   end
 
   # Test authentication error
   begin
-    Langfuse.new(public_key: nil, secret_key: "secret")
+    Langfuse.new(public_key: nil, secret_key: 'secret')
   rescue Langfuse::AuthenticationError => e
     puts "✅ Authentication error caught: #{e.message}"
   end
-
-rescue => e
+rescue StandardError => e
   puts "❌ Error handling failed: #{e.message}"
 end
 
 # Final summary
 puts "\n🎉 All offline tests completed successfully!"
-puts "   The Langfuse Ruby SDK is ready for use!"
+puts '   The Langfuse Ruby SDK is ready for use!'
 puts "   Total events in queue: #{client.instance_variable_get(:@event_queue).length}"
 
 # Clean shutdown (kill background thread)
 client.instance_variable_get(:@flush_thread)&.kill
-puts "   Background thread terminated"
+puts '   Background thread terminated'
 
 puts "\n📚 Next steps:"
-puts "   1. Set your real Langfuse API keys"
-puts "   2. Configure the correct host URL"
-puts "   3. Start using the SDK in your application"
-puts "   4. Check the examples/ directory for more usage patterns"
+puts '   1. Set your real Langfuse API keys'
+puts '   2. Configure the correct host URL'
+puts '   3. Start using the SDK in your application'
+puts '   4. Check the examples/ directory for more usage patterns'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: langfuse-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Richard Sun
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-12 00:00:00.000000000 Z
+date: 2025-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -172,7 +172,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/ci.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
 - CHANGELOG.md
@@ -185,14 +184,18 @@ files:
 - docs/PUBLISH_GUIDE.md
 - docs/README.md
 - docs/RELEASE_CHECKLIST.md
+- docs/TYPE_VALIDATION_TROUBLESHOOTING.md
+- examples/auto_flush_control.rb
 - examples/basic_tracing.rb
 - examples/connection_config_demo.rb
+- examples/event_usage.rb
 - examples/prompt_management.rb
 - langfuse-ruby.gemspec
 - lib/langfuse.rb
 - lib/langfuse/client.rb
 - lib/langfuse/errors.rb
 - lib/langfuse/evaluation.rb
+- lib/langfuse/event.rb
 - lib/langfuse/generation.rb
 - lib/langfuse/prompt.rb
 - lib/langfuse/span.rb

data/.github/workflows/ci.yml

@@ -1,47 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        ruby-version: ['2.7', '3.0', '3.1', '3.2']
-
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Set up Ruby ${{ matrix.ruby-version }}
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-        bundler-cache: true
-    
-    - name: Run tests
-      run: bundle exec rspec
-    
-    - name: Run offline tests
-      run: ruby test_offline.rb
-    
-    - name: Check gem build
-      run: gem build langfuse.gemspec
-
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: '3.2'
-        bundler-cache: true
-    
-    - name: Run RuboCop
-      run: bundle exec rubocop
-      continue-on-error: true