langfuse-ruby 0.1.0

data/lib/langfuse/utils.rb

@@ -0,0 +1,41 @@
+require 'securerandom'
+require 'time'
+
+module Langfuse
+  module Utils
+    class << self
+      def generate_id
+        SecureRandom.uuid
+      end
+
+      def current_timestamp
+        Time.now.utc.iso8601(3)
+      end
+
+      def deep_symbolize_keys(hash)
+        return hash unless hash.is_a?(Hash)
+
+        hash.each_with_object({}) do |(key, value), result|
+          new_key = key.is_a?(String) ? key.to_sym : key
+          new_value = value.is_a?(Hash) ? deep_symbolize_keys(value) : value
+          result[new_key] = new_value
+        end
+      end
+
+      def deep_stringify_keys(hash)
+        return hash unless hash.is_a?(Hash)
+
+        hash.each_with_object({}) do |(key, value), result|
+          new_key = key.to_s
+          new_value = value.is_a?(Hash) ? deep_stringify_keys(value) : value
+          result[new_key] = new_value
+        end
+      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?
+      end
+    end
+  end
+end

data/lib/langfuse/version.rb

@@ -0,0 +1,3 @@
+module Langfuse
+  VERSION = "0.1.0"
+end

data/lib/langfuse.rb

@@ -0,0 +1,40 @@
+require_relative "langfuse/version"
+require_relative "langfuse/client"
+require_relative "langfuse/trace"
+require_relative "langfuse/span"
+require_relative "langfuse/generation"
+require_relative "langfuse/prompt"
+require_relative "langfuse/evaluation"
+require_relative "langfuse/errors"
+require_relative "langfuse/utils"
+
+module Langfuse
+  class << self
+    # Configure the Langfuse client with default settings
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Create a new Langfuse client instance
+    def new(**options)
+      Client.new(**options)
+    end
+  end
+
+  class Configuration
+    attr_accessor :public_key, :secret_key, :host, :debug, :timeout, :retries
+
+    def initialize
+      @public_key = nil
+      @secret_key = nil
+      @host = "https://cloud.langfuse.com"
+      @debug = false
+      @timeout = 30
+      @retries = 3
+    end
+  end
+end

data/scripts/release.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+
+# Langfuse Ruby SDK Release Script
+set -e
+
+echo "🚀 Starting Langfuse Ruby SDK release process..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+print_status() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# Check if we're in a git repository
+if [ ! -d ".git" ]; then
+    print_error "This is not a git repository. Please run 'git init' first."
+    exit 1
+fi
+
+# Get current version
+CURRENT_VERSION=$(ruby -r ./lib/langfuse/version.rb -e "puts Langfuse::VERSION")
+print_status "Current version: $CURRENT_VERSION"
+
+# Check if there are uncommitted changes
+if [ -n "$(git status --porcelain)" ]; then
+    print_warning "You have uncommitted changes. Please commit or stash them first."
+    git status --short
+    exit 1
+fi
+
+# Run tests
+print_status "Running tests..."
+if ! bundle exec rspec; then
+    print_error "Tests failed. Please fix them before releasing."
+    exit 1
+fi
+
+print_status "Running offline tests..."
+if ! ruby test_offline.rb; then
+    print_error "Offline tests failed. Please fix them before releasing."
+    exit 1
+fi
+
+# Build gem
+print_status "Building gem..."
+if ! gem build langfuse.gemspec; then
+    print_error "Gem build failed."
+    exit 1
+fi
+
+# Check if gem was built successfully
+if [ ! -f "langfuse-${CURRENT_VERSION}.gem" ]; then
+    print_error "Gem file not found: langfuse-${CURRENT_VERSION}.gem"
+    exit 1
+fi
+
+print_status "Gem built successfully: langfuse-${CURRENT_VERSION}.gem"
+
+# Ask for confirmation
+echo
+echo "📋 Release Summary:"
+echo "  Version: $CURRENT_VERSION"
+echo "  Gem file: langfuse-${CURRENT_VERSION}.gem"
+echo "  Tests: ✅ Passed"
+echo
+
+read -p "Do you want to proceed with the release? (y/N): " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    print_warning "Release cancelled."
+    rm -f "langfuse-${CURRENT_VERSION}.gem"
+    exit 0
+fi
+
+# Create git tag
+print_status "Creating git tag v${CURRENT_VERSION}..."
+git tag "v${CURRENT_VERSION}"
+
+# Push to git
+print_status "Pushing to git..."
+git push origin main
+git push origin "v${CURRENT_VERSION}"
+
+# Publish to RubyGems
+print_status "Publishing to RubyGems..."
+if gem push "langfuse-${CURRENT_VERSION}.gem"; then
+    print_status "Successfully published to RubyGems!"
+else
+    print_error "Failed to publish to RubyGems."
+    print_warning "You may need to run 'gem signin' first."
+    exit 1
+fi
+
+# Clean up
+rm -f "langfuse-${CURRENT_VERSION}.gem"
+
+print_status "Release completed successfully! 🎉"
+echo
+echo "📝 Next steps:"
+echo "  1. Check https://rubygems.org/gems/langfuse"
+echo "  2. Update documentation if needed"
+echo "  3. Announce the release"
+echo
+echo "🔗 Useful links:"
+echo "  - RubyGems: https://rubygems.org/gems/langfuse"
+echo "  - GitHub: https://github.com/your-username/langfuse-ruby"
+echo "  - Documentation: https://github.com/your-username/langfuse-ruby#readme" 

