https://github.com/pykit3/k3num

Convert number to human readable format in a string.
https://github.com/pykit3/k3num

digit human integer number readable

Last synced: 4 months ago
JSON representation

Convert number to human readable format in a string.

• Host: GitHub
• URL: https://github.com/pykit3/k3num
• Owner: pykit3
• License: mit
• Created: 2020-05-26T08:19:55.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-08-28T12:37:43.000Z (9 months ago)
• Last Synced: 2025-10-30T02:59:19.592Z (7 months ago)
• Topics: digit, human, integer, number, readable
• Language: Python
• Homepage: https://blog.openacid.com
• Size: 46.9 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# k3num

[![Build Status](https://github.com/pykit3/k3num/actions/workflows/python-package.yml/badge.svg)](https://github.com/pykit3/k3num/actions/workflows/python-package.yml)

[![Documentation Status](https://readthedocs.org/projects/k3num/badge/?version=stable)](https://k3num.readthedocs.io/en/stable/?badge=stable)

[![Package](https://img.shields.io/pypi/pyversions/k3num)](https://pypi.org/project/k3num)

Convert number to human readable format in a string.

k3num is a component of [pykit3] project: a python3 toolkit set.

k3num convert numbers(or numbers in `dict` or `list`) to human readable

format in string::

    >>> readable(103425)

    '101.0K'

    >>> readable({ 'total': 10240, 'progress': [1, 1024*2.1, 1024*3.2], })

    {'total': '10K', 'progress': ['1', '2.10K', '3.20K']}

    >>> parsenum('5.2K')

    5324.8

    >>> parsenum('10%')

    0.1

Attributes:

    value_to_unit(dict): map of int to unit, e.g.: `1024 -> "K"`, `1024² -> "M"`.

        Usage::

            >>> value_to_unit[1024**2]

            'M'

            >>> unit_to_value['K']

            1024

    unit_to_value(dict): reverse map of `value_to_unit`.

k3num.Hex provides hex integer with arithmatic support.

Different ways to create a 4-byte crc32 hex str::

    >>> Hex(0x0102, 4)

    '00000102'

    >>> Hex(0x0102, 'crc32')

    '00000102'

    >>> Hex.crc32(0x0102)

    '00000102'

    >>> Hex('00000102', 'crc32')

    '00000102'

    >>> Hex.crc32('00000102')

    '00000102'

Create with a tuple of prefix and a filling byte::

    >>> Hex(('12', 1), 'crc32')

    '12010101'

Arithmetic operations::

    >>> Hex(0x0102, 'crc32') + 1

    '00000103'

    >>> Hex(0x0102, 'crc32') * 2

    '00000204'

    >>> Hex(0x0102, 'crc32') - 1000000

    '00000000'

    >>> Hex(0x0102, 'crc32') * 1000000000

    'ffffffff'

Iterate over sha1 space with a specific step::

    >>> Hex.sha1(0) + Hex.sha1(('10', 0))

    '1000000000000000000000000000000000000000'

    >>> Hex.sha1(0) + Hex.sha1(('10', 0)) * 2

    '2000000000000000000000000000000000000000'

# Install

```

pip install k3num

```

# Synopsis

```python

>>> readable(103425)

'101.0K'

>>> readable({ 'total': 10240, 'progress': [1, 1024*2.1, 1024*3.2], })

{'total': '10K', 'progress': ['1', '2.10K', '3.20K']}

>>> parsenum('5.2K')

5324.8

>>> parsenum('10%')

0.1

>>> value_to_unit[1024**2]

'M'

>>> unit_to_value['K']

1024

>>> Hex(0x0102, 4)

'00000102'

>>> Hex(0x0102, 'crc32')

'00000102'

>>> Hex.crc32(0x0102)

'00000102'

>>> Hex('00000102', 'crc32')

'00000102'

>>> Hex.crc32('00000102')

'00000102'

>>> Hex(('12', 1), 'crc32')

'12010101'

>>> Hex(0x0102, 'crc32') + 1

'00000103'

>>> Hex(0x0102, 'crc32') * 2

'00000204'

>>> Hex(0x0102, 'crc32') - 1000000

'00000000'

>>> Hex(0x0102, 'crc32') * 1000000000

'ffffffff'

>>> Hex.sha1(0) + Hex.sha1(('10', 0))

'1000000000000000000000000000000000000000'

>>> Hex.sha1(0) + Hex.sha1(('10', 0)) * 2

'2000000000000000000000000000000000000000'

```

#   Author

Zhang Yanpo (张炎泼) 

#   Copyright and License

The MIT License (MIT)

Copyright (c) 2015 Zhang Yanpo (张炎泼) 

[pykit3]: https://github.com/pykit3