Metadata-Version: 2.1
Name: calmsize
Version: 0.1.0
Summary: Fork from hurry.filesize, A simple Python library for human readable file sizes (or anything sized in bytes).
Home-page: UNKNOWN
Author: Kaiyu Shi
Author-email: skyisno.1@gmail.com
License: ZPL 2.1
Description: calmsize
        ==============
        [![Build Status](https://travis-ci.com/Stonesjtu/calmsize.svg?token=vyTdxHbi1PCRzV6disHp&branch=master)](https://travis-ci.com/Stonesjtu/calmsize)
        
        ### 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::
        
        ```ipython
        >>> from calmsize import size, ByteSize
        >>> size(1024)
        '1K'
        >>> size(-1024)
        '-1K'
        >>> '{:.2f}'.format(size(-1024))
        '-1.00K'
        ```
        
        An alternative, slightly more verbose system::
        
        ```ipython
        >>> 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::
        
        ```ipython
        >>> 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::
        
        ```ipython
        >>> from calmsize import si
        >>> size(1000, system=si)
        '1K'
        ```
        
        Changes
        =======
        
        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
        ======
        
Keywords: file size bytes
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
