Tutorial

This tutorial will guide you through using Routilux step by step, from creating your first routine to building complex workflows with error handling, concurrent execution, and advanced patterns.

The tutorial is designed to be hands-on. Each chapter includes working code examples that you can run and experiment with. We recommend following the chapters in order, as each builds upon concepts introduced in previous chapters.

Learning Path

The tutorial is organized into progressive chapters:

1. Getting Started - Create your first routine and flow

2. Connecting Routines - Learn how to connect routines and understand event flow

3. Data Flow and Parameters - Understand how data flows between routines

4. State Management - Track execution state and statistics

5. Error Handling - Build resilient workflows with error handling strategies

6. Concurrent Execution - Execute independent routines in parallel

7. Advanced Patterns - Learn aggregation patterns, conditional routing, and more

8. Serialization and Persistence - Save and restore workflow state

Each chapter includes:

• Learning Objectives: What you’ll learn by the end of the chapter

• Step-by-step examples: Progressive code examples with explanations

• Expected Output: Verified output from running the examples

• Key Points: Important concepts and best practices

• Common Pitfalls: Mistakes to avoid and how to fix them

• Best Practices: Recommended approaches for production code

• Getting Started
  • Learning Objectives
  • Step 1: Understanding Routines, Slots, and Events
  • Step 2: Creating Your First Flow
  • Step 3: Executing a Flow
  • Step 4: Connecting Two Routines
  • Step 5: Complete Example - A Simple Pipeline
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Connecting Routines
  • Learning Objectives
  • Step 1: One-to-Many Connections (Fan-Out)
  • Step 2: Many-to-One Connections (Fan-In)
  • Step 3: Understanding Merge Strategies
  • Step 4: Complex Branching Patterns
  • Step 5: Understanding the Event Queue Architecture
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Data Flow and Parameters
  • Learning Objectives
  • Step 1: Understanding Parameter Extraction
  • Step 2: Parameter Mapping in Connections
  • Step 3: Handling Complex Data Structures
  • Step 4: Using _extract_input_data Helper
  • Step 5: Debugging Data Flow
  • Common Pitfalls
  • Best Practices
  • Next Steps
• State Management
  • Learning Objectives
  • Step 1: Understanding JobState
  • Step 2: Storing Routine State
  • Step 3: Using Shared Data
  • Step 4: Accessing Execution History
  • Step 5: Complete Example - Stateful Workflow
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Error Handling
  • Learning Objectives
  • Step 1: Understanding Error Strategies
  • Step 2: Using CONTINUE Strategy
  • Step 3: Using RETRY Strategy
  • Step 4: Using SKIP Strategy
  • Step 5: Routine-Level Error Handlers
  • Step 6: Critical and Optional Routines
  • Step 7: Complete Example - Resilient Workflow
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Concurrent Execution
  • Learning Objectives
  • Step 1: Understanding Concurrent Execution
  • Step 2: Enabling Concurrent Execution
  • Step 3: Concurrent Execution in a Flow
  • Step 4: Thread Safety Considerations
  • Step 5: Complete Example - Parallel Data Processing
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Advanced Patterns
  • Learning Objectives
  • Step 1: Aggregation Pattern - Collecting from Multiple Sources
  • Step 2: Conditional Routing
  • Step 3: Fan-Out and Fan-In Pattern
  • Step 4: Pipeline with Error Recovery
  • Step 5: Complete Example - Data Processing Pipeline
  • Common Pitfalls
  • Best Practices
  • Next Steps
• Serialization and Persistence
  • Learning Objectives
  • Step 1: Basic Flow Serialization
  • Step 2: Deserializing Flows
  • Step 3: Serialization Requirements
  • Step 4: Saving and Loading JobState
  • Step 5: Understanding Multiple Executions
  • Step 6: Complete Example - Cross-Host Execution Recovery
  • Common Pitfalls
  • Best Practices
  • Understanding Multiple Executions
  • Next Steps