time-to-sail 0.1.0

UTC-first datetime utilities for Python & ORMs: parse any tz, store as UTC, convert for display.

time-to-sail

UTC-first datetime utilities for Python apps and ORMs.

• Always store timezone-aware UTC datetimes.
• Parse strings in many formats (via python-dateutil) and coerce to UTC.
• Convert for display using IANA zones (zoneinfo).
• SQLAlchemy helpers to force UTC on write/read.

Quickstart

from timetosail import now_utc, to_utc, now_in
from timetosail.sqlalchemy import UTCDateTime, utc_now

dt = now_utc()  # aware UTC
to_utc("2025-09-16 08:30", tzname="America/Lima")

SQLAlchemy

from sqlalchemy.orm import Mapped, mapped_column
from timetosail.sqlalchemy import UTCDateTime, utc_now

fecha_creacion: Mapped[datetime] = mapped_column(
    UTCDateTime(timezone=True), default=utc_now, nullable=False
)

Install Manual

pip install -e .

Build & Publish

pip install build twine
python -m build
python -m twine upload dist/*