Skip to main content

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.1 removes the enabled argument from StatusLine to 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

statusline-0.1.1.tar.gz (3.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

statusline-0.1.1-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

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

Hashes for statusline-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4a23558aae9d7abcea3c78bb26f8c311dd17f304375c1f8d4a6535111d987d13
MD5 af49a6c802f7890e6d73000eeea783a1
BLAKE2b-256 f5a32da62b98a365509c5a33f702aa3bcaf2176a7961d345ffc09b2d67667a5d

See more details on using hashes here.

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

Hashes for statusline-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e900e3f65b6f8d370f3c3f34a1d3dec48dc43321173c45c56ca822457dbc241c
MD5 e2d5ed7be464478d91220a094121566f
BLAKE2b-256 c47ce74001460633ed07cc49d16992fa1ba7ca9d45f8add2e583309c00a71f0a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page