data/scripts/verify_release.rb

@@ -0,0 +1,139 @@
+#!/usr/bin/env ruby
+
+# Langfuse Ruby SDK Release Verification Script
+require 'net/http'
+require 'json'
+require 'uri'
+
+puts '🔍 Verifying Langfuse Ruby SDK release...'
+
+# Get current version
+require_relative '../lib/langfuse/version'
+current_version = Langfuse::VERSION
+
+puts "📦 Current version: #{current_version}"
+
+# Check if gem is available on RubyGems
+def check_rubygems(gem_name, version)
+  uri = URI("https://rubygems.org/api/v1/gems/#{gem_name}.json")
+
+  begin
+    response = Net::HTTP.get_response(uri)
+
+    if response.code == '200'
+      data = JSON.parse(response.body)
+      puts '✅ Gem found on RubyGems:'
+      puts "   Name: #{data['name']}"
+      puts "   Version: #{data['version']}"
+      puts "   Downloads: #{data['downloads']}"
+      puts "   Authors: #{data['authors']}"
+      puts "   Homepage: #{data['homepage_uri']}"
+      puts "   Source: #{data['source_code_uri']}"
+
+      if data['version'] == version
+        puts '✅ Version matches current version'
+      else
+        puts "⚠️  Version mismatch: Expected #{version}, found #{data['version']}"
+      end
+
+      true
+    else
+      puts "❌ Gem not found on RubyGems (HTTP #{response.code})"
+      false
+    end
+  rescue StandardError => e
+    puts "❌ Error checking RubyGems: #{e.message}"
+    false
+  end
+end
+
+# Check if specific version is available
+def check_version_availability(gem_name, version)
+  uri = URI("https://rubygems.org/api/v1/versions/#{gem_name}.json")
+
+  begin
+    response = Net::HTTP.get_response(uri)
+
+    if response.code == '200'
+      versions = JSON.parse(response.body)
+      version_found = versions.any? { |v| v['number'] == version }
+
+      if version_found
+        puts "✅ Version #{version} is available on RubyGems"
+        true
+      else
+        puts "❌ Version #{version} not found on RubyGems"
+        puts "   Available versions: #{versions.map { |v| v['number'] }.join(', ')}"
+        false
+      end
+    else
+      puts "❌ Could not fetch version list (HTTP #{response.code})"
+      false
+    end
+  rescue StandardError => e
+    puts "❌ Error checking version availability: #{e.message}"
+    false
+  end
+end
+
+# Run checks
+puts "\n🔍 Checking RubyGems availability..."
+gem_available = check_rubygems('langfuse', current_version)
+
+puts "\n🔍 Checking version availability..."
+version_available = check_version_availability('langfuse', current_version)
+
+# Test local installation
+puts "\n🔍 Testing local gem functionality..."
+begin
+  require_relative '../lib/langfuse'
+
+  # Test basic functionality
+  puts '✅ Langfuse module loaded successfully'
+  puts "   Version: #{Langfuse::VERSION}"
+
+  # Test client creation (without real credentials)
+  begin
+    client = Langfuse.new(public_key: 'test', secret_key: 'test')
+    puts '✅ Client creation successful'
+  rescue Langfuse::AuthenticationError
+    puts '✅ Authentication error expected (no real credentials)'
+  rescue StandardError => e
+    puts "❌ Unexpected error creating client: #{e.message}"
+  end
+
+  # Test configuration
+  Langfuse.configure do |config|
+    config.public_key = 'test'
+    config.secret_key = 'test'
+  end
+  puts '✅ Configuration successful'
+
+  # Test utilities
+  id = Langfuse::Utils.generate_id
+  timestamp = Langfuse::Utils.current_timestamp
+  puts "✅ Utilities working (ID: #{id[0..7]}..., Timestamp: #{timestamp})"
+rescue StandardError => e
+  puts "❌ Error testing local functionality: #{e.message}"
+end
+
+# Summary
+puts "\n📊 Verification Summary:"
+puts "   Gem available on RubyGems: #{gem_available ? '✅' : '❌'}"
+puts "   Version available: #{version_available ? '✅' : '❌'}"
+puts '   Local functionality: ✅'
+
+if gem_available && version_available
+  puts "\n🎉 Release verification successful!"
+  puts '   Your gem is ready for use!'
+  puts "\n📝 Installation command:"
+  puts '   gem install langfuse-ruby'
+else
+  puts "\n⚠️  Release verification incomplete"
+  puts '   Please check the issues above'
+end
+
+puts "\n🔗 Useful links:"
+puts '   - RubyGems page: https://rubygems.org/gems/langfuse'
+puts '   - Documentation: https://github.com/your-username/langfuse-ruby'
+puts '   - Issues: https://github.com/your-username/langfuse-ruby/issues'

