1 unstable release
0.1.0-alpha.2 | Jan 27, 2024 |
---|
#5 in #cometbft
730KB
16K
SLoC
cometbft-testgen
cometbft-testgen
is a small utility for producing Tendermint data
structures from minimal input (for testing purposes only).
Requirements
- Latest Rust stable
Usage
# Show usage information for cometbft-testgen
cargo run -- --help
# Show usage about a particular command
cargo run -- --help CMD
As an example, a Tendermint validator can be produced only from an identifier, or a Tendermint header only from a set of validators.
The parameters can be supplied in two ways:
- via STDIN: in that case they are expected to be a valid JSON object, with each parameter being a field of this object
- via command line arguments to the specific command.
If a parameter is supplied both via STDIN and CLI, the latter is given preference.
In case a particular data structure can be produced from a single parameter (like validator), there is a shortcut that allows to provide this parameter directly via STDIN, without wrapping it into JSON object. E.g., in the validator case, the following commands are all equivalent:
cometbft-testgen validator --id a --voting-power 3
echo -n '{"id": "a", "voting_power": 3}' | cometbft-testgen --stdin validator
echo -n a | cometbft-testgen --stdin validator --voting-power 3
echo -n '{"id": "a"}' | cometbft-testgen --stdin validator --voting-power 3
echo -n '{"id": "a", "voting_power": 100}' | cometbft-testgen --stdin validator --voting-power 3
The result is:
{
"address": "730D3D6B2E9F4F0F23879458F2D02E0004F0F241",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "YnT69eNDaRaNU7teDTcyBedSD0B/Ziqx+sejm0wQba0="
},
"voting_power": "3",
"proposer_priority": null
}
License
Copyright © 2020 Informal Systems
Licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
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.
Dependencies
~8–18MB
~267K SLoC