percentify 0.3.1

A zero-dependency Python toolkit for percentages — calculate, compare, format, and distribute.

% Percentify %

Percentify is a Python package that turns "part of a whole" into a clean percentage.
Stop typing (part / whole) * 100 and worrying about division by zero.

---

✨ What It Does

A zero-dependency Python toolkit for all things percentages:

• percent — what percentage is part of whole?
• change — how much did a value increase or decrease?
• difference — how far apart are two values?
• split — split a total into weighted shares.
• display — turn any number into a clean "25.0%" string.

All functions handle edge cases (division by zero, negative values) safely and let you control decimal precision.

📦 Installation

pip install percentify

Usage

percent — Part of a Whole

from percentify import percent

percent(50, 200)          # → 25.0
percent(1, 3)             # → 33.33
percent(5, 0)             # → 0.0  (safe division by zero)
percent(7, 9, 4)          # → 77.7778  (custom decimals)

change — Increase or Decrease

from percentify import change

change(100, 150)  # → 50.0   (50% increase)
change(200, 150)  # → -25.0  (25% decrease)
change(0, 100)    # → 0.0    (safe when old is zero)

difference — Difference Between Two Values

from percentify import difference

difference(10, 20)      # → 66.67
difference(50, 50)      # → 0.0

split — Split a Total by Weights

from percentify import split

split(200, [1, 3])       # → [50.0, 150.0]
split(100, [1, 1, 1])    # → [33.33, 33.33, 33.33]

display — Format as a String

from percentify import display

display(25.0)                         # → "25.0%"
display(33.3333, 1)                   # → "33.3%"
display(50, suffix=" percent")        # → "50.0 percent"
display(0.45, multiply=True)          # → "45.0%"

Composing Functions

from percentify import change, display

display(change(100, 20))  # → "-80.0%"

🤝 Contributing

Contributions are welcome!

• If you have an idea (extra helpers, bug fixes or an idea):
• Fork this repo
• Create a branch
• Commit your changes
• Open a pull request

I try to keep it within scope, to discuss big new features first.