blink
Un diagnóstico de calidad de datos, a un comando de distancia.
Blink es una herramienta de terminal que analiza archivos CSV y Parquet locales y muestra problemas de calidad e indicios de anomalías. No requiere configuración previa, no envía datos a servicios externos y no modifica tus archivos.
Qué hace
- Muestra dimensiones y tipos de las columnas.
- Detecta nulos, NaN, filas duplicadas y columnas constantes.
- Señala posibles identificadores de texto.
- Detecta outliers numéricos con IQR.
- Advierte sobre columnas de texto mayormente numéricas o de fechas con valores incompatibles.
- Permite analizar anomalías con IsolationForest mediante
--ml. - Compara columnas, tipos y distribuciones con un archivo anterior mediante
--baseline.
Los resultados aparecen en tablas de terminal, con conteos, cobertura y motivos cuando un análisis se omite. Son indicios para revisar en contexto.
Instalación
Requiere Python 3.11 o superior. Con uv, instalá la app en un entorno aislado y comprobá la ayuda:
uv tool install blink-data-lint
blink --help
El paquete se llama blink-data-lint en PyPI; el comando es blink.
Si acabás de instalar uv y la terminal no encuentra blink, ejecutá
uv tool update-shell y abrí una terminal nueva.
Alternativas: pip o instalación desde el repositorio
Con pip, en macOS/Linux:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install blink-data-lint
blink --help
En Windows, desde PowerShell:
py -3 -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install blink-data-lint
blink --help
Mantené el entorno activo. En una terminal nueva, volvé a activarlo con
source .venv/bin/activate (macOS/Linux) o .venv\Scripts\Activate.ps1 (Windows).
Para trabajar desde el código fuente, necesitás Git:
git clone https://github.com/Gianni300x/blink.git
cd blink
uv sync
uv run blink tests/data/sample_dirty.csv
En este caso, usá uv run blink en lugar de blink en los ejemplos de abajo.
Con pip desde el repositorio, podés usar python -m pip install -e . dentro del
entorno virtual en lugar de instalar el paquete desde PyPI.
Uso
blink datos.csv
blink datos.parquet
Reemplazá datos.csv o datos.parquet por la ruta de tu archivo. Si tiene
espacios, escribila entre comillas: blink "mis datos/ventas.csv".
Para habilitar el análisis con ML:
blink datos.csv --ml
Para comparar con un archivo anterior y detectar cambios de columnas, tipos, medias, distribuciones o proporción de faltantes:
blink datos.csv --baseline anterior.csv
Ambos archivos pueden ser CSV o Parquet. Se comparan columnas por nombre; un cambio de orden no genera un aviso. Los valores se comparan de forma agregada, sin emparejar filas. La salida muestra las métricas, umbrales y cobertura.
Para consultar la ayuda:
blink --help
Para desactivar los colores en macOS/Linux: NO_COLOR=1 blink datos.csv.
Límites de uso
- Archivos locales CSV o Parquet que entren en memoria. CSV requiere UTF-8, comas y una primera fila de cabecera; no se adivinan otros separadores.
- IQR necesita al menos 10 valores numéricos finitos. Si el rango intercuartílico es cero, se omite el detector y se indica el motivo.
- Los tipos rotos requieren al menos 10 textos no vacíos y una mayoría ≥90 %
de números finitos o fechas válidas
YYYY-MM-DD. No se interpretan fechas locales como01/02/2026. - ML necesita al menos 32 filas completas y finitas en sus columnas numéricas elegibles. Si hay más de 32 columnas elegibles, se omite. Evalúa hasta 10.000 filas; por encima toma una muestra y muestra su cobertura, sin extrapolar conteos.
- Nombres como
VendorID,PULocationID,payment_typeocodigo_postalindican posibles códigos o etiquetas. Se omiten de IQR y ML; al comparar archivos se usan frecuencias, no medias o distancias numéricas. Es una heurística por nombre y se informa como tal; no demuestra una clave primaria. - Una anomalía es un indicio, no una prueba de error. Un análisis omitido tampoco equivale a un resultado sin problemas. Revisá los motivos que muestra la salida.
- La comparación de valores requiere tipos idénticos y al menos 100 observaciones elegibles por archivo. Avisa si la media se desplaza ≥0.5 desviaciones estándar del archivo anterior, la distancia de distribución es ≥0.2 (KS en números o variación total en categorías), o los faltantes cambian ≥10 puntos porcentuales. Son umbrales de revisión; no son pruebas de significación estadística. Con desviación anterior cero se omite la comparación de medias, pero se compara la distribución. Las categorías se limitan a 50 valores distintos entre ambos archivos; IDs/texto libre y tipos no compatibles pueden omitir ese análisis.
Integración con otros programas y CI
El uso habitual sigue siendo blink archivo.csv. Si necesitás un informe para
otro programa, agregá --json:
blink datos.csv --json > informe.json
Para hacer fallar una validación automatizada cuando aparezcan avisos:
blink datos.csv --json --exit-code > informe.json
También podés combinarlo con --baseline anterior.csv y --ml. En un paso de CI,
el código de salida determina si continúa o falla la validación:
| Código | Significado |
|---|---|
0 |
Inspección completada; sin --exit-code, los avisos también devuelven 0. |
1 |
Hay avisos y se activó --exit-code. |
2 |
Error de uso, lectura o análisis, con o sin --exit-code. |
Si preferís ver las tablas en el log de CI, usá --exit-code sin --json.
Se consideran avisos los hallazgos de calidad, cambios de esquema y métricas de drift que superan su umbral. Los posibles IDs informativos y los análisis omitidos no hacen fallar CI por sí solos. Dos métricas alertadas en una columna cuentan como dos avisos. Un aviso sigue siendo un indicio para revisar en contexto.
El JSON usa schema_version: "1.0" e incluye analysis, comparison, summary,
error y exit_code, además de los archivos y políticas de lectura en sources.
status: "completed" indica que la ejecución terminó, no que todos los datos sean
correctos. Cada detector indica completed o skipped y su cobertura. Los
errores de lectura/análisis generan status: "error" y un diagnóstico por stderr,
sin informe parcial. Los errores de sintaxis del comando se muestran por stderr
sin generar un documento JSON; comprobá siempre el código de salida.
Si clonaste el repositorio, podés reproducir un fallo de validación con su CSV de ejemplo:
blink tests/data/sample_dirty.csv --json --exit-code > informe.json
Este ejemplo devuelve 1 porque contiene problemas conocidos; el informe JSON
queda disponible para revisar los avisos.
Licencia MIT.
Metadata
Release files for blink-data-lint 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| blink_data_lint-0.1.0.tar.gz | 29.6 kB | With provenance | Details for blink_data_lint-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| blink_data_lint-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for blink_data_lint-0.1.0-py3-none-any.whl |
Total release size: 51.7 kB
Release files / blink_data_lint-0.1.0.tar.gz
| Download URL | blink_data_lint-0.1.0.tar.gz |
|---|---|
| Size | 29.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18113e32b24a16fe1030243c12ce97c0ca0b2d91c7f5ef641eeb5e90b97d3076
|
|
BLAKE2b-256 checksum How to use checksums |
2f7623067bd03a6cae3880556a96d665b0edc0d6a7961366bbca3df205ac4846
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 15, 2026.
Transparency logRelease files / blink_data_lint-0.1.0-py3-none-any.whl
| Download URL | blink_data_lint-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8bfe3aa57f90eda409bfd891f20ebb314a57e5d42730b5e6ea4b47fda92711c3
|
|
BLAKE2b-256 checksum How to use checksums |
9a99eeb421392c02bea75652859eba6acecbaaf42059360c02832e37191b520e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 15, 2026.
Transparency logSecurity for blink-data-lint 0.1.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for blink_data_lint-0.1.0.tar.gz
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 Nov 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.