OutWit.Controller.Variables 1.0.3

OutWit.Controller.Variables

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

Overview

This controller is a fundamental building block for OmnibusCloud. It provides all primitive variable types, collections, and basic operations needed to work with data in OmnibusCloud 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

Every primitive and complex type above (except Array, ProcessingOptions) has a matching <Type>Collection — IntCollection, StringCollection, BlobCollection, ObjectCollection, TupleCollection, etc.

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 wrappers (WitVariableInteger, WitVariableColor, ...)
  Collections/         - Collection wrappers (WitVariableIntegerCollection, ...)
  Activities/          - Activity DTOs (WitActivityInteger, WitActivityIntegerRange, ...)
  Adapters/            - Activity adapters — parse params + run the work
  Interfaces/          - Internal marker interfaces shared across this controller's adapters
  Utils/               - Exception-message helpers (ExceptionsUtils)
  Properties/          - Localized error strings (Resources.resx)
  build/               - Consumer-side MSBuild .targets shipped inside the nupkg
  WitControllerVariablesModule.cs - Plugin entry point (DI registrations)

OutWit.Controller.Variables.Model/
  WitColor.cs          - Shared RGBA value type
  Utils/               - VariablesUtils (hex parsing helpers)

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.