eolang 0.21.1 → 0.23.0

package/README.md

@@ -21,6 +21,7 @@ Then, you write a simple [EO](https://www.eolang.org) program in `hello.eo` file
 in the current directory:
 
 ```eo
+# My first object in EO!
 [args] > hello
   QQ.io.stdout > @
     "Hello, world!\n"
@@ -39,24 +40,30 @@ That's it.
 You can also do many other things with `eoc` commands
 (the flow is explained in [this blog post][blog]):
 
-* `register` finds necessary EO files and registers them in a JSON catalog
-* `assemble` parses EO files into XMIR, optimizes them,
+* `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
+* `transpile` converts `.xmir` files to the target programming
+language (Java by default)
+* `compile` converts target language sources (e.g., `.java`)
+to binaries (e.g., `.class`)
 * `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
+* `jeo:disassemble` converts Java `.class` files to `.xmir`
+(via [jeo](https://github.com/objectionary/jeo-maven-plugin))
+* `jeo:assemble` converts `.xmir` files to Java `.class` files
+(via [jeo](https://github.com/objectionary/jeo-maven-plugin))
 
 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][dot]
-* `phi` generates PHI files from XMIR
-* `unphi` generates XMIR files from PHI files
-* `print` generates EO files from PHI files
+* `foreign` inspects all objects found in the program after the `assemble` step
+* `sodg` generates `.sodg` from `.xmir`, further rederable as XML or [Dot][dot]
+* `phi` generates `.phi` files from `.xmir` files
+* `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~~

package/eo-version.txt

@@ -1 +1 @@
-0.38.2
+0.40.3

package/home-tag.txt

@@ -0,0 +1 @@
+55e56e3bb2bdfa3d3e8e139028115790e820f0c1

package/mvnw/.mvn/wrapper/maven-wrapper.properties

@@ -1,17 +1,23 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
+# The MIT License (MIT)
 #
-#   http://www.apache.org/licenses/LICENSE-2.0
+# Copyright (c) 2022-2024 Objectionary.com
 #
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.6/apache-maven-3.9.6-bin.zip
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip

package/mvnw/pom.xml

@@ -29,6 +29,7 @@ SOFTWARE.
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <eo.version>undefined</eo.version>
+    <jeo.version>0.6.12</jeo.version>
   </properties>
   <dependencies>
     <dependency>
@@ -39,12 +40,12 @@ SOFTWARE.
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
-      <version>5.10.2</version>
+      <version>5.11.3</version>
     </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
-      <version>5.10.2</version>
+      <version>5.11.3</version>
     </dependency>
   </dependencies>
   <build>
@@ -66,6 +67,14 @@ SOFTWARE.
           <foreignFormat>json</foreignFormat>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>org.eolang</groupId>
+        <artifactId>jeo-maven-plugin</artifactId>
+        <version>${jeo.version}</version>
+        <configuration>
+          <skipVerification>true</skipVerification>
+        </configuration>
+      </plugin>
       <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.8.1</version>
@@ -76,7 +85,7 @@ SOFTWARE.
       </plugin>
       <plugin>
         <artifactId>maven-jar-plugin</artifactId>
-        <version>3.4.1</version>
+        <version>3.4.2</version>
         <configuration>
           <archive>
             <manifest>
@@ -87,7 +96,7 @@ SOFTWARE.
       </plugin>
       <plugin>
         <artifactId>maven-surefire-plugin</artifactId>
-        <version>3.2.5</version>
+        <version>3.5.1</version>
         <configuration>
           <failIfNoTests>true</failIfNoTests>
         </configuration>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eolang",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "author": "Yegor Bugayenko <yegor256@gmail.com> (https://www.yegor256.com/)",
   "license": "MIT",
   "repository": "objectionary/eoc",
@@ -33,21 +33,21 @@
     "colors": "1.4.0",
     "commander": "12.1.0",
     "eo2js": "0.0.7",
-    "fast-xml-parser": "4.4.0",
-    "node": "22.1.0",
+    "fast-xml-parser": "4.5.0",
+    "node": "23.1.0",
     "relative": "3.0.2",
-    "semver": "7.6.2",
+    "semver": "7.6.3",
     "sync-request": "6.1.0",
     "xmlhttprequest": "1.8.0"
   },
   "devDependencies": {
-    "eslint": "9.4.0",
+    "eslint": "9.13.0",
     "eslint-config-google": "0.14.0",
     "grunt": "1.6.1",
     "grunt-contrib-clean": "2.0.1",
     "grunt-eslint": "24.3.0",
     "grunt-mocha-cli": "^7.0.0",
-    "mocha": "^10.4.0"
+    "mocha": "^10.8.0"
   },
   "scripts": {
     "test": "mocha --timeout 1200000"

package/src/commands/clean.js

@@ -34,12 +34,18 @@ const os = require('os');
 module.exports = function(opts) {
   const home = path.resolve(opts.target);
   fs.rmSync(home, {recursive: true, force: true});
-  console.info('The directory %s deleted', rel(home));
+  if (fs.existsSync(home)) {
+    console.info('The directory %s deleted', rel(home));
+  } else {
+    console.info('The directory %s doesn\'t exist, no need to delete', rel(home));
+  }
   if (opts.global) {
     const eo = path.join(os.homedir(), '.eo');
     if (fs.existsSync(eo)) {
       fs.rmSync(eo, {recursive: true});
-      console.info('The directory %s was deleted', eo);
+      console.info('The directory %s deleted', eo);
+    } else {
+      console.info('The directory %s doesn\'t exist, no need to delete', eo);
     }
   }
 };

package/src/commands/java/dataize.js

@@ -22,8 +22,8 @@
  * SOFTWARE.
  */
 
-const {spawn} = require('node:child_process');
 const path = require('path');
+const {spawn} = require('node:child_process');
 
 /**
  * Runs the single executable binary.
@@ -35,14 +35,16 @@ module.exports = function(obj, args, opts) {
   const params = [
     '-Dfile.encoding=UTF-8',
     `-Xss${opts.stack}`,
+    `-Xms${opts.heap}`,
     '-jar', path.resolve(opts.target, 'eoc.jar'),
+    opts.verbose ? '--verbose' : '',
     obj,
     ...args,
-  ];
+  ].filter((i) => i);
   console.debug('+ java ' + params.join(' '));
   spawn('java', params, {stdio: 'inherit'}).on('close', (code) => {
     if (code !== 0) {
-      console.error(`Java exited with #${code} code`);
+      console.error(`JVM failed with exit code #${code}`);
       process.exit(1);
     }
   });

package/src/commands/jeo/assemble.js

@@ -0,0 +1,55 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022-2024 Objectionary.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const rel = require('relative');
+const {mvnw, flags} = require('../../mvnw');
+const path = require('path');
+
+/**
+ * Assemble .xmir files from .class files.
+ * @param {Object} opts - All options
+ * @return {Promise} of assemble task
+ */
+module.exports = function(opts) {
+  return mvnw(
+    ['jeo:unroll-phi', 'jeo:assemble']
+      .concat(flags(opts))
+      .concat(
+        [
+          `-Djeo.version=${opts.jeoVersion}`,
+          `-Djeo.unroll-phi.sourcesDir=${path.resolve(opts.target, opts.xmirs)}`,
+          `-Djeo.unroll-phi.outputDir=${path.resolve(opts.target, opts.unrolled)}`,
+          `-Djeo.assemble.sourcesDir=${path.resolve(opts.target, opts.unrolled)}`,
+          `-Djeo.assemble.outputDir=${path.resolve(opts.target, opts.classes)}`,
+        ]
+      ),
+    opts.target, opts.batch
+  ).then((r) => {
+    console.info(
+      'EO .xmir files from %s assembled to .class to %s',
+      rel(opts.xmirs), rel(opts.classes)
+    );
+    return r;
+  });
+};

package/src/commands/jeo/disassemble.js

@@ -0,0 +1,53 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022-2024 Objectionary.com
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const rel = require('relative');
+const {mvnw, flags} = require('../../mvnw');
+const path = require('path');
+
+/**
+ * Disassemble .class files to .xmir files.
+ * @param {Object} opts - All options
+ * @return {Promise} of disassemble task
+ */
+module.exports = function(opts) {
+  return mvnw(
+    ['jeo:disassemble']
+      .concat(flags(opts))
+      .concat(
+        [
+          `-Djeo.version=${opts.jeoVersion}`,
+          `-Djeo.disassemble.sourcesDir=${path.resolve(opts.target, opts.classes)}`,
+          `-Djeo.disassemble.outputDir=${path.resolve(opts.target, opts.xmirs)}`,
+        ]
+      ),
+    opts.target, opts.batch
+  ).then((r) => {
+    console.info(
+      'Bytecode .class files from %s disassembled to .xmir to %s',
+      rel(opts.classes), rel(opts.xmirs)
+    );
+    return r;
+  });
+};

package/src/eoc.js

@@ -23,19 +23,8 @@
  * SOFTWARE.
  */
 
-const {program} = require('commander');
 const tinted = require('./tinted-console');
-const audit = require('./commands/audit');
-const clean = require('./commands/clean');
-const parse = require('./commands/parse');
-const assemble = require('./commands/assemble');
-const sodg = require('./commands/sodg');
-const phi = require('./commands/phi');
-const unphi = require('./commands/unphi');
-const print = require('./commands/print');
-const register = require('./commands/register');
-const verify = require('./commands/verify');
-const foreign = require('./commands/foreign');
+const {program} = require('commander');
 
 /**
  * Target language option.
@@ -48,20 +37,41 @@ const language = {
 /**
  * Platform dependent commands.
  */
+const common = {
+  assemble: require('./commands/assemble'),
+  audit: require('./commands/audit'),
+  clean: require('./commands/clean'),
+  foreign: require('./commands/foreign'),
+  parse: require('./commands/parse'),
+  phi: require('./commands/phi'),
+  print: require('./commands/print'),
+  register: require('./commands/register'),
+  sodg: require('./commands/sodg'),
+  unphi: require('./commands/unphi'),
+  verify: require('./commands/verify'),
+  jeo_disassemble: require('./commands/jeo/disassemble'),
+  jeo_assemble: require('./commands/jeo/assemble')
+};
 const commands = {
   [language.java]: {
-    transpile: require('./commands/java/transpile'),
-    link: require('./commands/java/link'),
-    compile: require('./commands/java/compile'),
-    dataize: require('./commands/java/dataize'),
-    test: require('./commands/java/test')
+    ...common,
+    ...{
+      transpile: require('./commands/java/transpile'),
+      link: require('./commands/java/link'),
+      compile: require('./commands/java/compile'),
+      dataize: require('./commands/java/dataize'),
+      test: require('./commands/java/test')
+    }
   },
   [language.js]: {
-    transpile: require('./commands/js/transpile'),
-    link: require('./commands/js/link'),
-    compile: require('./commands/js/compile'),
-    dataize: require('./commands/js/dataize'),
-    test: require('./commands/js/test')
+    ...common,
+    ...{
+      transpile: require('./commands/js/transpile'),
+      link: require('./commands/js/link'),
+      compile: require('./commands/js/compile'),
+      dataize: require('./commands/js/dataize'),
+      test: require('./commands/js/test')
+    }
   }
 };
 
@@ -72,7 +82,7 @@ if (process.argv.includes('--verbose')) {
 
 const fs = require('fs');
 const path = require('path');
-const hash = fs.readFileSync(path.join(__dirname, '../home-hash.txt'), 'utf8').trim();
+const tag = fs.readFileSync(path.join(__dirname, '../home-tag.txt'), 'utf8').trim();
 let parser = fs.readFileSync(path.join(__dirname, '../eo-version.txt'), 'utf8').trim();
 if (process.argv.includes('--latest')) {
   parser = require('./parser-version').get();
@@ -88,7 +98,11 @@ program
   .name('eoc')
   .usage('[options] command')
   .summary('EO command line toolkit')
-  .description('EO command-line toolkit (' + version.what + ' built on ' + version.when + ')')
+  .description(
+    'EO command-line toolkit (' +
+    version.what + ' built on ' + version.when +
+    '): https://github.com/objectionary/eoc'
+  )
   .version(version.what, '-v, --version', 'Output the version number')
   .helpOption('-?, --help', 'Print this help information')
   .configureHelp({sortOptions: true, sortSubcommands: true});
@@ -96,7 +110,7 @@ program
 program
   .option('-s, --sources <path>', 'Directory with .EO sources', '.')
   .option('-t, --target <path>', 'Directory with all generated files', '.eoc')
-  .option('--home-tag <version>', 'Git tag in objectionary/home to compile against', hash)
+  .option('--home-tag <version>', 'Git tag in objectionary/home to compile against', tag)
   .option('--parser <version>', 'Set the version of EO parser to use', parser)
   .option('--latest', 'Use the latest parser version from Maven Central')
   .option('--alone', 'Just run a single command without dependencies')
@@ -111,13 +125,13 @@ program
 program.command('audit')
   .description('Inspect all packages and report their status')
   .action((str, opts) => {
-    audit(program.opts());
+    coms().audit(program.opts());
   });
 
 program.command('foreign')
   .description('Inspect and print the list of foreign objects')
   .action((str, opts) => {
-    foreign(program.opts());
+    coms().foreign(program.opts());
   });
 
 program
@@ -125,13 +139,13 @@ program
   .option('--global', 'delete ~/.eo directory')
   .description('Delete all temporary files')
   .action((str, opts) => {
-    clean({...program.opts(), ...str});
+    coms().clean({...program.opts(), ...str});
   });
 
 program.command('register')
   .description('Register all visible EO source files')
   .action((str, opts) => {
-    register(program.opts());
+    coms().register(program.opts());
   });
 
 program.command('parse')
@@ -139,10 +153,10 @@ program.command('parse')
   .action((str, opts) => {
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => parse(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().parse(program.opts()));
     } else {
-      parse(program.opts());
+      coms().parse(program.opts());
     }
   });
 
@@ -151,10 +165,10 @@ program.command('assemble')
   .action((str, opts) => {
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()));
     } else {
-      assemble(program.opts());
+      coms().assemble(program.opts());
     }
   });
 
