Cycles 1.0.2

Install-Package Cycles -Version 1.0.2
dotnet add package Cycles --version 1.0.2
<PackageReference Include="Cycles" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Cycles --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Cycles, 1.0.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Cycles as a Cake Addin
#addin nuget:?package=Cycles&version=1.0.2

// Install Cycles as a Cake Tool
#tool nuget:?package=Cycles&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Cycles

Nuget C# Version Framework Version .NETFramework Version GitHub

A strict FSM (Finite-State Machine) architecture implementation.


Core Concept

A FSM where you add states each one with a callback, and this callback has a data type as parameter.

And when you set the state execute the callback sending the data.

Here a illustrative code snippet:

AddState(/* pass state here... */, (data) => { 
    // Do something with the data here...
});

SetState(/* pass state here... */, /* pass data here... */);

Why?

OOP (Object Oriented Paradigm) can be painful if you lose the control of the data mutation and of the order which things happen.

My intention with Cycles is turn things easy during the development and in the support of my applications by turning the code more legible and debuggable.

A library for this is not really necessary, but it's help to set a implementation pattern.


Tips

  • Avoid to create fields or properties to store data in a Cycle.
  • Every Cycle must have at least a state type and a callback.
  • Every Cycle with a data type has a data object as input in the state events.

Usage example

It's a Hello World example without any practical purpose, just to be a simple implementation:

// A state list. It can be any type: enum, string, number, object etc.
public enum State
{
    PreLoading,
    Executing,
    Ending
}

// A data to exchange from a state to other.
public struct Data
{
    public string name;
}

// The cycle class using the state and data declared before.
// The data type is optional, the cycle can be dataless.
public class MyCycle : Cycle<State, Data>
{
    // Add your states events in the constructor.
    public MyCycle()
    {
        AddState(State.PreLoading, Preload);
        AddState(State.Executing, Execute);
        AddState(State.Ending, End);
    }

    // Is a best practice set the first state in a method.
    public void Start(string name)
    {
        SetState(State.PreLoading, new Data { name = name });
    }

    #region Events

    private void Preload(Data data)
    {
        // Do something before load here.

        SetState(State.Executing, data);
    }

    private void Execute(Data data)
    {
        Console.WriteLine($"Hello {data.name}!");
        SetState(State.Ending, data);
    }

    private void End(Data data)
    {
        Kill();
    }

    #endregion
}
  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.2 216 6/26/2020
1.0.1 356 7/1/2019
1.0.0 323 5/28/2019

Tests added to source code.