Difference between revisions of "Creating Commands"

Revision as of 16:14, 30 August 2017

Creating Commands: You can create commands from any c# methods, fields or properties by adding the [ConsoleCommand] attribute.

Basic Example

using ReflexCLI.Attributes;

namespace CommandTest
{
    class TestCommandLibrary
    {
        [ConsoleCommand]
        private static string Echo(string in)
        {
            return in;
        }
		
        [ConsoleCommand]
        protected static int IntegerField = 32;
		
        [ConsoleCommand]
        public static bool BooleanProperty
        {
            get { return IntegerField > 0; }
        }			
    }
}

This will create the following commands:

1. CommandTest.TestCommandLibrary.Echo
2. CommandTest.TestCommandLibrary.IntegerField
3. CommandTest.TestCommandLibrary.BooleanProperty

Customising Command Prefixes

By default, the commands are given fully-qualified names with namespaces etc., which can get pretty verbose. This can be fixed by using a [CommandConsoleClassCustomizer] attribute on the class:

namespace CommandTest
{
	[ConsoleCommandClassCustomizer("TestCommand")]
	class TestCommandLibrary
	{
		// etc.

This will change the prefix of the commands to TestCommand. and so the commands become:

1. TestCommand.Echo
2. TestCommand.IntegerField
3. TestCommand.BooleanProperty

Customising Command Names

You can also customize the name of the commands by adding the optional parameter to [ConsoleCommand]. For example

    [ConsoleCommand("Int")]
    protected static int IntegerField = 32;

which will change this command to be TestCommand.Int.

Limitations

There are some limitations on what members can be turned into commands. See Command Limitations for details.