taski 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 537249ee49e056c8841cc1c4d4061eccf7be201b3690a197af8d5a5b65939173
-  data.tar.gz: f012517341ea31b2e36f4a87e51ab199cb24d70d7ba10519653a2d290c78dcaf
+  metadata.gz: afd6114f6d0814be687181ddd8e0acfa45af1d1064f14247e2864be53c3103f0
+  data.tar.gz: 5b76552b037943f8b9555f01eb6b98d5a515be95b8f75e63f6f42314cf388294
 SHA512:
-  metadata.gz: e15871fa35cf862eae794b823ab760adcd1ca1156cb23b0d27d705e8c5fb0ddfa3f2dd17859f7d238a6f0e9dbf558bedf5148330ffbf239a7291f3c99b037e07
-  data.tar.gz: d1ca33867403c337c2d1638acae3a2fd47ca77a707e7df2b6076d8c22c8d289ceae73ba6e4f1f30d413c784c30f999d60648a270c3b49a398e3144d85fd63837
+  metadata.gz: 6c37d3650e3a1af652e469bad4627964fa62763ad7acc93e54b07bdaa577777dda65f0e34265d7974209ab3b3ab5f5ef5299d4675f6a8810fcdcd5dcbad19306
+  data.tar.gz: f2d5295608ee67c5a2ecebdfb0416f73fe16569534a4f798252cf5bd101bec3c43507e1c0560be102cfb37c44fcdf603ff2a7cf9a6b0afdfb9b74c3624ff7553

data/README.md

@@ -162,27 +162,26 @@ RandomTask.reset!
 
 ### Progress Display
 
-Enable real-time progress visualization:
-
-```bash
-TASKI_FORCE_PROGRESS=1 ruby your_script.rb
-```
+Tree-based progress visualization is enabled by default:
 
 ```
-⠋ DatabaseSetup (running)
-⠙ CacheSetup (running)
-✅ DatabaseSetup (123.4ms)
-✅ CacheSetup (98.2ms)
+WebServer (Task)
+├── ⠋ Config (Task) ...
+│   ├── ✅ Database (Task) 45.2ms
+│   └── ⠙ Cache (Task) ...
+└── ◻ Server (Task)
 ```
 
+To disable: `TASKI_PROGRESS_DISABLE=1 ruby your_script.rb`
+
 ### Tree Visualization
 
 ```ruby
 puts WebServer.tree
-# => WebServer
-# => └── Config
-# =>     ├── Database
-# =>     └── Cache
+# WebServer (Task)
+# └── Config (Task)
+#     ├── Database (Task)
+#     └── Cache (Task)
 ```
 
 ## Development

data/Steepfile

@@ -13,6 +13,7 @@ target :lib do
   # Standard library dependencies
   library "monitor"
   library "tsort"
+  library "etc"
 
   # Use gems from rbs_collection
   collection_config "rbs_collection.yaml"

data/examples/README.md

@@ -87,7 +87,7 @@ ruby examples/data_pipeline_demo.rb
 Real-time progress visualization during parallel execution.
 
 ```bash
-TASKI_FORCE_PROGRESS=1 ruby examples/parallel_progress_demo.rb
+ruby examples/parallel_progress_demo.rb
 ```
 
 **Covers:**
