Metadata-Version: 2.1
Name: muttlib
Version: 1.3.0
Summary: Collection of helper modules by Mutt Data.
Home-page: UNKNOWN
Author: Mutt Data
Author-email: info@muttdata.ai
License: UNKNOWN
Keywords: data pandas spark data-analysis database data-munging
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Provides-Extra: pyarrow
Provides-Extra: oracle
Provides-Extra: hive
Provides-Extra: postgres
Provides-Extra: mysql
Provides-Extra: sqlserver
Provides-Extra: mongo
Provides-Extra: snowflake
Provides-Extra: teradata
Provides-Extra: trino
Provides-Extra: bigquery
Provides-Extra: ibis
Provides-Extra: gdrive
Provides-Extra: dev
Provides-Extra: test
Provides-Extra: forecast
Provides-Extra: gsheets
Provides-Extra: all
License-File: LICENCE

# muttlib 🐶📚

[![pipeline status](https://gitlab.com/mutt_data/muttlib/badges/master/pipeline.svg)](https://gitlab.com/mutt_data/muttlib/-/commits/master)[![coverage report](https://gitlab.com/mutt_data/muttlib/badges/master/coverage.svg)](https://gitlab.com/mutt_data/muttlib/-/commits/master)[![pypi version](https://img.shields.io/pypi/v/muttlib?color=blue)](https://pypi.org/project/muttlib/)

## Description

Library with helper code to start a data-related project.
By [Mutt Data](https://muttdata.ai/).

Current modules:

- `dbconn`: Somewhat homogeneus lib to access multiple DBs.
- `file_processing`: Helpers for concurrent file processing.
- `forecast`: Provides FBProphet a common interface to Sklearn and general
  utilities for forecasting problems, allowing wider and easier grid search for
  hyperparameters.
- `utils`: A single version of miscellaneous functions needed every now and then.
- `gsheetsconn`: Module to make data interactions to/from Google Sheets <> Pandas.
- `gdrive`: Module that provides a UNIX-ish interface to GDrive.

## Table of Contents

- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [Credits](#contributing)
- [License](#license)

### Installing from PyPi

Base lib:
```bash
pip install muttlib
```

Check below for available extras.

Parquet and Feather support:
```bash
pip install muttlib[pyarrow]
```

Forecast:
```bash
pip install muttlib[forecast]
```

Misc DB support for dbconn:
```bash
pip install muttlib[oracle]
pip install muttlib[hive]
pip install muttlib[postgres]
pip install muttlib[mysql]
pip install muttlib[sqlserver]
pip install muttlib[mongo]
pip install muttlib[ibis]
```

### Installing custom branches from the repos

From GitHub mirror:
```bash
pip install -e git+https://github.com/MuttData/muttlib.git@AWESOME_FEATURE_BRANCH#egg=muttlib
```

From Gitlab main repo:
```bash
pip install -e git+https://gitlab.com/mutt_data/muttlib.git@AWESOME_FEATURE_BRANCH#egg=muttlib
```

## Usage

See the [documentation](https://mutt_data.gitlab.io/muttlib/) to get started with `muttlib`.

## Contributing

We appreciate for considering to help out maintaining this project. If you'd like to contribute please read our [contributing guidelines](CONTRIBUTING.md).

## Credits

- Aldo Escobar
- Alejandro Rusi
- Cristián Antuña
- Eric Rishmuller
- Fabian Wolfmann
- Gabriel Miretti
- Javier Mermet
- Jose Castagnino
- Juan Pampliega
- Luis Alberto Hernandez
- Mateo de Monasterio
- Matías Battocchia
- Pablo Lorenzatto
- Pedro Ferrari
- Santiago Hernandez

## License
`muttlib` is licensed under the [Apache License 2.0](LICENCE).


