#holochain #apps #launcher #launch #environment #command-line #testing

bin+lib holochain_cli_launch

A CLI to launch holochain apps in a Holochain Launcher environment for testing and development purposes

5 releases

0.0.12 Feb 24, 2023
0.0.11 Feb 9, 2023
0.0.10 Feb 8, 2023
0.0.9 Jan 27, 2023
0.0.8 Jan 24, 2023

#1761 in Development tools

Custom license and AGPL-3.0 WITH mif-exception

270KB
1K SLoC

Holochain hc launch CLI

CLI to launch holochain apps in a sandboxed Holochain Launcher environment for testing and development purposes.

Install

This CLI is part of the holochain development environment (holonix) and therein callable via hc launch.

If you prefer to install it globally:

cargo install holochain_cli_launch

Example Usage

  • Launch a .webhapp with 2 agents communicating over mdns network and initializing lair-keystore "on-the-fly" by piping a password through on the command line:
echo pass | hc-launch --piped -n 2 path/to/my/app.webhapp network mdns

  • Launch a .happ with the UI assets specified with the --ui-path option for 2 agents communicating over mdns network, initializing lair-keystore "on-the-fly" by piping a password through on the command line and watching for file changes in the specified UI path:
echo pass | hc-launch --piped -n 2 path/to/my/app.happ --ui-path path/to/my/ui/assets --watch network mdns

  • Launch a .happ while pointing to a port on localhost from where you serve the UI assets:
    Note: This mode is only meant for development purposes! Serving assets from localhost will result in different behavior than running the app in the real Holochain Launcher.
echo pass | hc-launch --piped -n 2 path/to/my/app.happ --ui-port 5500 network mdns

Documentation

Documentation is on https://docs.rs/holochain_cli_launch

Dependencies

~97–140MB
~2.5M SLoC