expressir 2.1.30 → 2.1.31

data/examples/ler_cli.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example: Using LER via CLI commands
+# This script demonstrates CLI usage for package operations
+
+PACKAGE_FILE = File.expand_path("ler/simple_example.ler", __dir__)
+
+unless File.exist?(PACKAGE_FILE)
+  puts "Error: Package not found: #{PACKAGE_FILE}"
+  puts "Run 'ruby examples/ler_build.rb' first to create the package."
+  exit 1
+end
+
+puts "LER CLI Commands Example"
+puts "=" * 60
+puts
+
+# Example 1: Package info
+puts "Example 1: Display package information"
+puts "-" * 60
+puts "Command: expressir package info #{PACKAGE_FILE}"
+puts
+system("bundle exec expressir package info #{PACKAGE_FILE}")
+puts
+
+# Example 2: Find entity
+puts "\nExample 2: Find specific entity"
+puts "-" * 60
+puts "Command: expressir entity find \"simple_example.product\" --from #{PACKAGE_FILE}"
+puts
+system("bundle exec expressir entity find \"simple_example.product\" --from #{PACKAGE_FILE}")
+puts
+
+# Example 3: List entities
+puts "\nExample 3: List all entities"
+puts "-" * 60
+puts "Command: expressir entity list --from #{PACKAGE_FILE}"
+puts
+system("bundle exec expressir entity list --from #{PACKAGE_FILE}")
+puts
+
+# Example 4: Find type
+puts "\nExample 4: Find specific type"
+puts "-" * 60
+puts "Command: expressir type find \"simple_example.product_status\" --from #{PACKAGE_FILE}"
+puts
+system("bundle exec expressir type find \"simple_example.product_status\" --from #{PACKAGE_FILE}")
+puts
+
+# Example 5: List types by category
+puts "\nExample 5: List types by category"
+puts "-" * 60
+puts "Command: expressir type list --from #{PACKAGE_FILE} --category enumeration"
+puts
+system("bundle exec expressir type list --from #{PACKAGE_FILE} --category enumeration")
+puts
+
+# Example 6: Show statistics
+puts "\nExample 6: Show statistics"
+puts "-" * 60
+puts "Command: expressir stats show #{PACKAGE_FILE}"
+puts
+system("bundle exec expressir stats show #{PACKAGE_FILE}")
+puts
+
+puts "=" * 60
+puts "CLI examples complete!"
+puts
+puts "All commands available:"
+puts "  expressir package build ROOT_SCHEMA OUTPUT [options]"
+puts "  expressir package info PACKAGE [options]"
+puts "  expressir package validate PACKAGE [options]"
+puts "  expressir entity find QUALIFIED_NAME --from PACKAGE"
+puts "  expressir entity list --from PACKAGE [--schema NAME]"
+puts "  expressir type find QUALIFIED_NAME --from PACKAGE"
+puts "  expressir type list --from PACKAGE [--category TYPE]"
+puts "  expressir stats show PACKAGE [--format FORMAT]"
+puts

data/examples/ler_demo_complete.rb

