Fast, clear, and beautiful health checks for your endpoints.

Checking Health is a polished command-line utility for HTTP and HTTPS endpoint validation. Run checks from a file, get real-time terminal output, and inspect status, latency, download size, content type, title, IP, and more in one clean view.

Install from PyPI See usage 
$ checking-health endpoints.txt --timeout 3

TYPE         STATUS   HTTP   DOMAIN                                   IP              CONTENT-TYPE        SIZE   REQ(ms)  TIME(ms)  TITLE
-------------------------------------------------------------------------------------------------------------------------------
health       OK       200    google.com                               142.250.191.78  text/html           17.4KB       31        53  Google
status       FAIL     -      google.comm                              -               -                    0B          14        14  -

Summary
------------------------------
Total        : 2
Success      : 1
Failure      : 1
REQ average  : 22ms
TIME average : 33ms

Built for practical endpoint diagnostics

Checking Health focuses on the metrics that matter during day-to-day operations, validation, troubleshooting, and release checks.

⚡

Real-time execution

Each endpoint is displayed as soon as its request finishes, so you do not need to wait for the entire list.

📊

Actionable metrics

See HTTP status, response time, total time, download size, title, domain, IP address, and content type.

🎯

Endpoint classification

The first column identifies the endpoint by the last segment of the URL path, making tests easier to scan.

🎨

Professional terminal output

Clean formatting, aligned columns, and colored success and failure lines improve readability immediately.

🧪

Simple to validate

The project fits naturally into CLI workflows and can be tested with pytest and standard automation pipelines.

📦

Easy distribution

Install directly from PyPI and run it as a command-line tool without extra setup or external dependencies.

Install in seconds

Checking Health is published on PyPI and ready to use as a shell command.

Install command
pip install checking-health

Run the CLI

Point the command to a file with one endpoint per line.

Example command
checking-health endpoints.txt --timeout 3

Input file format

Each line should contain a single URL or host.

google.com/health
https://api.example.com/status
service.internal.local/metrics

# comments are ignored
google.comm

What each column means

  • TYPE: last segment of the endpoint path, like health or status.
  • REQ(ms): time until the server starts responding.
  • TIME(ms): total time including content download.
  • SIZE: effective response body size.
  • TITLE: extracted from HTML pages when available.

Why teams use Checking Health

It is useful during deployments, smoke tests, environment validation, quick diagnostics, and everyday API checks.

1

Prepare endpoints

Create an endpoints.txt file with health, status, metrics, or landing URLs.

2

Run the command

Execute the CLI with an optional timeout to adapt the checks to your environment.

3

Read failures fast

Scan colored terminal lines and compare endpoint types, timing, and response characteristics quickly.