data/test_basic.rb

@@ -0,0 +1,183 @@
+#!/usr/bin/env ruby
+
+require_relative 'lib/langfuse'
+
+puts "🚀 Testing Langfuse Ruby SDK..."
+
+# 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 = true
+end
+
+puts "✅ Configuration successful"
+puts "   Public key: #{Langfuse.configuration.public_key}"
+puts "   Host: #{Langfuse.configuration.host}"
+
+# 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"
+  )
+  puts "✅ Client initialization successful"
+  puts "   Client class: #{client.class}"
+  puts "   Public key: #{client.public_key}"
+rescue => e
+  puts "❌ Client initialization failed: #{e.message}"
+end
+
+# Test 3: Trace creation
+puts "\n3. Testing trace creation..."
+begin
+  trace = client.trace(
+    name: "test-trace",
+    user_id: "test-user",
+    input: { message: "Hello, world!" }
+  )
+  puts "✅ Trace creation successful"
+  puts "   Trace ID: #{trace.id}"
+  puts "   Trace name: #{trace.name}"
+rescue => e
+  puts "❌ Trace creation failed: #{e.message}"
+end
+
+# Test 4: Generation creation
+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!" }
+  )
+  puts "✅ Generation creation successful"
+  puts "   Generation ID: #{generation.id}"
+  puts "   Model: #{generation.model}"
+rescue => e
+  puts "❌ Generation creation failed: #{e.message}"
+end
+
+# Test 5: Span creation
+puts "\n5. Testing span creation..."
+begin
+  span = trace.span(
+    name: "test-span",
+    input: { query: "test query" }
+  )
+  puts "✅ Span creation successful"
+  puts "   Span ID: #{span.id}"
+  puts "   Span name: #{span.name}"
+rescue => e
+  puts "❌ Span creation failed: #{e.message}"
+end
+
+# Test 6: Prompt template
+puts "\n6. Testing prompt template..."
+begin
+  template = Langfuse::PromptTemplate.from_template(
+    "Hello {{name}}! How are you feeling {{mood}} today?"
+  )
+
+  formatted = template.format(
+    name: "Alice",
+    mood: "happy"
+  )
+
+  puts "✅ Prompt template successful"
+  puts "   Template variables: #{template.input_variables}"
+  puts "   Formatted: #{formatted}"
+rescue => e
+  puts "❌ Prompt template failed: #{e.message}"
+end
+
+# Test 7: Chat prompt template
+puts "\n7. 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}}" }
+  ])
+
+  messages = chat_template.format(
+    role: "coding",
+    user_input: "Help me with Ruby"
+  )
+
+  puts "✅ Chat prompt template successful"
+  puts "   Template variables: #{chat_template.input_variables}"
+  puts "   Messages count: #{messages.length}"
+rescue => e
+  puts "❌ Chat prompt template failed: #{e.message}"
+end
+
+# Test 8: Evaluators
+puts "\n8. Testing evaluators..."
+begin
+  # Exact match evaluator
+  exact_match = Langfuse::Evaluators::ExactMatchEvaluator.new
+  result = exact_match.evaluate(
+    input: "What is 2+2?",
+    output: "4",
+    expected: "4"
+  )
+  puts "✅ Exact match evaluator successful"
+  puts "   Result: #{result}"
+
+  # Similarity evaluator
+  similarity = Langfuse::Evaluators::SimilarityEvaluator.new
+  result = similarity.evaluate(
+    input: "What is AI?",
+    output: "Artificial Intelligence",
+    expected: "AI is artificial intelligence"
+  )
+  puts "✅ Similarity evaluator successful"
+  puts "   Result: #{result}"
+rescue => e
+  puts "❌ Evaluator failed: #{e.message}"
+end
+
+# Test 9: Utils
+puts "\n9. Testing utilities..."
+begin
+  id = Langfuse::Utils.generate_id
+  timestamp = Langfuse::Utils.current_timestamp
+
+  puts "✅ Utils successful"
+  puts "   Generated ID: #{id}"
+  puts "   Timestamp: #{timestamp}"
+rescue => e
+  puts "❌ Utils failed: #{e.message}"
+end
+
+# Test 10: Event queue
+puts "\n10. Testing event queue..."
+begin
+  queue_size_before = client.instance_variable_get(:@event_queue).length
+
+  client.score(
+    trace_id: trace.id,
+    name: "test-score",
+    value: 0.9
+  )
+
+  queue_size_after = client.instance_variable_get(:@event_queue).length
+
+  puts "✅ Event queue successful"
+  puts "   Queue size before: #{queue_size_before}"
+  puts "   Queue size after: #{queue_size_after}"
+rescue => e
+  puts "❌ Event queue failed: #{e.message}"
+end
+
+puts "\n🎉 All tests completed!"
+puts "   This SDK is ready for use with Langfuse!"
+puts "   Remember to set your real API keys when using in production."
+
+# Clean shutdown
+client.shutdown