Metadata-Version: 2.4
Name: minimindslab-datetime-span
Version: 0.1.0
Summary: Parse, normalize, and compare simple UTC datetime spans with deterministic formatting.
Author: MiniMindsLab
License: MIT
Keywords: datetime,timespan,utc,iso8601,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# MiniMindsLab DateTime Span

`minimindslab-datetime-span` is a tiny, pure-Python utility for parsing, validating, formatting, and comparing UTC datetime spans.

## Features

- Parse UTC ISO-8601 datetime strings (`Z` or `+00:00`).
- Model spans with inclusive/exclusive boundaries.
- Deterministic canonical formatting.
- Compare spans for overlap, containment, and adjacency.
- CLI that reads from a file or stdin and prints canonicalized spans.

## Span Format

Library and CLI accept bracketed span lines:

- `[START,END]` inclusive start and end
- `(START,END)` exclusive start and end
- `[START,END)` inclusive start, exclusive end
- `(START,END]` exclusive start, inclusive end

Datetimes must be UTC and ISO-like (e.g. `2024-01-02T03:04:05Z`).

Canonical output uses second precision and `Z`, e.g.:

`[2024-01-02T03:04:05Z,2024-01-02T04:04:05Z)`

## CLI

```bash
# From a file
miniminds-datetime-span --file spans.txt

# From stdin
printf '[2024-01-01T00:00:00Z,2024-01-01T01:00:00Z)\n' | miniminds-datetime-span
```

Each non-empty, non-comment line (`# ...`) is parsed and canonicalized.
