taski 0.8.0 → 0.8.2

data/lib/taski.rb

@@ -140,6 +140,7 @@ module Taski
 
   @args_monitor = Monitor.new
   @env_monitor = Monitor.new
+  @message_monitor = Monitor.new
 
   # Get the current runtime arguments
   # @return [Args, nil] The current args or nil if no task is running
@@ -153,6 +154,23 @@ module Taski
     @env_monitor.synchronize { @env }
   end
 
+  # Output a message to the user without being captured by TaskOutputRouter.
+  # During task execution with progress display, messages are queued and
+  # displayed after execution completes. Without progress display or outside
+  # task execution, messages are output immediately.
+  #
+  # @param text [String] The message text to display
+  def self.message(text)
+    @message_monitor.synchronize do
+      progress = progress_display
+      if progress&.respond_to?(:queue_message)
+        progress.queue_message(text)
+      else
+        $stdout.puts(text)
+      end
+    end
+  end
+
   # Start new execution environment (internal use only)
   # @api private
   # @return [Boolean] true if this call created the env, false if env already existed
@@ -229,9 +247,14 @@ module Taski
   end
 
   # Get the current progress mode (:tree or :simple)
+  # Environment variable TASKI_PROGRESS_MODE takes precedence over code settings.
   # @return [Symbol] The current progress mode
   def self.progress_mode
-    @progress_mode || progress_mode_from_env
+    if ENV["TASKI_PROGRESS_MODE"]
+      progress_mode_from_env
+    else
+      @progress_mode || :tree
+    end
   end
 
   # Set the progress mode (:tree or :simple)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taski
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.2
 platform: ruby
 authors:
 - ahogappa
@@ -59,17 +59,12 @@ files:
 - examples/README.md
 - examples/args_demo.rb
 - examples/clean_demo.rb
-- examples/data_pipeline_demo.rb
 - examples/group_demo.rb
-- examples/large_tree_demo.rb
-- examples/nested_section_demo.rb
-- examples/parallel_progress_demo.rb
+- examples/message_demo.rb
+- examples/progress_demo.rb
 - examples/quick_start.rb
 - examples/reexecution_demo.rb
 - examples/section_demo.rb
-- examples/simple_progress_demo.rb
-- examples/system_call_demo.rb
-- examples/tree_progress_demo.rb
 - lib/taski.rb
 - lib/taski/args.rb
 - lib/taski/env.rb
@@ -120,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.4
 specification_version: 4
 summary: A simple yet powerful Ruby task runner with static dependency resolution
   (in development).

data/examples/data_pipeline_demo.rb

