Metadata-Version: 2.1
Name: doltpy
Version: 2.0.6
Summary: A Python package for using Dolt database via Python.
Home-page: https://github.com/dolthub/doltpy
Keywords: Dolt,Liquidata,DoltHub,ETL,ELT,MLOps
Author: Oscar Batori
Author-email: oscar@dolthub.com
Requires-Python: >=3.6.1,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Provides-Extra: oracle
Provides-Extra: pg
Requires-Dist: SQLAlchemy (==1.3.18)
Requires-Dist: attrs (==19.3.0)
Requires-Dist: decorator (==4.4.2)
Requires-Dist: doltcli (>=0.1.4,<0.2.0)
Requires-Dist: more-itertools (>=8.6.0,<9.0.0)
Requires-Dist: mysql-connector-python (>=8.0.20,<9.0.0)
Requires-Dist: numpy (==1.19.0)
Requires-Dist: packaging (==20.4)
Requires-Dist: pandas (>=1.0.5)
Requires-Dist: pluggy (==0.13.1)
Requires-Dist: protobuf (==3.12.2)
Requires-Dist: psutil (==5.7.2)
Requires-Dist: py (==1.9.0)
Requires-Dist: pyparsing (==2.4.7)
Requires-Dist: python-dateutil (==2.8.1)
Requires-Dist: pytz (==2020.1)
Requires-Dist: retry (==0.9.2)
Requires-Dist: six (==1.15.0)
Requires-Dist: wcwidth (==0.2.5)
Description-Content-Type: text/markdown

## DoltPy
This is DoltPy, the Python API for [Dolt](https://github.com/dolthub/dolt). Python is the language of choice for data science and data engineering, and thus we thought it would be wise to publish an API for building automated workflows on top of Dolt and [DoltHub](https://www.dolthub.com/), a collaboration platform for Dolt databases.

## Installation
You need to install Dolt, which is documented [here](https://www.dolthub.com/docs/tutorials/installation/). It's easy for *nix users:
```
$ sudo bash -c 'curl -L https://github.com/liquidata-inc/dolt/releases/latest/download/install.sh | sudo bash'
```
We also distribute Dolt as a Homebrew formula:
```
$ brew install dolt
```
Finally, for Windows users our release page has `.zip` and `.msi` files.

Once Dolt is installed you can install Doltpy using `pip`:
```
$ pip install doltpy
```

## Overview
Doltpy is broken up into modules. 

### `doltpy.cli`
This is the most important module. It effectively wraps the Dolt command-line-interface (CLI) that is exposed by the Go binary. The CLI is exposed more or less exactly as it is implemented, returning wrapper objects where appropriate.

#### `doltpy.cli.read` and `doltpy.cli.write`
These modules provide basic read and write interfaces for reading and writing a variety of tabular data formats, including:
- CSV files
- `pandas.DataFrame`
- columns, that is dictionaries of lists, i.e. `{'col': [...vals...], ...}`
- rows, that is lists of dictionaries, i.e. `[{'col': val, ...}, ...]`

### `doltpy.sql`
This module provides tools for interacting with Dolt via a Python based SQL connector. The most important class is `DoltSQLContext`, which has concrete subclasses `DoltSQLServerContext` and `DoltSQLEngineContext`. `DoltSQLServerContext` is for users that want to write Python scripts that use and manage the Dolt SQL Server instance as a child process. `DoltSQLEngineContext` is for users who want to interact with a remote Dolt SQL Server.

These classes have equivalents of the read and write functions in `doltpy.cli.read` and `doltpy.cli.write` for writing CSV files, `pandas.DataFrame` objects, rows, and columns.

#### `doltpy.sql.sql_sync`
This package provides tools for syncing data to and from Dolt, and other relational databases. Currently there is support for MySQL, Postgres, and Oracle. You can find a more detailed description of how to use SQL Sync tools [here](https://docs.dolthub.com/guides/sql-sync).

### `doltpy.etl`
This module provides a set of tools for scripting ETL/ELT workflows. At Liquidata we use it internally to push datasets onto DoltHub.

## More Information
As alluded to above, you can find a more detailed description of Doltpy [here](https://docs.dolthub.com/reference/python/).

