Metadata-Version: 2.1
Name: kynegos_easy_cloud
Version: 1.0.3
Summary: Automatización de procesos de Data para Kynegos
Home-page: https://gitlab.com/GabiAnt95/kynegoeasy-dataflow
Author: Kynegos - Capital Energy
Author-email: digital.data@capitalenergy.com
License: Kynegos License
Classifier: Programming Language :: Python :: 3
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE


# Kynegos Easy Cloud

`kynegos_easy_cloud` es una colecciÃ³n de funciones genÃ©ricas diseÃ±adas para simplificar las operaciones con Google Cloud Platform (GCP). Este paquete facilita la interacciÃ³n con servicios como Google Cloud Storage, BigQuery, y otros componentes clave de GCP, permitiendo a los desarrolladores integrar estas herramientas de manera mÃ¡s eficiente en sus proyectos.

Creada por la empresa Kynegos, una plataforma de negocios intersectoriales que integra el vehÃ­culo inversor de Capital Energy.

## Licencia

Este proyecto estÃ¡ licenciado bajo la Kynegos License. Para mÃ¡s detalles, consulta el archivo [LICENSE](./LICENSE).


## InstalaciÃ³n

Para instalar el paquete, utiliza pip:

```bash
pip install kynegos_easy_cloud
```

## ActualizaciÃ³n

Para instalar el paquete, utiliza pip:

```bash
pip install --upgrade kynegos_easy_cloud
```

## Uso

### Importar el Paquete

Para comenzar a utilizar las funciones disponibles, simplemente importa el paquete en tu script de Python:

```python
import kynegoes_easy_dataflow.Kynegos_functions as KYNEGOS_FUNCTIONS
```

### ExploraciÃ³n de Funciones

Para ver quÃ© funciones estÃ¡n disponibles en el paquete, puedes utilizar la funciÃ³n `dir()` de Python:

```python
print(dir(KYNEGOS_FUNCTIONS))
```

Esto te mostrarÃ¡ una lista de todas las funciones disponibles en `kynegos_easy_cloud`.

### Ejemplo de Uso

Cada funciÃ³n en el paquete estÃ¡ diseÃ±ada para realizar una tarea especÃ­fica en GCP. AquÃ­ te mostramos un ejemplo bÃ¡sico de cÃ³mo utilizar una de las funciones para cargar un archivo a Google Cloud Storage:

```python
# Ejemplo de cÃ³mo subir un archivo a Google Cloud Storage
KYNEGOS_FUNCTIONS.upload_to_gcs(bucket_name='nombre_del_bucket', source_file='ruta/del/archivo.txt', destination_blob='carpeta/archivo.txt')
```

### DocumentaciÃ³n de Funciones

Para obtener detalles sobre cÃ³mo usar cada funciÃ³n, puedes consultar la documentaciÃ³n inline mediante `help()`:

```python
help(KYNEGOS_FUNCTIONS.upload_to_gcs)
```

Esto te proporcionarÃ¡ una descripciÃ³n detallada de los parÃ¡metros y el propÃ³sito de la funciÃ³n.

## Contribuciones

Si deseas contribuir a este proyecto, por favor, envÃ­e un correo mediante la plataforma Pypy.org

## Posibles Problemas

### SoluciÃ³n a posibles problemas con `ogr2ogr`

Si al ejecutar el paquete encuentras problemas relacionados con `ogr2ogr`, sigue estos pasos para instalar correctamente GDAL en tu entorno:

#### Paso 1: Actualizar los repositorios e instalar `gdal-bin`

Ejecuta los siguientes comandos en una celda de cÃ³digo o en tu terminal:

```bash
# Actualizar la lista de paquetes
!apt-get update

# Instalar gdal-bin y libgdal-dev
!apt-get install -y gdal-bin libgdal-dev
```

##### ExplicaciÃ³n:
- **gdal-bin**: Este paquete incluye las herramientas de lÃ­nea de comandos de GDAL, como `ogr2ogr`, `gdal_translate`, entre otras.
- **libgdal-dev**: Proporciona los archivos necesarios para desarrollar o compilar extensiones que dependen de GDAL.

#### Paso 2: Verificar que `ogr2ogr` estÃ¡ instalado

DespuÃ©s de la instalaciÃ³n, verifica que `ogr2ogr` estÃ¡ disponible ejecutando el siguiente comando en tu terminal o celda de cÃ³digo en Python:

```bash
!ogr2ogr --version
```

La salida deberÃ­a ser algo como:

```bash
GDAL 3.4.1, released 2021/12/27
```

#### Paso 3: Verificar en Python que `ogr2ogr` estÃ¡ en el `PATH`

Para asegurarte de que `ogr2ogr` estÃ¡ en el `PATH` y accesible desde Python, ejecuta el siguiente cÃ³digo:

```python
import shutil
print(shutil.which('ogr2ogr'))
```

La salida deberÃ­a ser algo como:

```bash
/usr/bin/ogr2ogr
```

Esto confirma que `ogr2ogr` estÃ¡ disponible en tu entorno y que Python puede encontrarlo correctamente.


