Skip to main content

Fork from hurry.filesize, A simple Python library for human readable file sizes (or anything sized in bytes).

Project description

calmsize

Build Status PyPI PyPI download month

NOTICE

I forked the repo from source file downloaded from pip hurry.filesize. That simple library is very useful when debugging memory issues, but unfortunately out-of-maintainance since 2009, so I decided to fork the great work of Martijn Faassen, Startifact.

Intro

calmsize a simple Python library that can take a number of bytes and returns a human-readable string with the size in it, in kilobytes (K), megabytes (M), etc.

The default system it uses is "traditional", where multipliers of 1024 increase the unit size::

>>> from calmsize import size, ByteSize
>>> size(1024)
'1K'
>>> size(-1024)
'-1K'
>>> '{:.2f}'.format(size(-1024))
'-1.00K'

An alternative, slightly more verbose system::

>>> from calmsize import alternative
>>> size(1, system=alternative)
'1 byte'
>>> size(10, system=alternative)
'10 bytes'
>>> size(1024, system=alternative)
'1 KB'

A verbose system::

>>> from calmsize import verbose
>>> size(10, system=verbose)
'10 bytes'
>>> size(1024, system=verbose)
'1 kilobyte'
>>> size(2000, system=verbose)
'1 kilobyte'
>>> size(3000, system=verbose)
'2 kilobytes'
>>> size(1024 * 1024, system=verbose)
'1 megabyte'
>>> size(1024 * 1024 * 3, system=verbose)
'3 megabytes'

You can also use the SI system, where multipliers of 1000 increase the unit size::

>>> from calmsize import si
>>> size(1000, system=si)
'1K'

Changes

0.1.2 (2019-05-27)

  • Fix pip install fail of python2.7

0.1.1 (2019-05-25)

  • Fix pip install filenotfound error

0.1.0 (2019-05-24)

  • Add support for negative input
  • Add support for format the leading number
  • Add ByteSize as a new class
  • Add support for comparing between two Bytesize, ByteSize and numbers

0.0.1 (2019-05-24)

  • Forked from hurry.filesize

Download

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

calmsize-0.1.3.tar.gz (3.7 kB view hashes)

Uploaded Source

Supported by

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