holochain_cli_launch

Crates.ioholochain_cli_launch
lib.rsholochain_cli_launch
version0.0.12
sourcesrc
created_at2023-01-24 11:05:11.704362
updated_at2023-02-24 20:48:09.558109
descriptionA CLI to launch holochain apps in a Holochain Launcher environment for testing and development purposes.
homepagehttps://developer.holochain.org
repositoryhttps://github.com/holochain/launcher
max_upload_size
id766597
size530,292
(matthme)

documentation

https://docs.rs/holochain_cli_launch

README

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

Commit count: 1206

cargo fmt