Skip to main content

A simple and light DB package

Project description

# instadb

A simple a light DB python package

## Features
- query from postgres and reshift
- load data into pandas dataframe
- query from sql or filename
- automatically setup connections from env variables
- automatic query annotation
- connect timeout retry with exponential backoff

### Installation

`pip install instadb`

### Basic Usage

```python
import instadb
db = instadb.Connection(url=database_url)
df = db.dataframe("select * from users limit 10")
```

If you have env variables that match the pattern `<key>_DATABASE_URL` then you can directly do:

```python
import instadb
df = instadb.key.dataframe("select * from users limit 10")
```

### Query from file

```python
df = instadb.key.dataframe(filename='./users.sql')
```

### Query from file with arguments

users.sql
```
select * from users where limit={limit}
```

```python
df = instadb.key.dataframe(filename='./users.sql', limit=100)
```

## TODO
- [ ] load data to list
- [ ] insert and update queries
- [ ] caching


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instadb-0.4.1.tar.gz (3.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

instadb-0.4.1-py2.py3-none-any.whl (5.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file instadb-0.4.1.tar.gz.

File metadata

  • Download URL: instadb-0.4.1.tar.gz
  • Upload date:
  • Size: 3.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for instadb-0.4.1.tar.gz
Algorithm Hash digest
SHA256 61d8b8bdacbfd17448e4a2f54104ad0341a05d43c72545a1dc42129de28adb82
MD5 fe9e222b19471c3a5bf5ba75eba1e7df
BLAKE2b-256 4841b9d0112d742afe751cdd8a908eec3f6d86cd89a206bf105a446b72926c08

See more details on using hashes here.

File details

Details for the file instadb-0.4.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for instadb-0.4.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 de270d3965a2fb0dfd3d74a97580cb436879e873ba274255a4cb14e7f7aa26b1
MD5 c4be42400fe94f81c92b8be1426d02fa
BLAKE2b-256 98e0b105bf09b64987689dffa22ed3e75341afbd7ca8819b9d61b8b687d98815

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page