hfmt-cli
A simple CLI utility for generating formatted text headers with borders and boxes.
📦 Requirements
- Python ≥ 3.9
🛠 Usage
Run with a positional argument:
$ hfmt "project title"
################################## project title ###################################
Run with flags:
$ hfmt --head "build complete" --style multi --char "=" --width 60 --upper --align left
============================================================
= BUILD COMPLETE
============================================================
$ hfmt --border-only --width 50
##################################################
Run with box mode:
$ hfmt --title --width auto --box double "welcome back"
╔══════════════╗
║ Welcome Back ║
╚══════════════╝
⚙️ Options
hfmt-cli supports the following value flags:
| Flag | Description | Default |
|---|---|---|
head (positional) |
Header text | — |
-H, --head |
Header text (alternative flag form) | — |
-s, --style |
Border style (single, multi) |
single |
-c, --char |
Character to use for the border | # |
-w, --width |
Width of the rows | 84 or auto |
-a, --align |
Header justification | center or left |
-b, --box |
Surround header by a box (overrides other flags) | none |
hfmt-cli supports the following value toggles:
| Toggle | Description |
|---|---|
-U, --upper |
Converts header to "UPPER_CASE" |
-L, --lower |
Converts header to "lower_case" |
-T, --title |
Converts header to "Title_Case" |
-S, --swapcase |
Converts header to "sWAP_cASE" |
--border-only |
Returns only a border of characters with no header |
🚀 Installation
Install via pipx
pipx install hfmt-cli
1 maintainer
Metadata
1 maintainer
Release files for hfmt-cli 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hfmt_cli-0.1.2.tar.gz | 6.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hfmt_cli-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.7 kB
Release files / hfmt_cli-0.1.2.tar.gz
| Download URL | hfmt_cli-0.1.2.tar.gz |
|---|---|
| Size | 6.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ce0408c6fefe0b2ee8e064960f24203c74aaf571aa0a359ad1e7c491685e3d2
|
|
BLAKE2b-256 checksum How to use checksums |
25bc554a48d62e74dc430cfbb9cd74beb4cd8831e5e23ad85404de60767774ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 8, 2026.
Transparency logRelease files / hfmt_cli-0.1.2-py3-none-any.whl
| Download URL | hfmt_cli-0.1.2-py3-none-any.whl |
|---|---|
| Size | 7.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
398bc181b17b105b1a776ab538498e5fb0866380888f02437b55f336738b8f08
|
|
BLAKE2b-256 checksum How to use checksums |
3c15f358a232cdbce6a9102e5dad502a1278d1398b4923a183e7030589bed56b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 8, 2026.
Transparency log
