class-metrix 0.1.2 → 1.0.1

data/examples/advanced/error_handling.rb

@@ -1,199 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../../lib/class_metrix"
-
-puts "=== Advanced Example: Error Handling ==="
-puts
-
-# Classes that demonstrate various error scenarios
-class WorkingService
-  # Working constants
-  SERVICE_NAME = "working"
-  VERSION = "1.0.0"
-  ENABLED = true
-
-  # Working methods
-  def self.status
-    "healthy"
-  end
-
-  def self.version
-    "1.0.0"
-  end
-
-  def self.health_check
-    { status: "ok", uptime: 12_345 }
-  end
-
-  def self.enabled?
-    true
-  end
-end
-
-class PartiallyBrokenService
-  # Working constants
-  SERVICE_NAME = "partially_broken"
-  VERSION = "0.9.0"
-  # Missing ENABLED constant
-
-  # Working methods
-  def self.status
-    "degraded"
-  end
-
-  def self.version
-    "0.9.0"
-  end
-
-  # Broken method that raises an error
-  def self.health_check
-    raise StandardError, "Health check failed!"
-  end
-
-  def self.enabled?
-    false
-  end
-
-  # Method that returns nil
-  def self.uptime
-    nil
-  end
-
-  # Method with complex error
-  def self.database_connection
-    raise ActiveRecord::ConnectionNotEstablished, "Database unavailable"
-  rescue NameError
-    # If ActiveRecord is not available, raise a different error
-    raise "Connection library not available"
-  end
-end
-
-class CompletelyBrokenService
-  # Has some constants
-  SERVICE_NAME = "broken"
-  # Missing VERSION and ENABLED
-
-  # Has working method
-  def self.status
-    "down"
-  end
-
-  # Missing version method
-
-  # Broken health_check
-  def self.health_check
-    raise NoMethodError, "Health monitoring not implemented"
-  end
-
-  # Method that raises during execution
-  def self.enabled?
-    some_undefined_variable.call
-  end
-
-  # Method that returns false
-  def self.deprecated?
-    true
-  end
-end
-
-puts "=== Service Classes Defined ==="
-puts "WorkingService: All methods work"
-puts "PartiallyBrokenService: Some methods fail"
-puts "CompletelyBrokenService: Most methods fail"
-puts
-
-# 1. Extract without error handling (will raise errors)
-puts "💥 1. WITHOUT ERROR HANDLING (This will show errors)"
-puts "-" * 60
-
-begin
-  result = ClassMetrix.extract(:class_methods)
-                      .from([WorkingService, PartiallyBrokenService])
-                      .filter(/health_check/)
-                      .to_markdown
-  puts result
-rescue StandardError => e
-  puts "❌ Error occurred: #{e.class.name}: #{e.message}"
-end
-puts
-
-# 2. Extract with error handling
-puts "🛡️ 2. WITH ERROR HANDLING (Graceful failure)"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 3. Constants with missing values
-puts "📋 3. CONSTANTS WITH MISSING VALUES"
-puts "-" * 60
-result = ClassMetrix.extract(:constants)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 4. Multi-type extraction with errors
-puts "📊 4. MULTI-TYPE WITH ERROR HANDLING"
-puts "-" * 60
-result = ClassMetrix.extract(:constants, :class_methods)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .filter(/SERVICE_NAME|status|enabled/)
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 5. Focus on problematic methods
-puts "🔍 5. PROBLEMATIC METHODS ANALYSIS"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .filter(/health_check|database|uptime/)
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 6. Boolean and nil value handling
-puts "✅ 6. BOOLEAN AND NIL VALUE HANDLING"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .filter(/enabled\?|deprecated\?|uptime/)
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 7. Save comprehensive error analysis report
-puts "💾 7. SAVING COMPREHENSIVE ERROR ANALYSIS REPORT"
-puts "-" * 60
-report = ClassMetrix.extract(:constants, :class_methods)
-                    .from([WorkingService, PartiallyBrokenService, CompletelyBrokenService])
-                    .handle_errors
-                    .to_markdown("error_analysis_report.md", title: "Service Health Analysis Report")
-
-puts "✅ Comprehensive error analysis saved to: error_analysis_report.md"
-puts "📊 Report contains #{report.lines.count} lines with rich metadata"
-puts
-
-puts "🛡️ Enhanced Error Handling Features Demonstrated:"
-puts "• 🚫 Missing constants: '🚫 Not defined'"
-puts "• 🚫 Missing methods: '🚫 No method'"
-puts "• ⚠️ Runtime errors: '⚠️ Error: [descriptive message]'"
-puts "• ❌ Boolean false and nil values: '❌'"
-puts "• ✅ Boolean true values: '✅'"
-puts "• 📊 Rich markdown reports with titles and metadata"
-puts "• 📋 Missing behaviors summary per class"
-puts "• 🛡️ handle_errors flag enables graceful degradation"