@@ -114,8 +114,8 @@ TASKI_FORCE_PROGRESS=1 ruby examples/parallel_progress_demo.rb
 # Run each example
 for f in examples/*.rb; do echo "=== $f ===" && ruby "$f" && echo; done
 
-# With progress display (for parallel_progress_demo)
-TASKI_FORCE_PROGRESS=1 ruby examples/parallel_progress_demo.rb
+# Disable progress display if needed
+TASKI_PROGRESS_DISABLE=1 ruby examples/parallel_progress_demo.rb
 ```
 
 ## Next Steps

data/examples/data_pipeline_demo.rb

@@ -9,7 +9,7 @@
 # - Data transformation and aggregation
 #
 # Run: ruby examples/data_pipeline_demo.rb
-# With progress: TASKI_FORCE_PROGRESS=1 ruby examples/data_pipeline_demo.rb
+# Disable progress: TASKI_PROGRESS_DISABLE=1 ruby examples/data_pipeline_demo.rb
 
 require_relative "../lib/taski"
 
@@ -227,5 +227,5 @@ puts "\nKey concepts demonstrated:"
 puts "  - DataSourceSection: Switch between production/test data"
 puts "  - ReportFormatSection: Switch output format (text/JSON)"
 puts "  - Parallel execution of independent transforms"
-puts "\nTry with progress display:"
-puts "  TASKI_FORCE_PROGRESS=1 ruby examples/data_pipeline_demo.rb"
+puts "\nTo disable progress display:"
+puts "  TASKI_PROGRESS_DISABLE=1 ruby examples/data_pipeline_demo.rb"

data/examples/nested_section_demo.rb

@@ -0,0 +1,161 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/taski"
+
+# Demo for nested Sections (Section inside Section)
+# Run with: ruby examples/nested_section_demo.rb
+
+# Configuration loader task - determines which storage to use
+class StorageConfig < Taski::Task
+  exports :use_s3
+
+  def run
+    puts "Loading storage configuration..."
+    sleep(0.4)
+    puts "Checking cloud credentials..."
+    sleep(0.3)
+    puts "Validating storage policies..."
+    sleep(0.3)
+    # Simulate config loading - use local storage by default
+    @use_s3 = ENV["USE_S3"] == "1"
+  end
+end
+
+# Inner Section: Storage backend selection (depends on StorageConfig)
+class StorageSection < Taski::Section
+  interfaces :storage_client
+
+  def impl
+    # Use config task result to decide implementation
+    if StorageConfig.use_s3
+      S3Storage
+    else
+      LocalStorage
+    end
+  end
+
+  class S3Storage < Taski::Task
+    def run
+      puts "Connecting to S3..."
+      sleep(1.0)
+      @storage_client = "s3://bucket/data"
+    end
+  end
+
+  class LocalStorage < Taski::Task
+    def run
+      puts "Initializing local filesystem..."
+      sleep(0.5)
+      puts "Mounting volumes..."
+      sleep(0.5)
+      puts "Local storage ready"
+      sleep(0.3)
+      @storage_client = "/var/data"
+    end
+  end
+end
+
+# Database configuration loader - determines which database to use
+class DatabaseConfig < Taski::Task
+  exports :use_prod
+
+  def run
+    puts "Loading database configuration..."
+    sleep(0.3)
+    puts "Checking environment variables..."
+    sleep(0.3)
+    puts "Resolving database endpoints..."
+    sleep(0.4)
+    # Simulate config loading - use dev database by default
+    @use_prod = ENV["USE_PROD_DB"] == "1"
+  end
+end
+
+# Outer Section: Database selection (depends on Storage and DatabaseConfig)
+class DatabaseSection < Taski::Section
+  interfaces :connection_string
+
+  def impl
+    # Use config task result to decide implementation
+    if DatabaseConfig.use_prod
+      ProductionDB
+    else
+      DevelopmentDB
+    end
+  end
+
+  class ProductionDB < Taski::Task
+    def run
+      # Production DB also needs storage for backups
+      storage = StorageSection.storage_client
+      puts "Connecting to production database (backup: #{storage})..."
+      sleep(0.8)
+      @connection_string = "postgresql://prod-server:5432/myapp"
+    end
+  end
+
+  class DevelopmentDB < Taski::Task
+    def run
+      # Dev DB uses storage for test data
+      storage = StorageSection.storage_client
+      puts "Initializing dev database connection..."
+      sleep(0.4)
+      puts "Loading test fixtures from #{storage}..."
+      sleep(0.5)
+      puts "Dev database ready"
+      sleep(0.3)
+      @connection_string = "postgresql://localhost:5432/myapp_dev"
+    end
+  end
+end
+
+# Task that uses the database
+class FetchData < Taski::Task
+  exports :data
+
+  def run
+    db = DatabaseSection.connection_string
+    puts "Connecting to #{db}..."
+    sleep(0.3)
+    puts "Querying records..."
+    sleep(0.4)
+    puts "Processing results..."
+    sleep(0.3)
+    @data = ["item1", "item2", "item3"]
+  end
+end
+
+# Main application task
+class Application < Taski::Task
+  exports :result
+
+  def run
+    data = FetchData.data
+    puts "Validating #{data.size} items..."
+    sleep(0.3)
+    puts "Transforming data..."
+    sleep(0.4)
+    puts "Finalizing results..."
+    sleep(0.3)
+    @result = "Processed: #{data.join(", ")}"
+  end
+end
+
+# Show tree structure before execution
+puts "Nested Section Tree Structure:"
+puts "=" * 70
+puts Application.tree
+puts "=" * 70
+puts
+
+# Reset for execution
+Application.reset!
+
+# Execute
+result = Application.result
+
+puts "\n"
+puts "=" * 70
+puts "Execution completed!"
+puts "Result: #{result}"

data/examples/parallel_progress_demo.rb

@@ -4,7 +4,7 @@
 require_relative "../lib/taski"
 
 # Demo tasks that simulate parallel execution with progress display
-# Run with: TASKI_FORCE_PROGRESS=1 ruby examples/parallel_progress_demo.rb
+# Run with: ruby examples/parallel_progress_demo.rb
 
 class DownloadLayer1 < Taski::Task
   exports :layer1_data

data/examples/section_progress_demo.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/taski"
+
+# Demo for tree-based progress display with Section
+# Run with: ruby examples/section_progress_demo.rb
+
+# Database Section with multiple impl candidates
+class DatabaseSection < Taski::Section
+  interfaces :connection_string
+
+  def impl
+    if ENV["USE_PROD_DB"] == "1"
+      ProductionDB
+    else
+      DevelopmentDB
+    end
+  end
+
+  class ProductionDB < Taski::Task
+    def run
+      puts "Connecting to production database..."
+      sleep(0.3)
+      @connection_string = "postgresql://prod-server:5432/myapp"
+    end
+  end
+
+  class DevelopmentDB < Taski::Task
+    def run
+      puts "Connecting to development database..."
+      sleep(0.2)
+      @connection_string = "postgresql://localhost:5432/myapp_dev"
+    end
+  end
+end
+
+# Simple task that uses the database
+class FetchData < Taski::Task
+  exports :data
+
+  def run
+    db = DatabaseSection.connection_string
+    puts "Fetching data from #{db}..."
+    sleep(0.3)
+    @data = ["item1", "item2", "item3"]
+  end
+end
+
+# Main application task
+class Application < Taski::Task
+  exports :result
+
+  def run
+    data = FetchData.data
+    puts "Processing #{data.size} items..."
+    sleep(0.2)
+    @result = "Processed: #{data.join(", ")}"
+  end
+end
+
+# Show tree structure before execution
+puts "Task Tree Structure:"
+puts "=" * 60
+puts Application.tree
+puts "=" * 60
+puts
+
+# Reset for execution
+Application.reset!
+
+# Execute
+result = Application.result
+
+puts "\n"
+puts "=" * 60
+puts "Execution completed!"
+puts "Result: #{result}"

data/examples/tree_progress_demo.rb

@@ -0,0 +1,164 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/taski"
+
+# Demo for tree-based progress display
+# Run with: ruby examples/tree_progress_demo.rb
+
+# Database configuration section with multiple impl candidates
+class DatabaseSection < Taski::Section
+  interfaces :connection_string
+
+  def impl
+    if ENV["USE_PROD_DB"] == "1"
+      ProductionDB
+    else
+      DevelopmentDB
+    end
+  end
+
+  class ProductionDB < Taski::Task
+    def run
+      puts "Connecting to production database..."
+      sleep(0.5)
+      puts "Production DB connected"
+      @connection_string = "postgresql://prod-server:5432/myapp"
+    end
+  end
+
+  class DevelopmentDB < Taski::Task
+    def run
+      puts "Connecting to development database..."
+      sleep(0.3)
+      puts "Development DB connected"
+      @connection_string = "postgresql://localhost:5432/myapp_dev"
+    end
+  end
+end
+
+# API section with multiple impl candidates
+class ApiSection < Taski::Section
+  interfaces :base_url
+
+  def impl
+    if ENV["USE_STAGING_API"] == "1"
+      StagingApi
+    else
+      ProductionApi
+    end
+  end
+
+  class ProductionApi < Taski::Task
+    def run
+      puts "Initializing production API..."
+      sleep(0.4)
+      @base_url = "https://api.example.com"
+    end
+  end
+
+  class StagingApi < Taski::Task
+    def run
+      puts "Initializing staging API..."
+      sleep(0.2)
+      @base_url = "https://staging.api.example.com"
+    end
+  end
+end
+
+# Task with stdout output
+class FetchUserData < Taski::Task
+  exports :users
+
+  def run
+    puts "Fetching users from database..."
+    sleep(0.3)
+    puts "Found 100 users"
+    sleep(0.2)
+    puts "Processing user records..."
+    sleep(0.3)
+    puts "User data ready"
+    @users = ["Alice", "Bob", "Charlie"]
+  end
+end
+
+class FetchProductData < Taski::Task
+  exports :products
+
+  def run
+    puts "Loading product catalog..."
+    sleep(0.4)
+    puts "Fetched 50 products"
+    sleep(0.2)
+    puts "Indexing products..."
+    sleep(0.3)
+    @products = ["Widget", "Gadget", "Thing"]
+  end
+end
+
+class BuildReport < Taski::Task
+  exports :report
+
+  def run
+    db = DatabaseSection.connection_string
+    api = ApiSection.base_url
+    users = FetchUserData.users
+    products = FetchProductData.products
+
+    puts "Building report..."
+    sleep(0.2)
+    puts "Aggregating data from #{users.size} users..."
+    sleep(0.3)
+    puts "Processing #{products.size} products..."
+    sleep(0.2)
+    puts "Report generated successfully"
+
+    @report = {
+      database: db,
+      api: api,
+      user_count: users.size,
+      product_count: products.size
+    }
+  end
+end
+
+class SendNotification < Taski::Task
+  exports :notification_sent
+
+  def run
+    BuildReport.report
+    puts "Sending notification..."
+    sleep(0.2)
+    puts "Email sent to admin@example.com"
+    @notification_sent = true
+  end
+end
+
+class Application < Taski::Task
+  exports :status
+
+  def run
+    notification = SendNotification.notification_sent
+    puts "Application startup complete"
+    @status = notification ? "success" : "failed"
+  end
+end
+
+# Show tree structure before execution
+puts "Task Tree Structure:"
+puts "=" * 60
+puts Application.tree
+puts "=" * 60
+puts
+
+# Reset for execution
+Application.reset!
+
+# Execute with tree progress display (start/stop handled automatically by Executor)
+result = Application.status
+
+puts "\n"
+puts "=" * 60
+puts "Execution completed!"
+puts "Status: #{result}"
+puts "Report: #{BuildReport.report.inspect}"