# plutoengine:plutocommandparser

PlutoEngine's command parser.

## Description 

PlutoCommandParser is an attempt to streamline my previous attempts at command parsers. Its main
goal is to provide a streamlined and flexible tokenizer, parser and evaluator for a simple 
user-friendly CLI-like language called `PlutoCmd`.

## Goals

* High syntax error tolerance
* Provide implementations for basic Java types, such as primitives and Strings
* Allow extensibility while providing a strong foundation
* Complete user control over localization, no hardcoded Strings

## Non-goals

PlutoCmd is *not* a replacement for standard scripting languages and will most likely
never be a Turing-complete language.


## Implementation style

### Command implementation

Each command has its own *final* class, abstractions over CommandBase are howered allowed. 
Note the usage of `ConstantExpression` annotation over some interface methods. These 
annotations **must** be respected - methods must be stateless and deterministic.

## PlutoCmd language specification

### General syntax

```
[prefix]command [arg1] [arg2] ... [argN]
```

`prefix` is an optional identifier String to distinguish PlutoCmd commands from other commands.

`command` is an alias for a command, handled by one of the command handlers 

`argX` is an argument of the invoked command-function, optionally quoted to preserve whitespace.