SQL Database management without even a SQL line
Project description
EasySQL
This library allow you to run SQL Databases without knowing even SQL.
This library will create SQL queries and execute them as you request and is very simple to use.
Having an issue?
You can always find someone on our discord server here:
Wiki
The official wiki of this library is now available at GitHub
How to install
To install just use following command
pip install PyEasySQL
This library will have dev/beta builds on the GitHub, to install them you can use
pip install --upgrade git+https://github.com/Ashenguard/EasySQL.git
By installing this library following libraries and their dependencies will be installed too.
mysql-connector: Which is the basic library for connecting to database
Example
import EasySQL
# Simply provide connection info to your database
@EasySQL.auto_init
class MyDatabase(EasySQL.EasyDatabase):
_database = 'MyDatabase'
_password = '**********'
_host = '127.0.0.1'
_port = 3306
_user = 'root'
# Simply create a MyTable with its columns!
@EasySQL.auto_init
class MyTable(EasySQL.EasyTable, database=MyDatabase, name='MyTable'):
ID = EasySQL.EasyColumn('ID', EasySQL.Types.BIGINT, EasySQL.Tags.PRIMARY, EasySQL.Tags.AUTO_INCREMENT)
Name = EasySQL.EasyColumn('Name', EasySQL.Types.STRING(255), EasySQL.Tags.NOT_NULL, default='Missing')
Balance = EasySQL.EasyColumn('Balance', EasySQL.Types.INT, EasySQL.Tags.NOT_NULL)
Premium = EasySQL.EasyColumn('Premium', EasySQL.Types.BOOL, EasySQL.Tags.NOT_NULL, default=False)
# Insert values with a simple command
MyTable.insert([MyTable.Name, MyTable.Premium, MyTable.Balance], ['Ashenguard', True, 10])
MyTable.insert([MyTable.Name, MyTable.Premium], ['Sam', False])
# Let's add some random data
from random import randint
for i in range(5):
MyTable.insert(['Name', 'Balance'], [f'User-{i}', randint(0, 20)])
# Selecting data with another simple command
### Let's get all the data
all = MyTable.select()
### Something that does not exist
empty = MyTable.select(MyTable.ID, where=EasySQL.WhereIsEqual(MyTable.Name, "NO-ONE"))
### To select multiple data give a list of columns as 1st argument
premiums = MyTable.select([MyTable.ID, MyTable.Name], EasySQL.WhereIsEqual(MyTable.Premium, True))
### You can have more complicated condition with AND (&), OR (|) and NOT (~)
specific = MyTable.select(MyTable.Name, where=EasySQL.WhereIsLike(MyTable.Name, "Ash%").AND(EasySQL.WhereIsLesserEqual(MyTable.ID, 5)))
### Giving no column will select all the columns, Also you can use limit, offset and order to sort data
second = MyTable.select(order=MyTable.Balance, descending=True, limit=1, offset=1)
top5 = MyTable.select(order=MyTable.Balance, descending=True, limit=5)
### If you want only one result not a sequence of them! It will return a SelectData if a data is found or return None if none is found.
one = MyTable.select(where=EasySQL.WhereIsEqual(MyTable.Name, "Ashenguard"), force_one=True)
# The result will be an EmptySelectData if nothing was found, A SelectData if only one was found, Or a tuple of SelectData
# All 3 of them are iterable, so it is safe to use a `for` loop for any result
# To get data from the result you can use `get`, but it only contains columns requested in select method.
for data in top5:
print(f'{data.get(MyTable.ID)}: {data.get(MyTable.Name)}\tBalance: {data.get(MyTable.Balance)}')
# To delete data just use the delete method
MyTable.delete(EasySQL.WhereIsGreater(MyTable.ID, 5))
# Update data with following command
MyTable.update(MyTable.Premium, True, EasySQL.WhereIsEqual(MyTable.ID, 3).OR(EasySQL.WhereIsEqual(MyTable.Name, 'Sam')))
# Not sure if you should update or insert? Use set and it will be handled
MyTable.set([MyTable.ID, MyTable.Name, MyTable.Balance, MyTable.Premium], [5, 'Nathaniel', 50, False], where=EasySQL.WhereIsEqual(MyTable.ID, 5))
# Safety error on delete/update/set without a where statement
# MyTable.delete() -> raise EasySQL.DatabaseSafetyException
# Turn the safety off with following command.
MyDatabase.remove_safety(confirm=True)
# Now there will be no error, it will clean the all data that's why we had safety lock
MyTable.delete()
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
PyEasySQL-3.1.0.tar.gz
(12.6 kB
view hashes)
Built Distribution
PyEasySQL-3.1.0-py3-none-any.whl
(14.9 kB
view hashes)
Close
Hashes for PyEasySQL-3.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 762678ac46963688363b0357eb35ad78036261945883254448f4a9179a208274 |
|
MD5 | aa7ff72f4e8b2352f78e32c20478ae91 |
|
BLAKE2b-256 | 90a73fd3c0878b9e94ba04358724ee3424a6d20ea29855a5097df08ce48372f4 |