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 after assemble 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 removes cage and memory objects~~
• ~~dejump removes goto 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.