#blockchain #tendermint #testing

bin+lib tendermint-testgen

tendermint-testgen is a library and a small binary utility for generating tendermint datastructures from minimal input (for testing purposes only). The library also contains some functionality to simplify running test batches

40 releases

new 0.34.1 Feb 22, 2024
0.34.0 Oct 2, 2023
0.33.2 Sep 19, 2023
0.33.0 Jul 24, 2023
0.17.0-rc3 Nov 18, 2020

#1361 in Magic Beans

Download history 1440/week @ 2023-11-05 1925/week @ 2023-11-12 1705/week @ 2023-11-19 2165/week @ 2023-11-26 1772/week @ 2023-12-03 1991/week @ 2023-12-10 1975/week @ 2023-12-17 891/week @ 2023-12-24 1453/week @ 2023-12-31 2418/week @ 2024-01-07 3034/week @ 2024-01-14 2212/week @ 2024-01-21 11722/week @ 2024-01-28 2617/week @ 2024-02-04 2369/week @ 2024-02-11 2898/week @ 2024-02-18

19,720 downloads per month
Used in 15 crates (11 directly)

Apache-2.0

625KB
14K SLoC

tendermint-testgen

Crate Docs Build Status Apache 2.0 Licensed Rust Stable

tendermint-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 tendermint-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:

tendermint-testgen validator --id a --voting-power 3
echo -n '{"id": "a", "voting_power": 3}' | tendermint-testgen --stdin validator
echo -n a | tendermint-testgen --stdin validator --voting-power 3
echo -n '{"id": "a"}' | tendermint-testgen --stdin validator --voting-power 3
echo -n '{"id": "a", "voting_power": 100}' | tendermint-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–19MB
~269K SLoC