data/examples/advanced/hash_expansion.rb

@@ -1,180 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../../lib/class_metrix"
-
-puts "=== Advanced Example: Hash Expansion ==="
-puts
-
-# Configuration classes with complex hash structures
-class DatabaseConfig
-  # Hash constants
-  DEFAULT_CONFIG = {
-    host: "localhost",
-    port: 5432,
-    ssl: true,
-    pool_size: 5
-  }.freeze
-
-  CONNECTION_POOLS = {
-    read: { size: 10, timeout: 30 },
-    write: { size: 5, timeout: 15 },
-    admin: { size: 2, timeout: 60 }
-  }.freeze
-
-  # Hash methods
-  def self.production_config
-    {
-      host: "db.production.com",
-      port: 5432,
-      database: "myapp_production",
-      ssl: true,
-      pool_size: 20,
-      timeout: 30,
-      backup_enabled: true
-    }
-  end
-
-  def self.development_config
-    {
-      host: "localhost",
-      port: 5432,
-      database: "myapp_development",
-      ssl: false,
-      pool_size: 5,
-      timeout: 10
-    }
-  end
-
-  def self.simple_value
-    "not a hash"
-  end
-end
-
-class RedisConfig
-  # Hash constants
-  DEFAULT_CONFIG = {
-    host: "localhost",
-    port: 6379,
-    ssl: false,
-    timeout: 5
-  }.freeze
-
-  CLUSTER_CONFIG = {
-    nodes: 3,
-    replication: true,
-    failover: "auto"
-  }.freeze
-
-  # Hash methods
-  def self.production_config
-    {
-      host: "redis.internal",
-      port: 6379,
-      database: 0,
-      ssl: false,
-      max_connections: 100,
-      cluster_enabled: true
-    }
-  end
-
-  def self.development_config
-    {
-      host: "localhost",
-      port: 6379,
-      database: 1,
-      ssl: false,
-      max_connections: 10
-    }
-  end
-
-  def self.simple_value
-    42
-  end
-end
-
-puts "=== Configuration Classes Defined ==="
-puts "DatabaseConfig and RedisConfig with hash constants and methods"
-puts
-
-# 1. Normal output (without expansion)
-puts "📋 1. NORMAL OUTPUT (Hashes as inspect strings)"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([DatabaseConfig, RedisConfig])
-                    .filter(/config$/)
-                    .to_markdown
-
-puts result
-puts
-
-# 2. Expanded output
-puts "🔍 2. EXPANDED OUTPUT (Hash keys as sub-rows)"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([DatabaseConfig, RedisConfig])
-                    .filter(/config$/)
-                    .expand_hashes
-                    .to_markdown
-
-puts result
-puts
-
-# 3. Constants with expansion
-puts "📊 3. CONSTANTS WITH HASH EXPANSION"
-puts "-" * 60
-result = ClassMetrix.extract(:constants)
-                    .from([DatabaseConfig, RedisConfig])
-                    .filter(/CONFIG/)
-                    .expand_hashes
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 4. Mixed data types with expansion
-puts "🔧 4. MIXED DATA TYPES WITH EXPANSION"
-puts "-" * 60
-result = ClassMetrix.extract(:class_methods)
-                    .from([DatabaseConfig, RedisConfig])
-                    .expand_hashes
-                    .to_markdown
-
-puts result
-puts
-
-# 5. Multi-type extraction with expansion
-puts "🚀 5. MULTI-TYPE WITH HASH EXPANSION"
-puts "-" * 60
-result = ClassMetrix.extract(:constants, :class_methods)
-                    .from([DatabaseConfig, RedisConfig])
-                    .filter(/DEFAULT_CONFIG|production_config/)
-                    .expand_hashes
-                    .handle_errors
-                    .to_markdown
-
-puts result
-puts
-
-# 6. Save expanded report
-puts "💾 6. SAVING EXPANDED REPORT"
-puts "-" * 60
-report = ClassMetrix.extract(:constants, :class_methods)
-                    .from([DatabaseConfig, RedisConfig])
-                    .expand_hashes
-                    .handle_errors
-                    .to_markdown("config_analysis_expanded.md")
-
-puts "✅ Expanded report saved to: config_analysis_expanded.md"
-puts "📊 Report contains #{report.lines.count} lines"
-puts
-
-puts "✨ Hash Expansion Features Demonstrated:"
-puts "• 📋 Hash indicators show number of keys"
-puts "• └─ Sub-rows show individual key-value pairs"
-puts "• ❌ Missing keys shown clearly"
-puts "• — Non-hash values shown with dash"
-puts "• Mixed data types handled properly"
-puts "• Works with both constants and methods"
-puts "• Compatible with multi-type extraction"

