OutWit.Controller.Variables 1.0.2

OutWit.Controller.Variables

A core WitEngine controller that provides basic variable types and operations for the distributed computing system.

Overview

This controller is a fundamental building block for WitEngine. It provides all primitive variable types, collections, and basic operations needed to work with data in WitEngine jobs.

Dependencies

None. This is a base controller that other controllers depend on.

Variable Types

The controller provides the following variable types:

Primitive Types

Complex Types

Collections

Each primitive type has a corresponding collection type (e.g., IntCollection, StringCollection).

Activities

Value Assignment

Each variable type has an assignment activity with the same name:

Int:count = 42;
String:name = "Hello";
Boolean:flag = true;
Double:value = 3.14;

Range Generation

Generate sequences of numbers:

IntCollection:numbers = IntRange(0, 100);
DoubleCollection:values = DoubleRange(0.0, 1.0, 0.1);

Utility Activities

Usage Examples

Basic Variable Declaration

Job:Example()
{
    Int:counter = 0;
    String:message = "Processing started";
    Double:threshold = 0.95;
    Boolean:isComplete = false;
}

Working with Collections

Job:CollectionExample()
{
    IntCollection:numbers = IntRange(1, 10);
    StringCollection:names = StringCollection(["Alice", "Bob", "Charlie"]);
}

Processing Options for Distributed Execution

Job:DistributedExample()
{
    ProcessingOptions:opts = ProcessingOptions();
    
    ~ Use opts with Grid.ForEach for distributed processing ~
}

Project Structure

OutWit.Controller.Variables/
  Variables/           - Variable type definitions
  Collections/         - Collection type definitions  
  Activities/          - Activity definitions
  Adapters/            - Activity adapters (parsing and processing)
  Properties/          - Localized resources
  WitControllerVariablesModule.cs - Plugin entry point

Creating Custom Variable Types

To create a custom variable type:

1. Create a class inheriting from WitVariable<T>
2. Add the [Variable("TypeName")] attribute
3. Implement serialization with [MemoryPackable]
4. Register in the module with services.AddVariable<YourVariable>()

See existing variable implementations for reference.