eoc
eoc copied to clipboard
Command-line toolkit for parsing, compiling, transpiling, optimizing, linking, dataizing, and running EOLANG programs
EOLANG Command Line Took-Kit
First, you install npm and Java SE.
Then, you install eolang package:
npm install -g eolang
Then, you write a simple EO program in hello.eo
file
in the current directory:
[args] > hello
QQ.io.stdout > @
"Hello, world!\n"
Then, you run it:
eoc dataize hello
That's it.
Commands
You can also do many other things with eoc
commands
(the flow is explained in this blog post):
-
register
finds necessary EO files and registers them in a JSON catalog -
assemble
parses EO files into XMIR, optimizes them, and pulls foreign EO objects -
transpile
converts XMIR to target programming language (Java by default) -
compile
converts target language sources to binaries -
link
puts all binaries together into a single executable binary -
dataize
dataizes a single object from the executable binary -
test
dataizes all visible unit tests
There are also commands that help manipulate with XMIR and EO sources (the list is not completed, while some of them are not implemented as of yet):
-
audit
inspects all required packages and reports their status -
foreign
inspects all objects found in the program afterassemble
step -
sodg
generates SODG from XMIR, further rederable as XML or Dot -
phi
generates PHI files from XMIR -
unphi
generates XMIR files from PHI files -
print
generates EO files from PHI files - ~~
translate
converts Java/C++/Python/etc. program to EO program~~ - ~~
demu
removescage
andmemory
objects~~ - ~~
dejump
removesgoto
objects~~ - ~~
infer
suggests object names where it's possible to infer them~~ - ~~
flatten
moves inner objects to upper level~~
This command line toolkit simply integrates other tools available in the @objectionary GitHub organization.
How to Contribute
First, run npm install
. Then, run grunt
. All tests should pass.
If you want to run a single test:
npm test -- test/test_mvnw.js
Make your changes and then make a pull request.