@@ -0,0 +1,276 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Complete LER Demonstration
+# Shows package creation, searching, and querying with all advanced features
+
+require_relative "../lib/expressir"
+
+class LERDemo
+  SCHEMA_FILE = File.expand_path("ler/simple_schema.exp", __dir__)
+  PACKAGE_FILE = File.expand_path("ler/simple_example.ler", __dir__)
+
+  def run
+    print_header("LER Package Creation and Query Demonstration")
+
+    create_package
+    load_and_query_package
+    demonstrate_advanced_search
+    demonstrate_statistics
+    demonstrate_validation
+
+    print_header("Demo Complete!", "=")
+    puts "\nPackage saved at: #{PACKAGE_FILE}"
+    puts "You can now use CLI commands like:"
+    puts "  expressir package info #{PACKAGE_FILE}"
+    puts "  expressir package search #{PACKAGE_FILE} 'product'"
+    puts "  expressir package tree #{PACKAGE_FILE}"
+  end
+
+  private
+
+  def create_package
+    print_section("Step 1: Creating LER Package")
+
+    unless File.exist?(SCHEMA_FILE)
+      puts "Error: Schema file not found: #{SCHEMA_FILE}"
+      exit 1
+    end
+
+    # Use CLI to build package (recommended approach)
+    puts "Building LER package from: #{File.basename(SCHEMA_FILE)}"
+    puts "Output: #{File.basename(PACKAGE_FILE)}"
+
+    cmd = "bundle exec expressir package build #{SCHEMA_FILE} #{PACKAGE_FILE} " \
+          "--name 'Simple Product Management Schema' " \
+          "--version '1.0.0' " \
+          "--description 'Demonstrates LER features with product entities' " \
+          "--express-mode include_all " \
+          "--resolution-mode resolved " \
+          "--serialization-format yaml"
+
+    system(cmd, out: File::NULL, err: File::NULL)
+
+    unless File.exist?(PACKAGE_FILE)
+      puts "Error: Failed to create package"
+      exit 1
+    end
+
+    file_size = File.size(PACKAGE_FILE)
+    puts "  ✓ Package created: #{(file_size / 1024.0).round(2)} KB"
+  end
+
+  def load_and_query_package
+    print_section("Step 2: Loading and Basic Queries")
+
+    # Load package (force class load first)
+    puts "Loading package from: #{File.basename(PACKAGE_FILE)}"
+    require_relative "../lib/expressir/model/repository"
+    require_relative "../lib/expressir/package/reader"
+    @repo = Expressir::Package::Reader.load(PACKAGE_FILE)
+    require_relative "../lib/expressir/model/search_engine"
+    @search = Expressir::Model::SearchEngine.new(@repo)
+    puts "  ✓ Package loaded"
+
+    # Basic statistics
+    stats = @repo.statistics
+    puts "\nPackage contains:"
+    puts "  Schemas: #{stats[:total_schemas]}"
+    puts "  Entities: #{stats[:total_entities]}"
+    puts "  Types: #{stats[:total_types]}"
+
+    # List entities
+    puts "\nEntities:"
+    entities = @search.list(type: "entity")
+    entities.each do |e|
+      puts "  - #{e[:id]} (#{e[:schema]})"
+    end
+
+    # List types by category
+    puts "\nTypes by category:"
+    stats[:types_by_category].each do |category, count|
+      next if count.zero?
+
+      puts "  #{category}: #{count}"
+      types = @search.list(type: "type", category: category.to_s)
+      types.each do |t|
+        puts "    - #{t[:id]}"
+      end
+    end
+  end
+
+  def demonstrate_advanced_search
+    print_section("Step 3: Advanced Search Features (Phase 3)")
+
+    # Pattern matching
+    puts "1. Wildcard pattern search:"
+    results = @search.search(pattern: "product*", type: "entity")
+    puts "  Found #{results.size} entities starting with 'product':"
+    results.each { |r| puts "    - #{r[:path]}" }
+
+    # Depth filtering
+    puts "\n2. Depth-filtered search (max_depth: 2):"
+    results = @search.search_with_depth(pattern: "product", max_depth: 2)
+    puts "  Found #{results.size} results at depth ≤ 2:"
+    results.each do |r|
+      depth = r[:path]&.split(".")&.size || 0
+      puts "    - #{r[:path]} (depth: #{depth})"
+    end
+
+    # Relevance ranking
+    puts "\n3. Relevance-ranked search:"
+    results = @search.search_ranked(pattern: "product")
+    puts "  Results ranked by relevance:"
+    results.take(5).each do |r|
+      puts "    - #{r[:path]} (score: #{r[:relevance_score]})"
+    end
+
+    # Advanced combined search
+    puts "\n4. Advanced search (depth + ranking):"
+    results = @search.search_advanced(
+      pattern: "product",
+      max_depth: 2,
+      ranked: true,
+    )
+    puts "  Combined results:"
+    results.each do |r|
+      puts "    - #{r[:path]} (score: #{r[:relevance_score]})"
+    end
+
+    # Regex search
+    puts "\n5. Regex search:"
+    results = @search.search(
+      pattern: "^product_.*",
+      regex: true,
+    )
+    puts "  Regex matches: #{results.size} result(s)"
+    results.each { |r| puts "    - #{r[:id]}" }
+
+    # Exact match
+    puts "\n6. Exact match:"
+    results = @search.search(
+      pattern: "simple_example.product",
+      exact: true,
+    )
+    puts "  Exact matches: #{results.size} result(s)"
+  end
+
+  def demonstrate_statistics
+    print_section("Step 4: Repository Statistics (Phase 3)")
+
+    # Schema categorization
+    puts "1. Schemas by category:"
+    categories = @repo.schemas_by_category
+    categories.each do |category, schemas|
+      next if schemas.empty?
+
+      puts "  #{category}: #{schemas.size} schema(s)"
+      schemas.each { |s| puts "    - #{s.id}" }
+    end
+
+    # Largest schemas
+    puts "\n2. Largest schemas by element count:"
+    largest = @repo.largest_schemas(5)
+    largest.each do |item|
+      puts "  - #{item[:schema].id}: #{item[:total_elements]} elements"
+    end
+
+    # Schema complexity
+    puts "\n3. Schema complexity scores:"
+    complex = @repo.schemas_by_complexity(5)
+    complex.each do |item|
+      puts "  - #{item[:schema].id}: complexity #{item[:complexity]}"
+      schema = item[:schema]
+      details = []
+      details << "#{schema.entities&.size || 0} entities" if schema.entities&.any?
+      details << "#{schema.types&.size || 0} types" if schema.types&.any?
+      details << "#{schema.functions&.size || 0} functions" if schema.functions&.any?
+      puts "    (#{details.join(', ')})" unless details.empty?
+    end
+
+    # Dependency statistics
+    puts "\n4. Dependency statistics:"
+    deps = @repo.dependency_statistics
+    puts "  Total interfaces: #{deps[:total_interfaces]}"
+    puts "  USE FROM: #{deps[:use_from_count]}"
+    puts "  REFERENCE FROM: #{deps[:reference_from_count]}"
+
+    if deps[:most_referenced].any?
+      puts "  Most referenced schemas:"
+      deps[:most_referenced].take(3).each do |schema_id, count|
+        puts "    - #{schema_id}: #{count} references"
+      end
+    end
+  end
+
+  def demonstrate_validation
+    print_section("Step 5: Package Validation (Phase 2)")
+
+    # Basic validation
+    puts "1. Basic validation:"
+    validation = @repo.validate
+    if validation[:valid?]
+      puts "  ✓ Package is valid"
+    else
+      puts "  ✗ Validation failed:"
+      validation[:errors].each do |error|
+        puts "    - #{error[:message]}"
+      end
+    end
+
+    # Strict validation
+    puts "\n2. Strict validation (with completeness checks):"
+    validation = @repo.validate(
+      strict: true,
+      check_completeness: true,
+    )
+
+    if validation[:valid?]
+      puts "  ✓ Package passes strict validation"
+    end
+
+    if validation[:warnings]&.any?
+      puts "  Warnings (#{validation[:warnings].size}):"
+      validation[:warnings].take(3).each do |warning|
+        puts "    - #{warning[:message]}"
+      end
+    end
+
+    # Enhanced validation
+    puts "\n3. Enhanced validation (all checks):"
+    validation = @repo.validate(
+      strict: true,
+      check_interfaces: true,
+      check_completeness: true,
+      check_duplicates: true,
+      detailed: false,
+    )
+
+    puts "  Validation result: #{validation[:valid?] ? '✓ Valid' : '✗ Invalid'}"
+    puts "  Errors: #{validation[:errors]&.size || 0}"
+    puts "  Warnings: #{validation[:warnings]&.size || 0}"
+  end
+
+  def print_header(text, char = "=")
+    line = char * 70
+    puts "\n#{line}"
+    puts text.center(70)
+    puts "#{line}\n"
+  end
+
+  def print_section(title)
+    puts "\n#{title}"
+    puts "-" * 70
+  end
+end
+
+# Run demo
+if __FILE__ == $PROGRAM_NAME
+  begin
+    LERDemo.new.run
+  rescue StandardError => e
+    puts "\nError: #{e.message}"
+    puts e.backtrace.first(5)
+    exit 1
+  end
+end

