hr-zig djmattyg007

Use this command to install hr-zig:

winget install --id=djmattyg007.hr-zig -e

hr-zig is a command-line tool designed to generate horizontal rule characters in text output, serving as a port of the original hr utility implemented in Zig. This project also functions as a learning exercise for exploring Zig programming concepts.

Key Features:

Generates horizontal rules with customizable line counts (e.g., hr 5 produces five lines).
Handles non-numeric inputs by displaying an error message and no output.
Provides default behavior when no arguments are specified, outputting a single line.
Built using Zig, offering insights into cross-platform development practices.

Audience & Benefit:
Ideal for developers and educators who want to explore Zig programming while maintaining the utility of horizontal rule generation in text-based applications or documentation.

hr-zig

This is a port of hr to Zig, as a learning exercise for Zig.

You can find my C version of hr here: https://github.com/djmattyg007/hr

Usage

Using hr is incredibly straightforward and simple:

hr 5 # prints 5 lines
hr # with no arguments, prints 1 line
hr 10 five # prints 10 lines, all other arguments are ignored
hr seventeen # anything other than a number as the first argument will result in an error and no output

Compiling

To build hr from source, you're going to need at least Zig v0.15.1. Then simply run the following command:

zig build install -Doptimize=ReleaseSmall

To install it into a custom directory (for packaging):

zig build install -Doptimize=ReleaseSmall --prefix "${custom}/usr"

I used to have instructions for building just the binary (with zig build-exe), but it seems like using it is simply infeasible once you take on dependencies. Just use zig build and look in the zig-out folder that gets created.

Releases

Releases are initiated by running dev/release.py. This will first run some checks (such as making sure that there is an existing changelog entry). It will then generate a git tag, and push it to the remote. This act will kick off a release pipeline with Github Actions.

All release artifacts are generated by GoReleaser, and signed with a GPG key. The fingerprint of this key is 1860CDE18B952368F111BC4D5A9B5133A97F159F. The public key can be found here.

License

This program is released into the public domain without any warranty. See LICENSE.txt for more information.