Use

Now that we've finished writing our gibbername crate, we'll demonstrate actually using it in a project. We will build gibbername-cli, a trivial wrapper around the library that lets you look up and register names on the command line. Using it willl look something like
$ gibbername-cli lookup tofnal-qujjay-seh
hello world my dudes this is what's bound to the name lol
You can find a complete example in our GitHub repo.
Project setup
Let's start by creating a new binary crate:
$ cargo new gibbername-cli
$ cd gibbername-cli
We add melprot, melstructs, anyhow for error handling,argh for lightweight argument parsing, and futures-lite for bare-bones async support:
$ cargo add melprot melstructs anyhow argh futures-lite
    Updating crates.io index
      Adding melprot v0.1.0 to dependencies.
      Adding melstructs v0.3.2 to dependencies.
      Adding anyhow v1.0.69 to dependencies.
      Adding argh v0.1.10 to dependencies.
      Adding futures-lite 1.12.0 to dependencies.
We also need to add a dependency on Gibbername itself. This will be a "path" dependency to wherever, locally, you put the Gibbername crate:
[dependencies]
anyhow = "1.0.69"
argh = "0.1.10"
futures-lite = "1.12.0"
gibbername = { path = "../gibbername" }
melprot = "0.13.3"
melstructs = "0.3.2"
Writing the main function
We write a basic scaffold that parses the arguments with argh:
use argh::FromArgs;
use melstructs::{Address, NetID};
​
#[derive(FromArgs, PartialEq, Debug)]
/// Look up a name in the Gibbername registry.
struct Cli {
    #[argh(subcommand)]
    command: Command,
}
​
#[derive(FromArgs, PartialEq, Debug)]
#[argh(subcommand)]
enum Command {
    Lookup(Lookup),
    Register(Register)
}
​
#[derive(FromArgs, PartialEq, Debug)]
#[argh(subcommand, name = "lookup")]
/// Lookup what is bound to a name
struct Lookup {
    #[argh(positional)]
    name: String,
}
​
#[derive(FromArgs, PartialEq, Debug)]
#[argh(subcommand, name = "register")]
/// Register a name
struct Register {
    #[argh(option, description = "the Mel address of the gibbername owner")]
    owner: Address,
​
    #[argh(option, description = "the data to be bound to the gibbername")]
    binding: String,
​
    #[argh(option, description = "the name of the wallet sending the transaction")]
    wallet_name: String,
}
​
​
fn main() -> anyhow::Result<()> {
    let args: Cli = argh::from_env();
    // keep around a client
    let client = melprot::Client::autoconnect(NetID::Mainnet);
    match args.command.as_ref() {
        Command::Lookup(lookup) => {
            todo!()
        }
        Command::Register(register) => {
            todo!()
        }
    };
    Ok(())
}
Filling in the functionality
Now that we have a basic scaffold, filling in the functionality is incredibly easy:
use futures_lite::future::block_on;
​
fn main() -> anyhow::Result<()> {
    let args: Cli = argh::from_env();
    // keep around a client
    let client = block_on(
        melprot::Client::autoconnect(NetID::Testnet)
    )?;
​
    match args.command {
        Command::Lookup(lookup) => {
            // we don't need a futures runtime, block_on is fine
            let gname = block_on(gibbername::lookup(&client, &lookup.name))?;
            println!("{gname}");
        }
        Command::Register(register) => {
            // gibbername will prompt the user
            let name = block_on(gibbername::register(&client, register.owner, &register.binding, &register.wallet_name))?;
            println!("registered {:?}", name);
        }
    };
    Ok(())
}
Testing
We now have a complete program! We can test run it with cargo run:
$ cargo run -- register --owner t1cj51xmq3dxn91z8exz3vhbk2wc8g9enh3kzsbmd3zzy6yx1memyg --binding 'hello CLI' --wallet-name my-wallet
Send this command with your wallet: melwallet-cli send -w last --to t1cj51xmq3dxn91z8exz3vhbk2wc8g9enh3kzsbmd3zzy6yx1memyg,0.000001,"(NEWCUSTOM)","68656c6c6f20434c49" --hex-data 6769626265726e616d652d7631
Now we run the melwallet-cli command which will register our gibbername:
$ melwallet-cli send -w last --to t1cj51xmq3dxn91z8exz3vhbk2wc8g9enh3kzsbmd3zzy6yx1memyg,0.000001,"(NEWCUSTOM)","68656c6c6f20434c49" --hex-data 6769626265726e616d652d7631
registered "zewses"
Finally, we can look up the binding we set in our register command using lookup:
$ cargo run -- lookup zewses
hello CLI
Implement
Next steps
Last modified 6mo ago