New features and some fixes - Variadic arguments flexibility and grouping, Negative numbers

[shlomohass]

This is the result of / and fixes #93

What has changed:

Introduced a new Tokenizer class to enable a more advanced syntax to be parsed (Normalizer now only handles the value filtering)

• Negative numbers are now supported and will be auto-detected and not treated as options.
• As discussed, I implemented a "variadic boundaries" syntax, which offers more flexibility and the use of multiple variadic arguments/options.
• a bug with options that are defined only with a long name and are variadic ->option("--names [items...]") is now working as expected.
• minor improvements and fixes to satisfy linters and phpstan.

# Now, variadic arguments can be explicitly used : 
$ app cmd arg11 arg12 --opt [ val1 val2 ] # 👍 
$ app cmd [arg11 arg12] --opt [val1 val2] # 👍 
$ app cmd arg11 arg12 --opt val1 val2 # 👍 
$ app cmd [arg11 arg12] [arg21 arg22] --opt val1 val2 # 👍 
$ app cmd arg1 arg2 --flags [ -- -a -b -c ] --opt val1 val2 # amazingly this one is working also 👍 

#Negative numbers:
$ app scan --offset -5 # 👍 

Tested on/with:

• I made a new test file, AdvacedArgsTest.php with many edge cases and crazy scenarios.
• win 10 - PHP 8.1 - bash, cmd
• ubuntu 22 - PHP 8.2
• mint - PHP 8.2
• PHPunit and real applications with user input.

Notes:

• I did my best to keep backward compatibility so it should work with older implementations. That said, you should consider (in case you approve this pull) bumping the major version as it introduces new features and, in some rare and weird cases, it may break the current implementations - maybe someone relies on the "last variadic" error :astonished:
• I tested it in real-world applications (mine), and it worked out of the box - It will be great if you can test it against your own apps just to be sure.

I have some more ideas for future improvements 😄

[adhocore]

oh, just saw this and looks great. i will check indepth from PC soon. thanks for working out the PR

[shlomohass]

@adhocore Take your time and test it carefully. I really did my best to cover any weird (sensible) combination, but you can never be sure.

[shlomohass]

@adhocore Sure I'll start making the edits. I thought the CodeFactor has autofix for all the empty lines and so on... I will do it on my branch and update the pull.

[shlomohass]

Those Are the inputs:

On:

• Ubuntu 22
• PHP 8.2.1

I'm sure it can be improved even more...