Hurry Filesize

0.9 · maintenance · verified Mon Apr 13

Hurry Filesize is a simple Python library, version 0.9, designed to convert a number of bytes into a human-readable string (e.g., '1K', '2M'). First released in 2009, it provides various systems for formatting, including traditional (1024 multipliers), SI (1000 multipliers), and verbose options. Due to its age, it maintains a very low release cadence, with its current version being its initial public release.

Warnings

gotcha The default `size` function and its alternative systems provide integer approximations, which may lead to a loss of precision. For example, `size(1031053)` might return '1M' or '2M' rather than '1.03M'.
Fix: For higher precision or floating-point output, consider alternative libraries like `datasize` or custom formatting functions.
deprecated The library has not been updated since its initial release in 2009. While functional for its core purpose, it lacks modern maintenance and may not be actively supported for new Python features or complex edge cases.
Fix: For new projects, evaluate more recently maintained alternatives that offer similar or extended functionality, such as `hfilesize` or `datasize`.
gotcha The `hurry` package itself is a namespace package, which can sometimes lead to confusion regarding its internal structure or sub-package imports if users expect a traditional package with an `__init__.py` at its root.
Fix: Always import specifically from `hurry.filesize` (e.g., `from hurry.filesize import size`) rather than attempting to import `hurry` directly for `filesize` functionality.

Install

pip install hurry.filesize Install with pip

Imports

size
```
from hurry.filesize import size
```
This imports the primary function for human-readable sizing using the default 'traditional' system (1024 multipliers).
alternative
```
from hurry.filesize import alternative
```
Imports an alternative system constant for more verbose output (e.g., '1 KB', '1 byte').
si
```
from hurry.filesize import si
```
Imports the SI system constant for 1000 multipliers (e.g., '1K' for 1000 bytes).
verbose
```
from hurry.filesize import verbose
```
Imports a verbose system constant for full unit names (e.g., '1 kilobyte', '1 megabyte').

Quickstart

This quickstart demonstrates how to import and use the `size` function with its default 'traditional' system and alternative formatting systems (alternative, SI, verbose) to convert byte values into human-readable strings.

from hurry.filesize import size, alternative, si, verbose

bytes_value = 1024 * 1024 * 3.5 # 3.5 MB

print(f"Default: {size(bytes_value)}")
print(f"Alternative: {size(bytes_value, system=alternative)}")
print(f"SI: {size(bytes_value, system=si)}")
print(f"Verbose: {size(bytes_value, system=verbose)}")

# Example with smaller values
print(f"10 bytes (default): {size(10)}")
print(f"10 bytes (alternative): {size(10, system=alternative)}")
print(f"10 bytes (verbose): {size(10, system=verbose)}")

view raw JSON →