data/examples/basic/01_simple_constants.rb

@@ -1,56 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../../lib/class_metrix"
-
-puts "=== Basic Example 1: Simple Constants ==="
-puts
-
-# Define some simple classes with constants
-class User
-  ROLE_NAME = "user"
-  MAX_LOGIN_ATTEMPTS = 3
-  ACCOUNT_TYPE = "standard"
-end
-
-class Admin
-  ROLE_NAME = "admin"
-  MAX_LOGIN_ATTEMPTS = 5
-  ACCOUNT_TYPE = "premium"
-  ADMIN_LEVEL = 10
-end
-
-class Guest
-  ROLE_NAME = "guest"
-  MAX_LOGIN_ATTEMPTS = 1
-  ACCOUNT_TYPE = "basic"
-end
-
-puts "Classes defined: User, Admin, Guest"
-puts "Constants: ROLE_NAME, MAX_LOGIN_ATTEMPTS, ACCOUNT_TYPE, ADMIN_LEVEL"
-puts
-
-# Extract all constants
-puts "📋 All Constants:"
-puts ClassMetrix.extract(:constants)
-                .from([User, Admin, Guest])
-                .to_markdown
-puts
-
-# Extract filtered constants
-puts "🔍 Filtered Constants (ROLE and MAX):"
-puts ClassMetrix.extract(:constants)
-                .from([User, Admin, Guest])
-                .filter(/ROLE|MAX/)
-                .to_markdown
-puts
-
-# Extract with regex filter
-puts "🎯 Regex Filter (starting with ACCOUNT):"
-puts ClassMetrix.extract(:constants)
-                .from([User, Admin, Guest])
-                .filter(/^ACCOUNT/)
-                .to_markdown
-puts
-
-puts "✨ This example shows basic constant extraction and filtering!"

data/examples/basic/02_simple_methods.rb

