pymysql-pooling 0.9.9

pymysql-based database connection pool

PyMySQLPool

PyMySQLPool is a pymysql-based database connection pool, simple and lightweight.

Table of content

• Features
• Requirements
• Installation
• Example
• Parameters
• Roadmap
• Resources
• License
• Contributing

Features

• Maintain a minimum number of connection pools by default.
• If number of unuse connections less than zero, dynamically add connections to pool until current number of inuse connections equal maximum of pool.
• Release the idle connections in regular until number of unuse connections equal minimum of pool.

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

You can install with pip

$ pip install pymysql-pooling

Example

Make use of a simple table (Example in MySQL doc)

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);

from pymysqlpool.pool import Pool


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 auto-commit mode, as following:

pool = Pool(host=HOST, port=PORT, user=USER, password=PASSWORD, db=DB, autocommit=True)

That's all.

Parameters for the pool initial:

• host: Host of MySQL server
• port: Port of MySQL server
• user: User of MySQL server
• password: Password of MySQL server
• db: Database of MySQL server
• charset: Charset of MySQL server
• cursorclass: Class of MySQL Cursor
• autocommit: auto commit mode
• min_size: Minimum size of connection pool
• max_size: Maximum size of connection pool
• timeout: Watting time in the multi-thread environment
• interval: Statistical cycle time
• stati_mun: Statistical frequency
• multiple: Regulation standard
• counter: Counter
• accumulation: Statiscal result

Roadmap

• Connection Pool
• Dynamically Create
• Dynamically Release
• Monitor Web Interface

Resources

• PyMySQL Documenation
• MySQL Reference Manuals

License

PyMySQLPool is released under the MIT License. See LICENSE for more information.

Contributing

Thank you for your interest in contribution of PyMySQLPool, your help and contribution is very valuable.

You can submit issue and pull requests, please submit an issue before submitting pull requests.