A multi-purpose tool for Candid.
didc 0.1.0
USAGE:
didc <SUBCOMMAND>
SUBCOMMANDS:
check Type check Candid file
bind Binding for different languages
test Generate test suites for different languages
encode Encode Candid value
decode Decode Candid binary data
random Generate random Candid values
didc bind -t rs and didc random can take a TOML file to configure how didc generate Rust binding or random values.
Rust bindgen can take an external Handlebar template with the following TOML file,
[didc.rust]
target = "custom" # Other targets: canister_call, agent, stub
template = "template.hbs" # required for custom target
# any tags mentioned from hbs
candid_crate = "candid"
service_name = "service"
[rust]
visibility = "pub(crate)"
attributes = "#[derive(CandidType, Deserialize, Debug)]"
GetBlocksResponse.attributes = "#[derive(CandidType, Deserialize, Debug, Clone, Serialize)]"
GetBlocksResponseArchivedBlocksItem.name = "ABetterName"$ didc encode '(42, vec {1;2;-3})'
4449444c016d7c027c002a0301027d
$ didc encode '(42, vec {1;2;-3})' -t '(nat, vec int32)' -f pretty
Length: 24 (0x18) bytes
0000: 44 49 44 4c 01 6d 75 02 7d 00 2a 03 01 00 00 00 DIDL.mu.}.*.....
0010: 02 00 00 00 fd ff ff ff ........
$ didc encode '("text")' -d hello.did -m greet
4449444c0001710474657874
$ didc encode '("text")' -d list.did -t '(list)'
Error: type mismatch: "text" can not be of type opt node
$ didc decode '4449444c016d7c027c002a0301027d'
(42, vec { 1; 2; -3; })
$ didc decode '4449444c016d7c027c002a0301027d' -t '(int)'
(42)
$ didc bind hello.did -t js
export const idlFactory = ({ IDL }) => {
return IDL.Service({ 'greet' : IDL.Func([IDL.Text], [IDL.Text], []) });
}
$ didc random -t '(int, text)'
(-72_594_379_354_493_140_610_202_928_640_651_761_468, "_J`:t7^>")
$ didc random -t '(int, text)' -c 'random = { range = [-10, +10], text = "name" }'
(-6, "Cindy Klocko")
$ didc random -d service.did -m method -c random.toml -a '("seed argument")' -l js
[new BigNumber('-4'), 'Marcus Kris']