Yumako

Vanilla Python utilities for humans.

What Yumako Includes

• Human-friendly utilities.
• Utilities for generic use cases, not domain-specific.
• High performance utilities.
• Utilities based on vanilla Python with no external dependencies.

Installation

pip install yumako

# Yumako utilities are based on vanilla python: no other dependencies.

Usage

import yumako
# Yumako submodules are loaded only when needed

# ---------------------------------------
# Yumako utilities are highly performant
# ---------------------------------------
from yumako.lru import LRUDict, LRUSet
lru = LRUDict()
lru[1] = True
lru["hello"] = "mortal"
lru["ユマ果"] = "💖"
print(lru)

lru_set = LRUSet()
lru_set.add("ユマ果")
print(lru_set)


# ---------------------------------------
# Yumako utilities are handy
# ---------------------------------------
from yumako.state import state_file

context = state_file(".state")
context.k1 = "v1"   # Persisted to disk
print(context.k1)   # But also cached in RAM


# ---------------------------------------
# Yumako utilities are designed for humans
# ---------------------------------------
print(yumako.time.of("2025-01-17H23:00:00.000-05:00"))  # Popular standard time formats
print(yumako.time.of("-3d"))  # Popular intuitive human-friendly formats

seconds = yumako.time.duration("3m4s")  # "3m4s" -> 184 seconds
delta = timedelta(seconds=seconds)
print(yumako.time.display(delta))  # "3m4s"

More examples.