---
id: humanfriendly
version: "10.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# humanfriendly — Human friendly output for text interfaces using Python

License: permissive · Maintenance: abandoned · Popularity: top 1,000 on PyPI

## Install

pip install humanfriendly
uv add humanfriendly
poetry add humanfriendly

## Description

humanfriendly: Human friendly input/output in Python
====================================================

.. image:: https://github.com/xolox/python-humanfriendly/actions/workflows/test.yml/badge.svg?branch=master
   :target: https://github.com/xolox/python-humanfriendly/actions

.. image:: https://codecov.io/gh/xolox/python-humanfriendly/branch/master/graph/badge.svg?token=jYaj4T74TU
   :target: https://codecov.io/gh/xolox/python-humanfriendly

The functions and classes in the `humanfriendly` package can be used to make
text interfaces more user friendly. Some example features:

- Parsing and formatting numbers, file sizes, pathnames and timespans in
  simple, human friendly formats.

- Easy to use timers for long running operations, with human friendly
  formatting of the resulting timespans.

- Prompting the user to select a choice from a list of options by typing the
  option's number or a unique substring of the option.

- Terminal interaction including text styling (`ANSI escape sequences`_), user
  friendly rendering of usage messages and querying the terminal for its
  size.

The `humanfriendly` package is currently tested on Python 2.7, 3.5+ and PyPy
(2.7) on Linux...

## AI interpretation — verify before relying

humanfriendly formats and parses numbers, file sizes, timespans, and terminal text in human-readable forms, plus provides interactive prompts and ANSI styling for command-line interfaces.

Verdict: humanfriendly is a mature, permissively licensed utility for text formatting in CLI applications with no known vulnerabilities, but it is abandoned and has not been maintained since 2021. Use it only if its existing feature set meets your needs and you are comfortable with no future updates.

[View on SkillFed](https://skillfed.io/packages/humanfriendly) · [View on PyPI](https://pypi.org/project/humanfriendly/)