Skip to main content

Developers Toolbox

Expired

Tiny utility to check whether a timestamp has expired relative to the current UTC time. A value is expired when it is strictly earlier than (now - delta). With no window, delta is zero, so anything before UTC now is expired and a time equal to now is not.

The PyPI name is lupaxa-expired. The import path is lupaxa.expired.

Install

pip install lupaxa-expired

Requires Python 3.10+. No runtime dependencies.

Usage

from datetime import datetime, timezone
from lupaxa.expired import is_expired

if is_expired("2022-10-19 14:43:57.563803"):
    print("Expired")

cutoff = datetime(2025, 11, 6, tzinfo=timezone.utc)
is_expired("2025-10-01", days=3, now=cutoff)

Strings may be SQL-style, ISO-8601 (with or without Z), or date-only. Pass fmt= for a custom strptime format. Naive datetimes are treated as UTC. Keyword parts such as days=3 or an explicit timedelta set the window; years are 365 days and months are 30 days.

expired --time "2022-10-19 14:43:57.563803"
expired --time "2022-10-19 14:43:57.563803" --days 3
expired --version

The CLI prints expired or not expired. Exit 0 means not expired (or --version), 1 means expired, and 2 means bad input.

Documentation

Site pages live in mkdocs/ and publish to https://expired.thelupaxaproject.org/.

make init
make python-install-dev
make mkdocs-serve
The Lupaxa Project Footer

Release files for lupaxa-expired 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lupaxa-expired 0.1.3
File Size Uploaded
lupaxa_expired-0.1.3.tar.gz 6.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lupaxa-expired 0.1.3
File Interpreter ABI Platform
lupaxa_expired-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 14.7 kB

Release files / lupaxa_expired-0.1.3.tar.gz

Download URL lupaxa_expired-0.1.3.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8b5fb08ab7cee4fe551307e3fce1851237c70676666c68a3a196daf33073a850
BLAKE2b-256 checksum
How to use checksums
783276e0e135f8176b163fa4ad0c96917a6b3d4c84df24a63173372b6fa418e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release files / lupaxa_expired-0.1.3-py3-none-any.whl

Download URL lupaxa_expired-0.1.3-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a338e9e93c86cc995675b3a7b7ebe02cdc760899f61d75a5897f3d99fb7a51c4
BLAKE2b-256 checksum
How to use checksums
0b7e28084a07e32213077687eba5945a579de1e3708e1bd7b27f6f646287166c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page