chsrc/tool/rawstr4c/doc/01-Develop.md

Develop rawstr4c

Dependencies and Dev environment

Please install these first:

1. rakudo
2. just

Get code

Please make sure to use the dev branch for development

git clone https://gitee.com/RubyMetric/chsrc.git -b dev

Run

For convenience, when developing, we only use just to invoke it.

Important

When developing rawstr4c and maintaining chsrc, we must always give a path relative to the root directory of the whole chsrc project! This is because just will switch back to the project root directory by itself.

# Now we've already cd into the current dir
cd src/recipe
# Still have to use path relative to root!!!
just rawstr4c ./src/recipe/ware

just rawstr4c

We can install the distribution, by this way, we don't need just.

zef install .

rawstr4c --help

And therefore no such limitations mentioned above!

cd src/recipe
# No need to to use path relative to root now!!!
rawstr4c .

zef uninstall rawstr4c

Debug

just rawstr4c --debug
# Note: there must be an = between option value and option
just rawstr4c --debug=parser
just rawstr4c --debug=generator

Test

Run test scripts

cd test

raku ./xx-file.rakutest

Test executable file

just rawstr4c