Metadata-Version: 2.5
Name: develia-pytools
Version: 0.3.0
Summary: General utility library.
Project-URL: Repository, https://bitbucket.org/antonio-gil-espinosa/develia-pytools.py
Author-email: Antonio Gil Espinosa <antonio.gil.espinosa@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# develia-pytools

Librería de utilidades generales para Python 3.11 o superior, sin dependencias externas: colecciones y
consultas encadenadas sobre iterables, concurrencia, medición de tiempos, fechas, E/S binaria y análisis de
números localizados.

## Instalación

```bash
uv add develia-pytools
# o bien
pip install develia-pytools
```

## Uso

### Consultas encadenadas con `Stream`

```python
from develia.pytools.collections import Stream

pedidos = [{"cliente": "ana", "total": 30}, {"cliente": "luis", "total": 12}, {"cliente": "ana", "total": 5}]

(
    Stream(pedidos)
    .filter(lambda p: p["total"] > 10)
    .orderby(lambda p: p["total"], descending=True)
    .map(lambda p: p["cliente"])
    .to_list()
)  # ['ana', 'luis']

[(g.key, g.sum(lambda p: p["total"])) for g in Stream(pedidos).groupby(lambda p: p["cliente"])]
# [('ana', 35), ('luis', 12)]
```

Las operaciones son perezosas y el stream se puede recorrer varias veces; si se crea a partir de un
iterador, los elementos ya leídos se guardan en caché.

### Otras utilidades

```python
from datetime import date, timedelta

from develia.pytools import Lazy, Range, coalesce
from develia.pytools.parsetools import parse_float

config = Lazy(lambda: {"debug": True})  # se crea en el primer acceso a config.value

Range(date(2024, 1, 1), date(2024, 1, 10)).split(timedelta(days=5))
# [Range(2024-01-01, 2024-01-06), Range(2024-01-06, 2024-01-10)]

parse_float("1.234,5", decimal_separator=",", thousands_separator=".")  # 1234.5
coalesce(None, 3)  # 3
```

## Módulos

| Módulo | Contenido |
|---|---|
| `develia.pytools` | `Lazy`, `ThreadLocal`, `Range`, `Result` y funciones auxiliares (`clamp`, `between`, `coalesce`, `evaluate`, `tap`…). |
| `develia.pytools.collections` | `Stream`, `LazySequence`, `CircularQueue`, `BidirectionalDict`, `EnhancedDefaultDict`. |
| `develia.pytools.iteratools` | Funciones sobre iterables: `batch`, `rolling`, `tail`, `groupby`, `prefetch`, `thread_safe_iter`… |
| `develia.pytools.asynctools` | `run` con hilos, procesos o asyncio, y `wait_all` / `wait_all_async`. |
| `develia.pytools.timetools` | `Stopwatch`, `Timer`, `Profiler` y el decorador `profile`. |
| `develia.pytools.triggers` | `TimeTrigger` y `CountTrigger` para ejecutar callbacks por tiempo o por número de comprobaciones. |
| `develia.pytools.datetools` | Inicio y fin de día, conversión a Unix, truncado a intervalos, días del mes. |
| `develia.pytools.mathtools` | Media, extremos, interpolación lineal y redondeos. |
| `develia.pytools.parsetools` | `parse_float` y `parse_int` con separadores configurables. |
| `develia.pytools.strings` | Prefijos, sufijos y pluralización. |
| `develia.pytools.iotools` | Lectura y escritura de ficheros, `ensure_dir` y lectores/escritores binarios con orden de bytes. |
| `develia.pytools.importer` | Importación dinámica de módulos por nombre o desde ficheros. |
| `develia.pytools.console` | Contexto que informa por consola del tiempo que tarda un bloque. |

## Desarrollo

```bash
uv sync
uv run pytest
uv run ruff check
uv run ruff format
uv run mypy
```
