langfuse-ruby 0.1.2 → 0.1.4

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,57 +273,75 @@ 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."
-    }
-  )
-
-  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."
+      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
 
 # Test 11: Error handling
 puts "\n11. Testing error handling..."
 begin
-  # Test validation error
+  # Save current configuration
+  original_public_key = Langfuse.configuration.public_key
+  original_secret_key = Langfuse.configuration.secret_key
+
+  # Test authentication error - missing public key
   begin
-    Langfuse::Utils.validate_required_fields({ name: "test" }, [:name, :required_field])
-  rescue Langfuse::ValidationError => e
-    puts "✅ Validation error caught: #{e.message}"
+    Langfuse.configuration.public_key = nil
+    ENV.delete('LANGFUSE_PUBLIC_KEY')
+    Langfuse.new(public_key: nil, secret_key: 'secret')
+    puts '❌ Expected AuthenticationError but none was raised'
+  rescue Langfuse::AuthenticationError => e
+    puts "✅ Authentication error caught: #{e.message}"
+  ensure
+    Langfuse.configuration.public_key = original_public_key
   end
 
-  # Test authentication error
+  # Test authentication error - missing secret key
   begin
-    Langfuse.new(public_key: nil, secret_key: "secret")
+    Langfuse.configuration.secret_key = nil
+    ENV.delete('LANGFUSE_SECRET_KEY')
+    Langfuse.new(public_key: 'public', secret_key: nil)
+    puts '❌ Expected AuthenticationError but none was raised'
   rescue Langfuse::AuthenticationError => e
     puts "✅ Authentication error caught: #{e.message}"
+  ensure
+    Langfuse.configuration.secret_key = original_secret_key
+  end
+
+  # Test validation error through prompt template
+  begin
+    template = Langfuse::PromptTemplate.from_template('Hello {{name}}!')
+    # This should work fine
+    result = template.format(name: 'World')
+    puts "✅ Prompt template validation passed: #{result}"
+  rescue Langfuse::ValidationError => e
+    puts "✅ Validation error caught: #{e.message}"
   end
 
-rescue => e
+  puts '✅ Error handling tests completed'
+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.4
 platform: ruby
 authors:
 - Richard Sun
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-12 00:00:00.000000000 Z
+date: 2025-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -28,30 +28,42 @@ dependencies:
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: faraday-net_http
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -185,14 +197,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