@@ -169,11 +183,11 @@ program.command('sodg')
   .action((str, opts) => {
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => sodg({...program.opts(), ...str}));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().sodg({...program.opts(), ...str}));
     } else {
-      sodg({...program.opts(), ...str});
+      coms().sodg({...program.opts(), ...str});
     }
   });
 
@@ -192,11 +206,11 @@ program.command('phi')
   .action((str, opts) => {
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => phi({...program.opts(), ...str}));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().phi({...program.opts(), ...str}));
     } else {
-      phi(program.opts());
+      coms().phi({...program.opts(), ...str});
     }
   });
 
@@ -215,7 +229,7 @@ program.command('unphi')
   .description('Generate XMIR files from PHI files')
   .action((str, opts) => {
     clear(str);
-    unphi({...program.opts(), ...str});
+    coms().unphi({...program.opts(), ...str});
   });
 
 program.command('print')
@@ -232,7 +246,7 @@ program.command('print')
   )
   .action((str, opts) => {
     clear(str);
-    print({...program.opts(), ...str});
+    coms().print({...program.opts(), ...str});
   });
 
 program.command('verify')
@@ -240,11 +254,11 @@ program.command('verify')
   .action((str, opts) => {
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()));
     } else {
-      verify(program.opts());
+      coms().verify(program.opts());
     }
   });
 
