Metadata-Version: 2.4
Name: lyutil
Version: 0.1.0
Summary: A lightweight collection of everyday Python utilities.
Keywords: utilities,timestamps,filenames
Author: Leyton Addison-Roach
Author-email: Leyton Addison-Roach <git@laddisonroach.com>
License-Expression: MIT
License-File: LICENCE
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.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.14
Project-URL: Repository, https://github.com/leyts/lyutil
Project-URL: Issues, https://github.com/leyts/lyutil/issues
Description-Content-Type: text/markdown

# lyutil

A lightweight collection of everyday Python utilities.

## Modules

### Timestamps

Embed and extract timestamps in filenames.

```python
from pathlib import Path
from lyutil import FileTimestamp
```

**Add a timestamp to a filename:**

```python
>>> result = FileTimestamp.add(Path("backup.tar.gz"))
>>> print(result.file)
backup_2026-02-25_14-30-00.tar.gz
>>> print(result.timestamp)
2026-02-25 14:30:00
```

**Read the timestamp back:**

```python
>>> parsed = FileTimestamp.read(result.file)
>>> print(parsed.file)
backup.tar.gz
>>> print(parsed.timestamp)
2026-02-25 14:30:00
>>> print(parsed.age)
0:00:12.345678
```

## Requirements

Python 3.14+

## Licence

[MIT](LICENCE)