data/examples/ler_query.rb

@@ -0,0 +1,91 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example: Query LER package for entities and types
+# This script demonstrates querying an existing LER package
+
+require_relative "../lib/expressir"
+
+PACKAGE_FILE = File.expand_path("ler/simple_example.ler", __dir__)
+
+unless File.exist?(PACKAGE_FILE)
+  puts "Error: Package not found: #{PACKAGE_FILE}"
+  puts "Run 'ruby examples/ler_build.rb' first to create the package."
+  exit 1
+end
+
+puts "LER Package Query Example"
+puts "=" * 60
+puts "Package: #{File.basename(PACKAGE_FILE)}"
+puts
+
+# Load package
+puts "Loading package..."
+start_time = Time.now
+repo = Expressir::Model::Repository.from_package(PACKAGE_FILE)
+load_time = ((Time.now - start_time) * 1000).round(2)
+puts "  ✓ Loaded in #{load_time}ms"
+puts
+
+# Query 1: Find specific entity
+puts "Query 1: Find entity 'simple_example.product'"
+puts "-" * 60
+entity = repo.find_entity(qualified_name: "simple_example.product")
+if entity
+  puts "  ✓ Found: #{entity.id}"
+  puts "  Schema: #{entity.parent.id}"
+  puts "  Path: #{entity.path}"
+  if entity.attributes&.any?
+    puts "  Attributes:"
+    entity.attributes.each do |attr|
+      puts "    - #{attr.id}"
+    end
+  end
+else
+  puts "  ✗ Not found"
+end
+puts
+
+# Query 2: List all entities
+puts "Query 2: List all entities"
+puts "-" * 60
+entities = repo.list_entities(format: :hash)
+puts "  Total entities: #{entities.size}"
+entities.each do |e|
+  puts "    #{e[:schema]}.#{e[:id]}"
+end
+puts
+
+# Query 3: Find specific type
+puts "Query 3: Find type 'simple_example.product_status'"
+puts "-" * 60
+type = repo.find_type(qualified_name: "simple_example.product_status")
+if type
+  puts "  ✓ Found: #{type.id}"
+  puts "  Schema: #{type.parent.id}"
+end
+puts
+
+# Query 4: List types by category
+puts "Query 4: List SELECT types"
+puts "-" * 60
+select_types = repo.list_types(category: "select", format: :hash)
+puts "  Total SELECT types: #{select_types.size}"
+select_types.each do |t|
+  puts "    #{t[:schema]}.#{t[:id]} [#{t[:category]}]"
+end
+puts
+
+# Query 5: List ENUMERATION types
+puts "Query 5: List ENUMERATION types"
+puts "-" * 60
+enum_types = repo.list_types(category: "enumeration", format: :hash)
+puts "  Total ENUMERATION types: #{enum_types.size}"
+enum_types.each do |t|
+  puts "    #{t[:schema]}.#{t[:id]} [#{t[:category]}]"
+end
+puts
+
+puts "=" * 60
+puts "Query examples complete!"
+puts