humanfriendly

https://github.com/xolox/python-humanfriendly
Admin
humanfriendly is a Python library for making text interfaces more user-friendly by parsing and...
Tokens:2,211
Snippets:17
Trust Score:7.5
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Getting started with humanfriendly: format_size and parse_size

Source: https://github.com/xolox/python-humanfriendly/blob/master/README.rst

Shows how to import and use format_size and parse_size from the humanfriendly package. The example prompts the user for a readable file size, parses it to bytes, and formats it in both decimal and binary units. The output demonstrates that '16G' parses to 16000000000 bytes and formats as '16 GB' or '14.9 GiB' with binary=True.

```python
>>> from humanfriendly import format_size, parse_size
>>> from humanfriendly.prompts import prompt_for_input
>>> user_input = prompt_for_input("Enter a readable file size: ")

  Enter a readable file size: 16G

>>> num_bytes = parse_size(user_input)
>>> print(num_bytes)
16000000000
>>> print("You entered:", format_size(num_bytes))
You entered: 16 GB
>>> print("You entered:", format_size(num_bytes, binary=True))
You entered: 14.9 GiB
```

--------------------------------

### Traceback for ModuleNotFoundError: distutils.spawn

Source: https://github.com/xolox/python-humanfriendly/blob/master/CHANGELOG.rst

A traceback encountered on Python 3.6 installations based on native Ubuntu/Debian packages due to missing distutils.spawn.

```text
Traceback (most recent call last):
  File "...", line 1, in <module>
    from coloredlogs.syslog import enable_system_logging
  File ".../coloredlogs/__init__.py", line 138, in <module>
    from humanfriendly import coerce_boolean
  File ".../humanfriendly/__init__.py", line 25, in <module>
    from humanfriendly.tables import format_pretty_table as format_table
  File ".../humanfriendly/tables.py", line 32, in <module>
    from humanfriendly.terminal import (
  File ".../humanfriendly/terminal.py", line 26, in <module>
    import distutils.spawn
ModuleNotFoundError: No module named 'distutils.spawn'
```

--------------------------------

### Check distutils.spawn availability via ls

Source: https://github.com/xolox/python-humanfriendly/blob/master/CHANGELOG.rst

A console command used to verify the availability of the distutils.spawn module across multiple installed Python versions.

```console
$ ls -l /usr/lib/python*/distutils/spawn.py
-rw-r--r-- 1 root root 8.5K Nov  7 11:07 /usr/lib/python2.7/distutils/spawn.py
-rw-r--r-- 1 root root 7.4K Mar 29  2019 /usr/lib/python3.4/distutils/spawn.py
-rw-r--r-- 1 root root 7.3K Nov 24 02:35 /usr/lib/python3.5/distutils/spawn.py
-rw-r--r-- 1 root root 7.3K Oct 28 17:30 /usr/lib/python3.6/distutils/spawn.py
-rw-r--r-- 1 root root 7.7K Oct 28 17:30 /usr/lib/python3.7/distutils/spawn.py
-rw-r--r-- 1 root root 7.7K Oct 28 17:30 /usr/lib/python3.8/distutils/spawn.py
```

--------------------------------

### Run humanfriendly demo command

Source: https://github.com/xolox/python-humanfriendly/blob/master/README.rst

Command to run a demonstration of supported terminal text styles based on ANSI escape sequences.

```bash
$ humanfriendly --demo
```
Tokens:
Raw