A simple MySQL database helper for easy interactions
Project description
Database Library
A Python-based database management library that supports both MySQL and SQLite. It provides an easy-to-use interface for defining tables, inserting data, searching records, updating, deleting, and more.
Features
- Supports MySQL (via PyMySQL) and SQLite.
- Table creation, modification, and deletion.
- Data insertion, updating, and querying.
- Bulk insert operations.
- Pagination support.
- Schema introspection.
- Data replication between SQLite and MySQL.
Installation
pip install sqlalchemy pymysql
Usage
Initialize Database
from database import Database, LocalDatabase
# MySQL Database Connection
mysql_db = Database(username='root', password='password', host='localhost', port=3306, database='testdb')
# SQLite Local Database
sqlite_db = LocalDatabase(db_path='local.db')
Define a Table
table = mysql_db.define_table("users", id=Integer, name=Text, age=Integer)
Insert Data
mysql_db.insert("users", id=1, name="Alice", age=25)
Bulk Insert
data = [
{"id": 2, "name": "Bob", "age": 30},
{"id": 3, "name": "Charlie", "age": 22}
]
mysql_db.bulk_insert("users", data)
Search Data
users = mysql_db.search("users")
print(users) # List of all users
Search with filters:
alice = mysql_db.search("users", id=1)
print(alice)
Get a Single Record
user = mysql_db.get("users", id=1)
print(user)
Update Data
mysql_db.update("users", {"id": 1}, {"age": 26})
Delete Data
mysql_db.delete("users", id=3)
List All Tables
tables = mysql_db.list_tables()
print(tables)
Count Rows
user_count = mysql_db.count_rows("users")
print(user_count)
Get Distinct Column Values
distinct_ages = mysql_db.distinct_values("users", "age")
print(distinct_ages)
Search with Pagination
users_page1 = mysql_db.search_paginated("users", page=1, page_size=2)
print(users_page1)
Get Table Schema
schema = mysql_db.get_table_schema("users")
print(schema)
Rename Table
mysql_db.rename_table("users", "members")
Add a Column
mysql_db.add_column("members", "email", "TEXT")
Drop a Column
mysql_db.drop_column("members", "email")
Delete Table
mysql_db.delete_table("members")
Replicate SQLite to MySQL
mysql_db.replicate_local_to_online(sqlite_db)
Replicate MySQL to SQLite
sqlite_db.replicate_online_to_local(mysql_db)
Get column type
print(sqlite_db.get_column_type("users", "age"))
print(my_sql.get_column_type("users", "age"))
Edit column type
sqlite_db.edit_column_type("users", "age", "VARCHAR(10)")
mysql_db.edit_column_type("users", "age", "TEXT")
License
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pymysqlhelper-1.7.0.tar.gz.
File metadata
- Download URL: pymysqlhelper-1.7.0.tar.gz
- Upload date:
- Size: 11.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83ef460a80f3c03baaee5e680a4d92e006a48b57c51ee4a4c5956d4bb9f7cd41
|
|
| MD5 |
4379d0eceac3e5ec55c6172e9d790b25
|
|
| BLAKE2b-256 |
c0ec78180bd844a77fac33c31651eaaaa32ac18fcae111f6165258181eb1dfd0
|
File details
Details for the file pymysqlhelper-1.7.0-py3-none-any.whl.
File metadata
- Download URL: pymysqlhelper-1.7.0-py3-none-any.whl
- Upload date:
- Size: 14.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b8ddaf5c7a2adc1221cd27ae347f43910f22a53a01cc6d4b632852b300ffa949
|
|
| MD5 |
5bb4e4565f53bd78b85d5ca820e53cb3
|
|
| BLAKE2b-256 |
0005aba50e94c5f5ea486ae764ec3c069237bd43e80eb8892b0c9b6ba9c02049
|