dine 0.0.2

Librería y línea de comandos para explorar y exportar datos del Instituto Nacional de Estadística de España

DINE 🦕

Librería y línea de comandos para explorar y exportar datos del Instituto Nacional de Estadística.

🔍 Recursos

• API JSON - API JSON de INE
• Tablas INE - Listado de operaciones estadísticas
• Microdatos INE - Acceso a microdatos de encuestas
• API INE - Documentación de la API
• Tempus3 - Sistema de difusión de información estadística

Puedes explorar la documentación de la API en Markdown en la carpeta docs.

🚀 Instalación

Puedes instalar la librería dine usando uv o pip.

pip install dine

uv add dine

Para instalar dine en el sistema de manera aislada, puedes hacerlo con:

uv tool install dine

🛠️ Uso

La librería dine proporciona una interfaz de línea de comandos para interactuar con los datos del INE.

Operaciones Estadísticas

Listar todas las operaciones estadísticas disponibles:

dine operations list

Obtener información detallada sobre una operación específica:

dine operations get <ID_OPERACION>

Tablas Estadísticas

Listar todas las tablas estadísticas disponibles:

dine tables list

Listar tablas de una operación específica:

dine tables list --operation <ID_OPERACION>

Obtener información detallada sobre una tabla específica:

dine tables info <ID_TABLA>

Descargar una tabla y guardarla en formato Parquet:

dine tables download <ID_TABLA>

Especificar una ruta de salida personalizada:

dine tables download <ID_TABLA> --output ruta/personalizada.parquet

Uso desde Python

También puedes usar DINE directamente desde Python:

import dine

# Listar operaciones
operaciones = dine.list_operations()

# Obtener información de una operación
operacion = dine.get_operation("ID_OPERACION")

# Listar tablas
tablas = dine.list_all_tables()
tablas_por_operacion = dine.list_tables_by_operation("ID_OPERACION")

# Obtener información de una tabla
info_tabla = dine.get_table_info("ID_TABLA")

# Descargar una tabla
ruta_salida = dine.download_table("ID_TABLA", "ruta/salida.parquet")

🔧 Desarrollo

Para contribuir al proyecto, se puede usar el siguiente comando para instalar las dependencias necesarias y ejecutar el proyecto.

make install

📝 Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.