@@ -1,99 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../../lib/class_metrix"
-
-puts "=== Basic Example 2: Simple Class Methods ==="
-puts
-
-# Define some simple classes with class methods
-class PaymentProcessor
-  def self.supported_currencies
-    %w[USD EUR GBP]
-  end
-
-  def self.max_amount
-    10_000
-  end
-
-  def self.requires_verification?
-    false
-  end
-
-  def self.processing_fee
-    2.5
-  end
-end
-
-class StripeProcessor
-  def self.supported_currencies
-    %w[USD EUR GBP CAD AUD]
-  end
-
-  def self.max_amount
-    50_000
-  end
-
-  def self.requires_verification?
-    true
-  end
-
-  def self.processing_fee
-    2.9
-  end
-
-  def self.supports_recurring?
-    true
-  end
-end
-
-class PayPalProcessor
-  def self.supported_currencies
-    %w[USD EUR]
-  end
-
-  def self.max_amount
-    25_000
-  end
-
-  def self.requires_verification?
-    true
-  end
-
-  def self.processing_fee
-    3.4
-  end
-
-  def self.instant_transfer?
-    false
-  end
-end
-
-puts "Classes defined: PaymentProcessor, StripeProcessor, PayPalProcessor"
-puts "Methods: supported_currencies, max_amount, requires_verification?, processing_fee, etc."
-puts
-
-# Extract all class methods
-puts "📋 All Class Methods:"
-puts ClassMetrix.extract(:class_methods)
-                .from([PaymentProcessor, StripeProcessor, PayPalProcessor])
-                .to_markdown
-puts
-
-# Extract boolean methods only
-puts "✅ Boolean Methods (ending with ?):"
-puts ClassMetrix.extract(:class_methods)
-                .from([PaymentProcessor, StripeProcessor, PayPalProcessor])
-                .filter(/\?$/)
-                .to_markdown
-puts
-
-# Extract configuration methods
-puts "⚙️ Configuration Methods (max, fee, supported):"
-puts ClassMetrix.extract(:class_methods)
-                .from([PaymentProcessor, StripeProcessor, PayPalProcessor])
-                .filter(/max|fee|supported/)
-                .to_markdown
-puts
-
-puts "✨ This example shows class method extraction with different return types!"

data/examples/basic/03_multi_type_extraction.rb

@@ -1,116 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../../lib/class_metrix"
-
-puts "=== Basic Example 3: Multi-Type Extraction ==="
-puts
-
-# Define classes with both constants and methods
-class EmailService
-  # Constants
-  PROVIDER_NAME = "smtp"
-  DEFAULT_PORT = 587
-  ENCRYPTION_ENABLED = true
-
-  # Class methods
-  def self.provider_name
-    "SMTP Service"
-  end
-
-  def self.default_port
-    587
-  end
-
-  def self.encryption_enabled?
-    true
-  end
-
-  def self.rate_limit
-    100
-  end
-end
-
-class SendGridService
-  # Constants
-  PROVIDER_NAME = "sendgrid"
-  DEFAULT_PORT = 443
-  ENCRYPTION_ENABLED = true
-  API_VERSION = "v3"
-
-  # Class methods
-  def self.provider_name
-    "SendGrid API"
-  end
-
-  def self.default_port
-    443
-  end
-
-  def self.encryption_enabled?
-    true
-  end
-
-  def self.rate_limit
-    1000
-  end
-
-  def self.api_version
-    "v3"
-  end
-end
-
-class MailgunService
-  # Constants
-  PROVIDER_NAME = "mailgun"
-  DEFAULT_PORT = 443
-  ENCRYPTION_ENABLED = true
-
-  # Class methods
-  def self.provider_name
-    "Mailgun API"
-  end
-
-  def self.default_port
-    443
-  end
-
-  def self.encryption_enabled?
-    true
-  end
-
-  def self.rate_limit
-    500
-  end
-end
-
-puts "Classes defined: EmailService, SendGridService, MailgunService"
-puts "Each has constants AND class methods with similar names"
-puts
-
-# Compare constants vs methods
-puts "📊 Multi-Type Extraction (Constants + Methods):"
-puts ClassMetrix.extract(:constants, :class_methods)
-                .from([EmailService, SendGridService, MailgunService])
-                .filter(/provider_name|default_port|encryption/)
-                .to_markdown
-puts
-
-# Compare specific behaviors
-puts "🎯 Rate Limiting Comparison:"
-puts ClassMetrix.extract(:constants, :class_methods)
-                .from([EmailService, SendGridService, MailgunService])
-                .filter(/rate_limit/)
-                .to_markdown
-puts
-
-# API-specific features
-puts "🔌 API Features:"
-puts ClassMetrix.extract(:constants, :class_methods)
-                .from([EmailService, SendGridService, MailgunService])
-                .filter(/API|version/)
-                .to_markdown
-puts
-
-puts "✨ This example shows how to compare both constants and methods in one table!"
-puts "Notice how the 'Type' column distinguishes between constants and methods."