---
id: hurry-filesize
version: "0.9"
license: ZPL 2.1
license_treatment: unclear
maintenance: abandoned
---

# hurry.filesize — A simple Python library for human readable file sizes (or anything sized in bytes).

License: unclear · Maintenance: abandoned · Downloads: 271.4K/mo

## What it is and what it does

hurry.filesize is a minimal utility that takes a byte count and returns a formatted string representing that size in human-readable units. It supports four formatting systems: the traditional binary system (1024-based multipliers, e.g., '1K' for 1024 bytes), an alternative format with explicit unit labels ('1 KB'), a verbose format spelling out unit names ('1 kilobyte'), and the SI system using 1000-based multipliers. The package has no external dependencies and is purely a formatting function.

The package was released once in 2009 and has received no updates since. It is no longer maintained, meaning it will not be updated for Python compatibility issues, security concerns, or feature requests. For simple byte-to-string conversion, it works as advertised, but its age and abandonment status mean you should evaluate whether a more actively maintained alternative better suits your project's long-term needs.

Use it for:

- Display file sizes in logs or user-facing output without manual unit conversion logic.
- Format download or upload progress indicators with human-readable byte counts.
- Generate storage quota or disk usage reports in readable format for monitoring dashboards.
- Convert API response byte counts to display-friendly strings in CLI tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts byte counts into human-readable file size strings using configurable unit systems (traditional 1024-based, SI 1000-based, verbose, or alternative formats).

No. The package is abandoned (no updates since 2009) and offers only a trivial formatting function that is easy to reimplement or find in actively maintained alternatives. The unclear license and lack of Python version specification add friction. Install only if you are maintaining legacy code already using it and cannot refactor.

## Install

pip install hurry-filesize
uv add hurry-filesize
poetry add hurry-filesize

## Installing hurry.filesize

Before you install: High install friction: the package has been abandoned since its only release on 2009-03-11 and receives no maintenance. No runtime dependencies, but the lack of updates across 6365 days and absence of repository signals suggest it will not receive bug fixes or compatibility updates.

License in practice: License treatment is unclear; the raw license is listed as ZPL 2.1 but without SPDX confirmation. Verify the actual license terms before use in proprietary or GPL-licensed projects.

Quickstart:

from hurry.filesize import size
print(size(1024))  # '1K'
print(size(1024, system='alternative'))  # '1 KB'

Verify before relying:

- Whether ZPL 2.1 is the correct and current license, and what compatibility it has with your project's licensing model.
- Whether the package works with modern Python versions (no requires_python specified in metadata).
- Whether there are known issues or edge cases in the abandoned codebase that affect current use.

## Package facts

- License: ZPL 2.1 (unclear)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 271.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

byte size formatting, human readable file size, convert bytes to KB MB GB, file size string conversion, byte display formatting, size unit conversion, readable storage size, abandoned, formatting

[View on SkillFed](https://skillfed.io/packages/hurry-filesize) · [View on PyPI](https://pypi.org/project/hurry-filesize/)