Tiny single-line status updater for CLI
Project description
statusline
A tiny, dependency-free status logger for CLI scripts.
Made because I got tired of spamming print() in brute-force / crawling / long loops.
What it does
emit() routes your message automatically:
- If the message starts with
[CHECKING](or your custom prefix), it updates in-place on a single line (loading-bar vibe). - Otherwise, it prints a persistent result line (won’t be overwritten).
Install (PyPI)
python -m pip install statusline
Install (editable / dev)
git clone https://github.com/hunhee99/statusline.git
cd statusline
python -m pip install -e .
Tip: If you're using a specific interpreter/venv, always install with that same Python:
python -m pip install -e .
Versioning / Release Notes
- PyPI publishes versioned releases. Install a specific version like:
python -m pip install statusline==X.Y.Z
-
Git tags match released versions. Check tags or release notes on GitHub if you need changelogs or want to pin a specific release.
-
Note:
0.1.1removes theenabledargument fromStatusLineto simplify behavior.
Usage
from statusline import StatusLine
st = StatusLine() # or: StatusLine(checking_prefix="[PROGRESS]")
st.emit("[CHECKING] probing...") # updates the same line
st.emit("[CHECKING] still probing...")
st.emit("do not erase this line!") # printed as a normal line (kept on screen)
Notes
- Prefix matching is simple string logic:
msg.startswith(checking_prefix). - If your editor (e.g., VSCode/Pylance) shows missing-import warnings while it still runs, your language server is probably using a different interpreter. Select the same interpreter you used to install this package and restart the language server.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file statusline-0.1.1.tar.gz.
File metadata
- Download URL: statusline-0.1.1.tar.gz
- Upload date:
- Size: 3.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4a23558aae9d7abcea3c78bb26f8c311dd17f304375c1f8d4a6535111d987d13
|
|
| MD5 |
af49a6c802f7890e6d73000eeea783a1
|
|
| BLAKE2b-256 |
f5a32da62b98a365509c5a33f702aa3bcaf2176a7961d345ffc09b2d67667a5d
|
File details
Details for the file statusline-0.1.1-py3-none-any.whl.
File metadata
- Download URL: statusline-0.1.1-py3-none-any.whl
- Upload date:
- Size: 4.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e900e3f65b6f8d370f3c3f34a1d3dec48dc43321173c45c56ca822457dbc241c
|
|
| MD5 |
e2d5ed7be464478d91220a094121566f
|
|
| BLAKE2b-256 |
c47ce74001460633ed07cc49d16992fa1ba7ca9d45f8add2e583309c00a71f0a
|