custCLI 0.1.0

A python library for creating a CLI with custom commands and parameters

Python-CLI

A Command Line Interface library for Python

Installation:

To use the library, just download the CLI.py file and drop it in to you'r working folder

When using microPython, copy the CLI.py file from the microPython folder

How to use:

1. Import the necessary classes and enums:

   from CLI import CLI, Command, Parameter, DataType
   

2. Define your custom functions that will be executed when a command is called. For example:

   def testFunction(params):
     print("testFunction")     
     for param in params:
       print(f"\t{param}")
   

3. Create instances of the Command class for each command you want to add. For example:

   command1 = Command("test1", 
                 "test1 description", 
                 testFunction, 
                 [Parameter("param1", "param1 description",DataType.STRING), 
                  Parameter("param2", "param2 description", DataType.INTEGER)]
                 )
   

4. Optionally, define more custom functions and create additional Command instances.

5. Create an instance of the CLI class, passing in the name, description, and a list of commands. For example:

   cli = CLI("Test CLI", "Test CLI description", [command1, command2])
   

6. Print the header of the CLI using the printHeader() method:

   cli.printHeader()
   

7. Enter a loop to continuously accept user commands using the newCommand() method:

   while True:
       cli.newCommand()
   

How to use:

from CLI import CLI, Command, Parameter, DataType

def testFunction(params):
 print("testFunction")     
 for param in params:
     print(f"\t{param}")

command1 = Command("test1", "test1 description", testFunction, [Parameter("param1", "param1 description", DataType.STRING), Parameter("param2", "param2 description", DataType.INTEGER)])

def testFunction2(params):
  print("testFunction2")
  for param in params:
      print(f"\t{param.name} - {param.dataType.value} - {param.value}")

command2 = Command("test2", "test2 description", testFunction2, [Parameter("param1", "param1 description", DataType.STRING), Parameter("param2", "param2 description", DataType.INTEGER)])

cli = CLI("Test CLI", "Test CLI description", [command1, command2])
cli.printHeader()

while True:
  cli.newCommand()