Skip to content

dfinity/idl2json

Repository files navigation

idl2json

Reads Candid textual values from stdin and emits them as json values on stdout.

This command is useful for piping the output of Candid value producing tools (such as dfx) into json tools.

dfx canister call governance get_proposal_info 1 | idl2json

There is sample output to play with without dfx:

<samples/proposal.idl ./target/debug/idl2json

Install

With cargo binstall

cargo binstall will install a pre-built binary, if available, else compile from source:

cargo binstall idl2json_cli --no-confirm

With cargo install

cargo install will download, compile and install:

cargo install idl2json_cli

Build

Build with any of the following methods. The binary executable will be at idl2json/target/{debug,release}/idl2json (depending on whether cargo build --release is used).

With nix:

nix-shell --command 'cargo build'

Build OSX without nix

brew install libiconv
export LIBRARY_PATH=/usr/local/Cellar/libiconv/1.16/lib/
cargo build