@@ -1,231 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Taski Data Pipeline Example
-#
-# This example demonstrates a realistic data processing pipeline:
-# - Section API for switching data sources (production vs test)
-# - Multiple data sources fetched in parallel
-# - Data transformation and aggregation
-#
-# Run: ruby examples/data_pipeline_demo.rb
-# Disable progress: TASKI_PROGRESS_DISABLE=1 ruby examples/data_pipeline_demo.rb
-
-require_relative "../lib/taski"
-
-# Section: Data source abstraction
-# Switch between production API and test fixtures
-class DataSourceSection < Taski::Section
-  interfaces :users, :sales, :activities
-
-  def impl
-    (ENV["USE_TEST_DATA"] == "true") ? TestData : ProductionData
-  end
-
-  # Production: Fetch from APIs (simulated with delays)
-  class ProductionData < Taski::Task
-    def run
-      puts "  [ProductionData] Fetching from APIs..."
-      sleep(0.3)
-
-      @users = [
-        {id: 1, name: "Alice", department: "Engineering"},
-        {id: 2, name: "Bob", department: "Sales"},
-        {id: 3, name: "Charlie", department: "Engineering"},
-        {id: 4, name: "Diana", department: "Marketing"}
-      ]
-
-      @sales = [
-        {user_id: 2, amount: 1000, date: "2024-01"},
-        {user_id: 2, amount: 1500, date: "2024-02"},
-        {user_id: 4, amount: 800, date: "2024-01"}
-      ]
-
-      @activities = [
-        {user_id: 1, action: :commit, count: 45},
-        {user_id: 3, action: :commit, count: 32},
-        {user_id: 1, action: :review, count: 12},
-        {user_id: 3, action: :review, count: 8}
-      ]
-
-      puts "  [ProductionData] Loaded #{@users.size} users, #{@sales.size} sales, #{@activities.size} activities"
-    end
-  end
-
-  # Test: Minimal fixture data (no delays)
-  class TestData < Taski::Task
-    def run
-      puts "  [TestData] Loading test fixtures..."
-
-      @users = [
-        {id: 1, name: "Test User", department: "Test Dept"}
-      ]
-
-      @sales = [
-        {user_id: 1, amount: 100, date: "2024-01"}
-      ]
-
-      @activities = [
-        {user_id: 1, action: :commit, count: 10}
-      ]
-
-      puts "  [TestData] Loaded minimal test data"
-    end
-  end
-end
-
-# Section: Report format selection
-class ReportFormatSection < Taski::Section
-  interfaces :format_report
-
-  def impl
-    (ENV["REPORT_FORMAT"] == "json") ? JsonFormat : TextFormat
-  end
-
-  class TextFormat < Taski::Task
-    def run
-      @format_report = ->(report) {
-        report.map do |dept, stats|
-          "#{dept}: #{stats[:user_count]} users, $#{stats[:total_sales]} sales"
-        end.join("\n")
-      }
-    end
-  end
-
-  class JsonFormat < Taski::Task
-    def run
-      require "json"
-      @format_report = ->(report) { JSON.pretty_generate(report) }
-    end
-  end
-end
-
-# Transform: Enrich users with sales data
-class EnrichWithSales < Taski::Task
-  exports :users_with_sales
-
-  def run
-    users = DataSourceSection.users
-    sales = DataSourceSection.sales
-
-    sales_by_user = sales.group_by { |s| s[:user_id] }
-      .transform_values { |records| records.sum { |r| r[:amount] } }
-
-    @users_with_sales = users.map do |user|
-      user.merge(total_sales: sales_by_user[user[:id]] || 0)
-    end
-
-    puts "  [EnrichWithSales] Enriched #{@users_with_sales.size} users"
-  end
-end
-
-# Transform: Enrich users with activity data
-class EnrichWithActivities < Taski::Task
-  exports :users_with_activities
-
-  def run
-    users = DataSourceSection.users
-    activities = DataSourceSection.activities
-
-    activities_by_user = activities.group_by { |a| a[:user_id] }
-      .transform_values do |records|
-        records.to_h { |r| [r[:action], r[:count]] }
-    end
-
-    @users_with_activities = users.map do |user|
-      user.merge(activities: activities_by_user[user[:id]] || {})
-    end
-
-    puts "  [EnrichWithActivities] Enriched #{@users_with_activities.size} users"
-  end
-end
-
-# Aggregate: Combine enrichments into profiles
-class BuildProfiles < Taski::Task
-  exports :profiles
-
-  def run
-    users_sales = EnrichWithSales.users_with_sales
-    users_activities = EnrichWithActivities.users_with_activities
-
-    activities_map = users_activities.to_h { |u| [u[:id], u[:activities]] }
-
-    @profiles = users_sales.map do |user|
-      user.merge(activities: activities_map[user[:id]] || {})
-    end
-
-    puts "  [BuildProfiles] Built #{@profiles.size} profiles"
-  end
-end
-
-# Output: Generate department report
-class GenerateReport < Taski::Task
-  exports :report, :formatted_output
-
-  def run
-    profiles = BuildProfiles.profiles
-    formatter = ReportFormatSection.format_report
-
-    by_department = profiles.group_by { |p| p[:department] }
-
-    @report = by_department.transform_values do |dept_users|
-      {
-        user_count: dept_users.size,
-        total_sales: dept_users.sum { |u| u[:total_sales] },
-        total_commits: dept_users.sum { |u| u[:activities][:commit] || 0 },
-        total_reviews: dept_users.sum { |u| u[:activities][:review] || 0 }
-      }
-    end
-
-    @formatted_output = formatter.call(@report)
-    puts "  [GenerateReport] Generated report for #{@report.size} departments"
-  end
-end
-
-# Demo execution
-puts "Taski Data Pipeline Demo"
-puts "=" * 50
-
-puts "\n1. Dependency Tree"
-puts "-" * 50
-puts GenerateReport.tree
-
-puts "\n2. Production Data (default)"
-puts "-" * 50
-ENV["USE_TEST_DATA"] = "false"
-ENV["REPORT_FORMAT"] = "text"
-
-start_time = Time.now
-GenerateReport.run
-elapsed = Time.now - start_time
-
-puts "\nReport (text format):"
-puts GenerateReport.formatted_output
-puts "\nCompleted in #{elapsed.round(3)}s"
-
-puts "\n" + "=" * 50
-puts "\n3. Test Data with JSON Format"
-puts "-" * 50
-ENV["USE_TEST_DATA"] = "true"
-ENV["REPORT_FORMAT"] = "json"
-
-# Reset all tasks for fresh execution
-[DataSourceSection, ReportFormatSection, EnrichWithSales,
-  EnrichWithActivities, BuildProfiles, GenerateReport].each(&:reset!)
-
-start_time = Time.now
-GenerateReport.run
-elapsed = Time.now - start_time
-
-puts "\nReport (JSON format):"
-puts GenerateReport.formatted_output
-puts "\nCompleted in #{elapsed.round(3)}s"
-
-puts "\n" + "=" * 50
-puts "Pipeline demonstration complete!"
-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 "\nTo disable progress display:"
-puts "  TASKI_PROGRESS_DISABLE=1 ruby examples/data_pipeline_demo.rb"