A from scratch implementation of Tcl on Parrot.
To build the tcl compiler, first build parrot and the parrot utilities. From the top level parrot directory:
perl Configure.pl && make
Then, type make in this directory. This will generate the file tcl.pbc which can then be used to run tcl programs.
make
tcl.pbc
../../parrot tcl.pbc foo.tcl
To run partcl interactively, type:
make tclsh
in this directory.
partcl supports two command line options (that are not standard Tcl):
Analagous to perl's -e switch, this option will let you specify tcl code in the command line, which will then be executed. e.g:
-e
$ ../../parrot tcl.pbc -e 'puts {Hello World}' Hello World
You will need to properly quote the tcl to protect it from your shell.
Given this option, partcl will compile the tcl code to PIR, and output the PIR on STDOUT. This PIR can then be compiled to parrot bytecode, or run directly through parrot. (Works with -e.).
To pretty print the PIR that is generated, you can use the experimental utility in ../../tools/util/pirtidy.pl.
../../tools/util/pirtidy.pl
To run an example, change to the examples, and type make for instructions.
examples
To run the test suite, type make test. If any tests fail, try TEST_PROG_ARGS=-G make test. Send the results of both to the mailing list parrot-porters@perl.org.
make test
TEST_PROG_ARGS=-G make test
parrot-porters@perl.org
See docs/ and TODO
docs/
TODO
Note that we are targetting Tcl's cvs-latest, which is 8.5. This allows us to test against what will likely be state of the art by the time we approach completion. As we get closer to that day, we'll probably settle down and code against the most recent version (which hopefully won't be 9.x by then).
This has the disadvantage that for side by side testing, you'll need to build your own tcl (please use at least 8.5, revision a5). Partcl users don't need to worry about this, and even most partcl developers can simply code against the test suite.
To install Parrot::Op, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Parrot::Op
CPAN shell
perl -MCPAN -e shell install Parrot::Op
For more information on module installation, please visit the detailed CPAN module installation guide.