🤯 common-sense

This library prevents you from doing stupid things (sometimes).

Installation

pip install common-sense

Quick Usage

from common_sense import *

# Dates
is_weekend(datetime.date.today())
days_until(datetime.date(2025, 12, 31))
pretty_date(datetime.date.today())
next_weekday('Monday')

# Debug
why_none(None)
why_empty([])
why_false(False)
explain_type(42)

# Philosophy
wisdom()
sarcastic('I love bugs')
shrug('It failed')
future_truth()
agree('Python is awesome')
disagree('Monday is the best')

# Life
should_sleep(datetime.time(23, 0))
should_eat(13)
caffeine_needed(0)
hydration_reminder()

# Strings
slugify('Hello World!')
humanize_number(1000)
camel_to_snake('CamelCase')
truncate('Hello world', 5)

# Numbers
safe_divide(10, 0)
percent(2, 8)
clamp(5, 1, 10)
is_prime(7)

# Utils
flatten([[1,2],[3,4]])
unique([1,2,2,3])
chunk([1,2,3,4,5], 2)
first([1,2,3])
last([1,2,3])

Why?

Because common sense is not so common. Now it is — in Python!

Fun Notes

• 100+ witty helpers and one-liners.
• "If it works, don’t touch it."
• "Don’t argue with code — it always wins."
• "This library prevents you from doing stupid things (sometimes)."

Testing

pytest

License

MIT