https://github.com/learning-the-computers/dot-connect

Improve your workflow efficiency by connecting to databases and cloud systems effortlessly.
https://github.com/learning-the-computers/dot-connect

aws azure impala mssql mysql postgres pyspark snowflake snowpark

Last synced: about 11 hours ago
JSON representation

Improve your workflow efficiency by connecting to databases and cloud systems effortlessly.

• Host: GitHub
• URL: https://github.com/learning-the-computers/dot-connect
• Owner: learning-the-computers
• License: apache-2.0
• Created: 2023-08-14T23:23:00.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-26T16:29:01.000Z (about 1 month ago)
• Last Synced: 2024-09-23T06:32:05.421Z (4 days ago)
• Topics: aws, azure, impala, mssql, mysql, postgres, pyspark, snowflake, snowpark
• Language: Python
• Homepage: https://dot-connect.dev
• Size: 169 KB
• Stars: 12
• Watchers: 1
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


  




-----------------

# dot-connect

[![pytest + coverage](https://github.com/learning-the-computers/dot-connect/actions/workflows/pytest_cov.yml/badge.svg)](https://github.com/learning-the-computers/dot-connect/actions/workflows/pytest_cov.yml)

[![codecov](https://codecov.io/github/learning-the-computers/dot-connect/graph/badge.svg?token=BRBGOLAYLE)](https://codecov.io/github/learning-the-computers/dot-connect)

[![PyPI](https://img.shields.io/pypi/v/dot-connect.svg)](https://pypi.org/project/dot-connect)

A Python package designed to simplify the way you fetch connection configurations and establish connections to various databases and cloud systems.

## 🚀 Features

- **Unified Interface**: Say goodbye to juggling multiple APIs. Enjoy a standardized interface, making connecting with various databases and cloud providers easier.

- **Easy Configuration**: Fetch connection configurations with ease. `dot_connect` supports various sources like JSON files, environment variables, and more, ensuring flexibility and adaptability for your projects.

- **Supported Backends**: Out-of-the-box support for popular systems such as MySQL, Postgres, and Snowflake. We're continuously working to expand this list.

- **Extensibility**: Designed with developers in mind, it's easy to extend and customize `dot_connect` for your needs.

## 📦 Installation (PyPI)

```bash

pip install dot-connect

```

## 🔧 Usage

Using `dot_connect` is intuitive and straightforward.

### Getting Things Set Up

Before you begin, you can configure your environment variables by using a `.env` file or an alternative method. Additionally, you can utilize default authorization patterns supported by your chosen backend. `dot-connect` will prioritize credentials in a `.env` file.

Below are step-by-step examples of how you can connect and query various backends:

#### Snowflake

```python

import dot_connect

con = dot_connect.snowflake.connect()

print(con.cursor().execute("SELECT 1;").fetchall())

```

#### MySQL

```python

import dot_connect

con = dot_connect.mysql.connect()

cursor = con.cursor()

cursor.execute("SELECT 1")

result = cursor.fetchall()

print(result)

```

#### PostgreSQL

```python

import dot_connect

con = dot_connect.postgres.connect()

cursor = con.cursor()

cursor.execute("SELECT 1")

result = cursor.fetchall()

print(result)

```

## 🤝 Contributing

We welcome contributions from the community. Whether it's a bug report, a new feature, or an improvement, your insights will help make `dot_connect` even better. For more details, please see our [contributing guidelines](docs/CONTRIBUTING.md).

## ⚖️ License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.