https://github.com/davidgasquez/dine
🦕 Librería y línea de comandos para explorar y exportar datos del Instituto Nacional de Estadística
https://github.com/davidgasquez/dine
datos-abiertos ine open-data
Last synced: 6 months ago
JSON representation
🦕 Librería y línea de comandos para explorar y exportar datos del Instituto Nacional de Estadística
- Host: GitHub
- URL: https://github.com/davidgasquez/dine
- Owner: davidgasquez
- License: mit
- Created: 2024-09-28T16:29:01.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-17T10:07:48.000Z (7 months ago)
- Last Synced: 2025-04-12T03:51:51.190Z (6 months ago)
- Topics: datos-abiertos, ine, open-data
- Language: Python
- Homepage: https://pypi.org/project/dine/
- Size: 126 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DINE 🦕
Pequeña librería y línea de comandos para explorar y exportar datos del [Instituto Nacional de Estadística](https://www.ine.es/).
## 🚀 Instalación
Puedes instalar la librería `dine` usando `uv` (recomendado) o `pip`.
```bash
# Usando uv
uv pip install dine
# Usando pip
pip install dine
```
Puedes tambien instalar `dine` en el sistema de manera aislada con:
```bash
uv tool install dine
```
O, alternativamente, ejecutar los comandos "sin instalación" usando `uvx` (e.g: `uvx):
```bash
uvx dine --help
```
Es la forma más fácil de empezar a usar el proyecto!
## 🛠️ 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:
```bash
dine operations list
```
Obtener información detallada sobre una operación específica:
```bash
dine operations get
```
### Tablas Estadísticas
Listar todas las tablas estadísticas disponibles:
```bash
dine tables list
```
Listar tablas de una operación específica:
```bash
dine tables list --operation
```
Obtener información detallada sobre una tabla específica:
```bash
dine tables info
```
Descargar una tabla y guardarla en formato Parquet:
```bash
dine tables download
```
Especificar una ruta de salida personalizada:
```bash
dine tables download --output ruta/personalizada.parquet
```
### Uso desde Python
También puedes usar DINE directamente desde Python:
```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.
```bash
make install
```
## 📝 Licencia
Este proyecto está bajo la licencia MIT. Ver el archivo [LICENSE](LICENSE) para más detalles.