semvec/pypi-packages huggingface dataset:
cobli-libi 0.0.6
Generate dataframes from Cobli public API

# cobli-libi

## About the project

This package generates dataframes using [Cobli's public API](https://docs.cobli.co) as data source.

It was created to enhance the experience of anyone who needs easy-to-use data from his/her Cobli fleet.

Data available in this package:

- Devices
- Checklists
- Proofs of conclusion
- Incidents
- Costs
- Vehicle performance
- Driver performance

### Built with

- [Python](https://www.python.org/)

## Getting Started

### Prerequisites

- Python 3.7 or higher

### Installation

`pip install cobli-libi`

## Usage

```python
from datetime import datetime, timedelta
from libi.dataframes import get_devices_data, get_pocs_data, \
    get_costs_data, get_incidents_data, get_checklist_data, \
    get_driver_performance_data, get_vehicle_performance_data

fleet_data = {'Fleet Name': '<fleet_api_key>', 'Another Fleet': '<another_fleet_api_key'}
start_datetime = datetime.now() - timedelta(days=5)
end_datetime = datetime.now()

devices = get_devices_data(fleet_data)
checklists = get_checklist_data(fleet_data)
proofs_of_conclusion = get_pocs_data(fleet_data, start_datetime, end_datetime)
costs = get_costs_data(fleet_data, start_datetime, end_datetime)
incidents = get_incidents_data(fleet_data, start_datetime, end_datetime)
vehicle_performance = get_vehicle_performance_data(fleet_data, start_datetime, end_datetime)
driver_performance = get_driver_performance_data(fleet_data, start_datetime, end_datetime)
```

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## Deploy

This project is in [Pypi](https://pypi.org/manage/project/cobli-libi/releases/).

In order to deploy this project, the first action needed is bump the version in the file `setup.py`.

Then, you will have to install build with this command:

`python3 -m pip install --upgrade build`

After this, you will need to build the project with this command:

`python3 -m build`

Then, you will have to install twine with this command:

`python3 -m pip install --upgrade twine`.

Finally, you can deploy in pypi using this command:

`python3 -m twine upload dist/*`

The credentials needed for this command are stored in 1Password by the key _Admin-Pypi_.

## Contact

Project Link: [https://github.com/cobliteam/cobli-libi](https://github.com/cobliteam/cobli-libi)
soypedroamaya 0.0.1
A small example package
Requires Python: >=3.7

1. bajar el repositorio
      - git clone https://github.com/soypedroamaya/docker-ubuntu-python-pkgs.git    
2. nos metemos dentro del repo
      - cd docker-ubuntu-python-pkgs
3. construimos la imagen
      - docker build -t img-docker-ubuntu-python-pkgs .

4. construimos el contenedor basado en la imagen, con interaccion en la terminal y pegada a nuestro directorio local 
      - docker run --name cnt-docker-ubuntu-python-pkgs -it -v $(pwd):/docker-ubuntu-python-pkgs img-docker-ubuntu-python-pkgs bash

4.1 nos conectamos desde visual studio y con la extension "dev containers" a nuestro contenedor corriendo

5. nos movemos a la rama que necesitemos:
    - git checkout exp

6. creamos el entorno virtual de la rama
    - python3.10 -m venv exp

7. activamos el entorno virtual anterior
    - source exp/bin/activate

8. bajamos las librerias necesarias y que estan segun la rama
    - pip install --no-cache-dir -r requirements.txt

    - (opcional) => pip freeze > requirements.txt
    nota: para sacar una lista con las versiones exactas de las librerias que ocupa ese entorno.

9. creamos las librerias externas
    - npm install

------- conf de sphinx ----
mkdir docs -> en la raiz del proyecto
cd docs
sphinx-quickstart -> llenar las preguntas (aqui me quede...)
cd .. -> te salis hasta el directorio raiz
sphinx-apidoc -o docs .
cd docs

-- agregar la palabra "modules" en el archivo index.rst, en el area del toctree

make html
meter en un browser:
file:///Volumes/MicroSD4GB/Codigo/public/soypedroamaya/docker-ubuntu-python-pkgs/docs/_build/html/index.html


-- commitizen
primera vez
    cz bump --yes --changelog  

-- build
python3 -m pip install --upgrade build
python3 -m build
python3 -m pip install --upgrade twine
python3 -m twine upload --repository pypi dist/*

python3 -m twine upload --repository testpypi dist/*