{"categories":[{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/10"}],"enrichment":{"capability":"Converts datetime, timedelta, and timestamp objects into human-readable time phrases like '1 year, 127 days ago' or 'in 2 days, 3 hours', with customizable precision, tense, and abbreviation.","skillfed_tags":["datetime-formatting","relative-time"],"use_cases":["Display activity timestamps in web interfaces or logs (e.g., 'User commented 2 days, 5 hours ago').","Format scheduled task or job descriptions (e.g., 'Job will run in 3 days, 2 hours from now').","Generate human-friendly uptime or elapsed-time summaries in monitoring dashboards.","Customize time-ago phrases for different contexts or languages via past_tense and future_tense templates.","Build time-unit breakdowns programmatically using delta2dict or extract_components for further processing."],"what_it_does":"ago is a lightweight utility that transforms time intervals into natural-language phrases. It accepts a datetime object (to compute elapsed or future time relative to now), a timedelta object, or a raw timestamp, and produces strings like 'created 1 year, 127 days ago' or 'due in 2 days, 3 hours'. The core function is `human()`, which takes a time input and optional parameters for precision (how many time units to show), tense templates (past/future format strings), and abbreviation (to produce '5d, 3h' instead of '5 days, 3 hours'). It also exposes lower-level functions like `delta2dict()` and `extract_components()` for cases where you need to work with the time breakdown directly rather than a formatted string.\n\nThe package has no external dependencies and installs as a pure Python wheel, making it suitable for embedding in applications that need to display relative timestamps in logs, UI, or API responses. It's particularly useful when you want consistent, customizable phrasing for time intervals without writing your own formatting logic.","worth_installing":"Yes. The package is lightweight, dependency-free, actively maintained (recent release), permissively licensed, and solves a common formatting need. Install it if you need to display relative timestamps in human-readable form; skip it only if you're already using a heavier datetime library that includes this feature."},"id":"ago","links":{"html":"https://skillfed.io/packages/ago","md":"https://skillfed.io/packages/ago.md","pypi":"https://pypi.org/project/ago/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-07-02","license_spdx":null,"license_treatment":"permissive","name":"ago","python_support":"unspecified","summary":"ago: Human readable timedeltas"},"popularity":{"monthly_downloads":104880,"position":12734,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.1.1"}