hut-utils

About

hut-utils is a fast, simple CLI extension written in Rust for interacting with sourcehut. It supports multiple input formats and is designed for efficient use in the terminal.

Features

• Update a paste on sourcehut by deleting the old one and creating a new one.

Getting Started

Prerequisites

• Rust (1.87.0 or later)
• Cargo (comes with Rust)
• Just (optional, for build and install from source)
• Sourcehut account
• Sourcehut CLI

Building

git clone https://git.sr.ht/~anhkhoakz/hut-cli-utils
cd hut-cli-utils
just build

Installing

System-wide (optional, requires sudo):

just install

Or from crates.io:

cargo install hut-utils

Uninstalling

just uninstall
# or, if installed via Cargo:
cargo uninstall hut-utils

Usage

hut-utils [COMMAND]

Available Commands

• paste edit: Edit a paste on sourcehut by deleting the old one and creating a new one.
• paste rename: Rename an existing paste on sourcehut.
• -h, --help: Print help for the tool or command.
• -V, --version: Print the version of the tool.

Example

hut-utils paste edit --source-file <source-file> --remote-file <remote-file> --visibility <visibility>
hut-utils paste rename --current-name <current-name> --new-name <new-name>

If you provide invalid input, the tool will print an error and usage instructions.

Contributing

Contributions are welcome! Please open issues or pull requests on Sourcehut. See the root CONTRIBUTING.md for guidelines.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.