Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prprprus/pymysqlpool
PyMySQL-based database connection pool.
https://github.com/prprprus/pymysqlpool
connection-pool mysql pymysql python
Last synced: 1 day ago
JSON representation
PyMySQL-based database connection pool.
- Host: GitHub
- URL: https://github.com/prprprus/pymysqlpool
- Owner: prprprus
- License: mit
- Created: 2018-12-04T12:40:51.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T19:29:48.000Z (6 months ago)
- Last Synced: 2024-11-13T11:14:44.831Z (1 day ago)
- Topics: connection-pool, mysql, pymysql, python
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 60
- Watchers: 4
- Forks: 21
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyMySQLPool
[](https://travis-ci.org/zongzhenh/PyMySQLPool.svg?branch=master) [](https://codecov.io/gh/zongzhenh/PyMySQLPool) [](https://img.shields.io/badge/pip-v18.1-blue.svg) [](./LICENSE)
PyMySQLPool is a pymysql-based database connection pool, simple and lightweight.
Table of content
- [Features](https://github.com/zongzhenh/PyMySQLPool#features)
- [Requirements](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#requirements)
- [Installation](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#installation)
- [Example](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#example)
- [Roadmap](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#roadmap)
- [Resources](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#resources)
- [License](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#license)
- [Contributing](https://github.com/zongzhenh/PyMySQLPool/blob/master/README.md#contributing)
## Features
- Maintain a minimum number of connection pools by default.
- If a number of unuse connections less than zero, dynamically add connections to pool until the current number of inuse connections equal maximum of the pool.
- Release the idle connections in regular until a number of unuse connections equal minimum of the pool.
- Support auto-commit mode.
- Support for ping check to get healthy connections.
## Requirements
- Python
- CPython : >= 3.4
- MySQL Server -- one of the following:
- MySQL >= 5.5
- MariaDB >= 5.5
- PyMySQL: >= 0.9.2
## Installation
Package is uploaded on [PyPI](https://pypi.org/project/pymysql-pooling/)
You can install with pip
```
$ pip install pymysql-pooling
```
## Example
Make use of a simple table (Example in [MySQL doc](https://dev.mysql.com/doc/refman/8.0/en/creating-tables.html))
```mysql
mysql> CREATE TABLE pet (name VARCHAR(20), owner VARCHAR(20),
-> species VARCHAR(20), sex CHAR(1), birth DATE, death DATE);
mysql> INSERT INTO pet
-> VALUES ("Puffball", "Diane", "hamster", "f", "1999-03-30", NULL);
```
```python
from pymysqlpool.pool import Pool
# Note: you can also add any parameters relates to `pymysql.connections.Connection` object
pool = Pool(host=HOST, port=PORT, user=USER, password=PASSWORD, db=DB)
pool.init()
connection = pool.get_conn()
cur = connection.cursor()
cur.execute('SELECT * FROM `pet` WHERE `name`=%s', args=("Puffball", ))
print(cur.fetchone())
pool.release(connection)
```
This example will print:
```
('Puffball', 'Diane', 'hamster', 'f', datetime.date(1999, 3, 30), None)
```
Support autocommit mode, as following:
```python
pool = Pool(host=HOST, port=PORT, user=USER, password=PASSWORD, db=DB, autocommit=True)
```
That's all.
## Roadmap
- [x] Connection Pool
- [x] Dynamically Create
- [x] Dynamically Release
- [ ] Monitor Web Interface
## Resources
- [PyMySQL Documenation](https://pymysql.readthedocs.io/en/latest/index.html)
- [MySQL Reference Manuals](https://dev.mysql.com/doc/refman/8.0/en/)
## License
PyMySQLPool is released under the MIT License. See LICENSE for more information.
## Contributing
Thank you for your interest in the contribution of PyMySQLPool, your help and contribution is very valuable.
You can submit an issue and pull requests, please submit an issue before submitting pull requests.