@@ -252,30 +266,28 @@ program.command('transpile')
   .description('Convert EO files into target language')
   .action((str, opts) => {
     clear(str);
-    const lang = program.opts().language;
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()))
-        .then((r) => commands[lang].transpile(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()))
+        .then((r) => coms().transpile(program.opts()));
     } else {
-      commands[lang].transpile(program.opts());
+      coms().transpile(program.opts());
     }
   });
 
 program.command('compile')
   .description('Compile target language sources into binaries')
   .action((str, opts) => {
-    const lang = program.opts().language;
     clear(str);
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()))
-        .then((r) => commands[lang].transpile(program.opts()))
-        .then((r) => commands[lang].compile(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()))
+        .then((r) => coms().transpile(program.opts()))
+        .then((r) => coms().compile(program.opts()));
     } else {
-      commands[lang].compile(program.opts());
+      coms().compile(program.opts());
     }
   });
 
@@ -283,37 +295,36 @@ program.command('link')
   .description('Link together all binaries into a single executable binary')
   .action((str, opts) => {
     clear(str);
-    const lang = program.opts().language;
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()))
-        .then((r) => commands[lang].transpile(program.opts()))
-        .then((r) => commands[lang].compile(program.opts()))
-        .then((r) => commands[lang].link(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()))
+        .then((r) => coms().transpile(program.opts()))
+        .then((r) => coms().compile(program.opts()))
+        .then((r) => coms().link(program.opts()));
     } else {
-      commands[lang].link(program.opts());
+      coms().link(program.opts());
     }
   });
 
 program.command('dataize')
   .description('Run the single executable binary and dataize an object')
