#command #command-line #unc #human-friendly #helps #interact #utility

bin+lib utility-cli-rs

人性化的控制台实用工具,帮助从命令行与 unc 协议交互

6 个版本

0.12.2 2024 年 5 月 22 日
0.12.1 2024 年 5 月 22 日
0.10.2 2024 年 5 月 15 日
0.8.2 2024 年 4 月 12 日

#2624魔法豆

Download history 21/week @ 2024-04-14 8/week @ 2024-04-21 1/week @ 2024-04-28 134/week @ 2024-05-05 154/week @ 2024-05-12 374/week @ 2024-05-19 166/week @ 2024-05-26 81/week @ 2024-06-02 36/week @ 2024-06-09 9/week @ 2024-06-16 1/week @ 2024-06-23 32/week @ 2024-06-30 41/week @ 2024-07-07 1/week @ 2024-07-14 43/week @ 2024-07-28

85 每月下载量
用于 4 个包 (2 直接)

GPL-2.0-or-later

1MB
18K SLoC

实用 CLI

实用 CLI 是您的 人性化 伴侣,帮助您从命令行与 实用工具 交互。

只需运行 unc,它会引导您完成!

安装

访问 发布页面 查看最新更新。

通过 shell 脚本安装预构建的二进制文件(macOS,Linux,WSL)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/utility-cli-rs/releases/latest/download/utility-cli-rs-installer.sh | sh
使用 npx 运行预构建的二进制文件(Node.js)
npx utility-cli-rs
将预构建的二进制文件安装到您的 npm 项目中(Node.js)
npm install utility-cli-rs
从源代码编译和安装(Cargo)

使用 cargo 安装,确保您的计算机上已安装 Rust

cargo install utility-cli-rs

或,从 Git 仓库安装最新版本

cargo install --git https://github.com/utnet-org/utility-cli-rs
在 CI(GitHub Actions)上安装

通常希望从 CI 使用 unc 命令行来自动化一些操作,以下是一个在 CI 中进行函数调用的示例

name: Release
on:
  push:
    branches: [main]

jobs:
  deploy-widgets:
    runs-on: ubuntu-latest
    name: Make a function call on testnet
    env:
      UNC_NETWORK_CONNECTION: testnet
      UNC_CONTRACT_ACCOUNT_ID: ${{ vars.UNC_CONTRACT_ACCOUNT_ID }}
      UNC_SIGNER_ACCOUNT_ID: ${{ vars.UNC_SIGNER_ACCOUNT_ID }}
      UNC_SIGNER_ACCOUNT_PUBLIC_KEY: ${{ vars.UNC_SIGNER_ACCOUNT_PUBLIC_KEY }}
      UNC_SIGNER_ACCOUNT_PRIVATE_KEY: ${{ secrets.UNC_SIGNER_ACCOUNT_PRIVATE_KEY }}

    steps:
    - name: Checkout repository
      uses: actions/checkout@v3

    - name: Install unc cli
      run: |
        curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/utility-cli-rs/releases/download/v0.8.2/utility-cli-rs-installer.sh | sh

    - name: Call some function
      run: |
        unc contract call-function as-transaction "$UNC_CONTRACT_ACCOUNT_ID" 'function_name_here' json-args '{}' prepaid-gas '100 TeraGas' attached-deposit '0 unc' sign-as "$UNC_SIGNER_ACCOUNT_ID" network-config "$UNC_NETWORK_CONNECTION" sign-with-plaintext-private-key --signer-public-key "$UNC_SIGNER_ACCOUNT_PUBLIC_KEY" --signer-private-key "$UNC_SIGNER_ACCOUNT_PRIVATE_KEY" send

您需要配置 GitHub Actions Secrets 和 Variables,一旦就绪,此 CI 将仅需要几 完成!

查看它如何在 DevHub 中使用。

运行

安装后,只需运行 unc 命令即可。

$ unc

? What are you up to? (select one of the options with the up-down arrows on your keyboard and press Enter)
> account     - Manage accounts
  tokens      - Manage token assets such as UNC, FT, NFT
  pledging     - Manage pledging: view, add and withdraw pledge
  contract    - Manage smart-contracts: deploy code, call functions
  transaction - Operate transactions
  config      - Manage connections in a configuration file (config.toml)
  extension   - Manage unc CLI and extensions
[↑↓ to move, enter to select, type to filter]

CLI交互式引导您通过一些相当复杂的话题,帮助您在过程中做出明智的决定。

阅读更多

依赖

~53–78MB
~1.5M SLoC