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

Metadata

Release files for lupaxa-expired 0.1.4

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.4
File Size Uploaded
lupaxa_expired-0.1.4.tar.gz 6.1 kB Details

Built distribution (wheel)

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

Total release size: 14.7 kB

Release files / lupaxa_expired-0.1.4.tar.gz

Download URL lupaxa_expired-0.1.4.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9115740c58978ac33c55f4c10171e034232e2d86fce92d1cdc71670600599b88
BLAKE2b-256 checksum
How to use checksums
bec10c3cb0a9f5ae063121c30b0004e9d908768003e24e44ddf928cddb796bb3
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 28, 2026.

Transparency log

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

Download URL lupaxa_expired-0.1.4-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fc58de900445dd0f183d99e1e7ca5dc0a103a58f8c542f2b3a19e739419cd4b6
BLAKE2b-256 checksum
How to use checksums
b8c40677ecffb57c566985154a082ba98fa9d9b34c35a66f133a5b6323eefb21
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 28, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.6

2 release files

0.1.5

2 release files

This release

0.1.4 This release

2 release files

0.1.3

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