dotnet add package Sophos.Commands --version 3.0.7
NuGet\Install-Package Sophos.Commands -Version 3.0.7
<PackageReference Include="Sophos.Commands" Version="3.0.7" />
paket add Sophos.Commands --version 3.0.7
#r "nuget: Sophos.Commands, 3.0.7"
// Install Sophos.Commands as a Cake Addin
// Install Sophos.Commands as a Cake Tool
Commands simplifies coordination of asynchronous and synchronous activities. It works with both task and non-task-based operations. The library is built upon class Command, which represents an action. A Command may be run synchronously or asynchronously, and may be aborted.
ParallelCommands, itself a Command, executes a collection of commands concurrently, and SequentialCommands executes its commands in sequence. Using these classes, it's possible to compose deep levels of coordinated actions. For example, SequentialCommands can hold instances of ParallelCommands, which in turn could hold SequentialCommands, and any other Command-derived object.
PeriodicCommand repeats its action at a given interval, ScheduledCommand runs once at a specific time, and RecurringCommand runs at times that are provided via a callback.
RetryableCommand offers the option to conditionally keep retrying a failed command, FinallyCommand provides a mechanism to ensure a cleanup routine is run regardless of whether a command succeeds or fails, and TimeLimitedCommand fails with a timeout exception if a given duration elapses before the command finishes execution.
All of the above Command classes are simply containers for other Command objects that presumably do something of interest. They can be combined in ways that offer a lot of customization. For example, to make an HttpRequest at a given time, with a timeout and a configurable number of retries, you could create a ScheduledCommand containing a RetryableCommand containing a TimeLimitedCommand containing an HttpRequestCommand.
TaskCommand, DelegateCommand and Command.AsTask() offer easy integration with tasks and delegates.
CommandDispatcher manages asynchronous execution of dynamically generated commands.
The Command class allows registration of ICommandMonitor objects. CommandTracer will write diagnostic output to the debug stream, and CommandLogger will write diagnostic output to file. Using the provided CommandLogViewer app (source available in GitHub), it is possible to see the status of all command executions, including their parent/child relationships.
Example usage can be found here: https://github.com/efieleke/CommandLib/blob/master/CommandLibSample/Program.cs
The entire source lives here: https://github.com/efieleke/CommandLib.git
Guidelines for developing your own Command-derived class:
- If the implementation of your command is naturally synchronous, inherit from SyncCommand
- If the implementation of your command is naturally asynchronous and makes use of tasks (i.e. the Task class), inherit from TaskCommand
- If the implementation of your command is naturally asynchronous but does not make use of tasks, inherit from AsyncCommand
- Make your implementation responsive to abort requests if it could take more than a trivial amount of time. To do this, make ocassional calls to Command.CheckAbortFlag() or Command.AbortRequested
A versions for C++ exists at https://github.com/efieleke/CommandLibForCPP.git.
A help file containing complete documentation exists within this package's contents.
|Versions Compatible and additional computed target framework versions.
|net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.
|netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
|netstandard2.0 is compatible. netstandard2.1 was computed.
|net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
|monoandroid was computed.
|monomac was computed.
|monotouch was computed.
|tizen40 was computed. tizen60 was computed.
|xamarinios was computed.
|xamarinmac was computed.
|xamarintvos was computed.
|xamarinwatchos was computed.
- No dependencies.
- No dependencies.
This package is not used by any NuGet packages.
This package is not used by any popular GitHub repositories.