-  .option('--stack <size>', 'Change stack size', '1M')
+  .option('--stack <size>', 'Set stack size for the virtual machine', '1M')
+  .option('--heap <size>', 'Set the heap size for the VM', '256M')
   .action((str, opts) => {
     clear(str);
-    const lang = program.opts().language;
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()))
-        .then((r) => commands[lang].transpile(program.opts()))
-        .then((r) => commands[lang].compile(program.opts()))
-        .then((r) => commands[lang].link(program.opts()))
-        .then((r) => commands[lang].dataize(
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()))
+        .then((r) => coms().transpile(program.opts()))
+        .then((r) => coms().compile(program.opts()))
+        .then((r) => coms().link(program.opts()))
+        .then((r) => coms().dataize(
           program.args[1], program.args.slice(2), {...program.opts(), ...str}
         ));
     } else {
-      commands[lang].dataize(
+      coms().dataize(
         program.args[1], program.args.slice(2), {...program.opts(), ...str}
       );
     }
@@ -323,20 +334,58 @@ program.command('test')
   .description('Run all visible unit tests')
   .action((str, opts) => {
     clear(str);
-    const lang = program.opts().language;
     if (program.opts().alone == undefined) {
-      register(program.opts())
-        .then((r) => assemble(program.opts()))
-        .then((r) => verify(program.opts()))
-        .then((r) => commands[lang].transpile(program.opts()))
-        .then((r) => commands[lang].compile(program.opts()))
-        .then((r) => commands[lang].link(program.opts()))
-        .then((r) => commands[lang].test(program.opts()));
+      coms().register(program.opts())
+        .then((r) => coms().assemble(program.opts()))
+        .then((r) => coms().verify(program.opts()))
+        .then((r) => coms().transpile(program.opts()))
+        .then((r) => coms().compile(program.opts()))
+        .then((r) => coms().link(program.opts()))
+        .then((r) => coms().test(program.opts()));
     } else {
-      commands[lang].test(program.opts());
+      coms().test(program.opts());
     }
   });
 
+program.command('jeo:disassemble')
+  .description('Disassemble .class files to .xmir files')
+  .option('--jeo-version <version>', 'Version of JEO to use', '0.6.11')
+  .option(
+    '--classes <dir>',
+    'Directory with .class files (relative to --target)',
+    'classes'
+  )
+  .option(
+    '--xmirs <dir>',
+    'Directory with .xmir files (relative to --target)',
+    'xmir'
+  )
+  .action((str, opts) => {
+    coms().jeo_disassemble({...program.opts(), ...str});
+  });
+
+program.command('jeo:assemble')
+  .description('Assemble .xmir files to .class files')
+  .option('--jeo-version <version>', 'Version of JEO to use', '0.6.11')
+  .option(
+    '--xmirs <dir>',
+    'Directory with .xmir files (relative to --target)',
+    'xmir'
+  )
+  .option(
+    '--unrolled <dir>',
+    'Directory with unrolled .xmir files (relative to --target)',
+    'unrolled'
+  )
+  .option(
+    '--classes <dir>',
+    'Directory with .class files (relative to --target)',
+    'classes'
+  )
+  .action((str, opts) => {
+    coms().jeo_assemble({...program.opts(), ...str});
+  });
+
 try {
   program.parse(process.argv);
 } catch (e) {
@@ -351,6 +400,19 @@ try {
  */
 function clear(str) {
   if (program.opts().clean) {
-    clean({...program.opts(), ...str});
+    coms().clean({...program.opts(), ...str});
+  }
+}
+
+/**
+ * Get commands for the target language.
+ * @return {Hash} Commands for the specified language
+ */
+function coms() {
+  const lang = program.opts().language;
+  const hash = commands[lang];
+  if (hash == undefined) {
+    throw new Error(`Unknown platform ${lang}`);
   }
+  return hash;
 }

package/src/version.js

@@ -25,6 +25,6 @@
 // The values here are replaced automatically by the .rultor.yml script,
 // at the "release" pipeline:
 module.exports = {
-  what: '0.21.1',
-  when: '2024-06-06'
+  what: '0.23.0',
+  when: '2024-10-30'
 };

package/home-hash.txt

@@ -1 +0,0 @@
-130afdd1456a0cbafd52aee8d7bc612e1faac547