122 lines
3.1 KiB
Markdown
Executable File
122 lines
3.1 KiB
Markdown
Executable File
# SQLOR
|
|
|
|
SQLOR is a database api for python3, it is base on the python's DBAPI2
|
|
|
|
## Features
|
|
|
|
* Multiple database supported(Oracle, MySql, Postgresql, SQL Server
|
|
* Both asynchronous API & synchronous API supported
|
|
* Connection pools
|
|
* Connection life cycle managements
|
|
* Easy using API
|
|
* Resources(connection object, cursor object) automatic recycled
|
|
|
|
|
|
## requirements
|
|
|
|
* python 3.5 or above
|
|
* asyncio
|
|
* Oracle DBAPI2 driver(cx_Oracle)
|
|
* MySQL DBAPI2 driver(mysql-connector)
|
|
* Postgresql DBAPI2 driver(psycopg2-binrary)
|
|
* Asynchronous MySQL driver(aiomysql)
|
|
* Asynchronous Postgresql driver(aiopg)
|
|
* Other driver can be easy integreated
|
|
|
|
## Using
|
|
|
|
```
|
|
import asyncio
|
|
|
|
from sqlor.dbpools import DBPools
|
|
|
|
dbs={
|
|
"aiocfae":{
|
|
"driver":"aiomysql",
|
|
"async_mode":True,
|
|
"coding":"utf8",
|
|
"dbname":"cfae",
|
|
"kwargs":{
|
|
"user":"test",
|
|
"db":"cfae",
|
|
"password":"test123",
|
|
"host":"localhost"
|
|
}
|
|
},
|
|
"cfae":{
|
|
"driver":"mysql.connector",
|
|
"coding":"utf8",
|
|
"dbname":"cfae",
|
|
"kwargs":{
|
|
"user":"test",
|
|
"db":"cfae",
|
|
"password":"test123",
|
|
"host":"localhost"
|
|
}
|
|
}
|
|
}
|
|
|
|
loop = asyncio.get_event_loop()
|
|
pool = DBPools(dbs,loop=loop)
|
|
|
|
async def testfunc():
|
|
@pool.runSQL
|
|
def sql(db,ns,callback):
|
|
return {
|
|
"sql_string":"select * from product",
|
|
}
|
|
x = await sql('cfae',{},print)
|
|
x = await sql('aiocfae',{},print)
|
|
|
|
loop.run_until_complete(testfunc())
|
|
```
|
|
|
|
## API
|
|
|
|
|
|
### Databases description data(dbdesc)
|
|
|
|
sqlor uses a dbdesc data(databases description data) which description
|
|
how many databases and what database will using, and them connection parameters to create a dbpools objects
|
|
|
|
dbdesc data is a dict data, format of the dbdesc as follow:
|
|
```
|
|
{
|
|
"aiocfae":{ # name to identify a database connect
|
|
"driver":"aiomysql", # database dbapi2 driver package name
|
|
"async_mode":True, # indicte this connection is asynchronous mode
|
|
"coding":"utf8", # charset coding
|
|
"dbname":"cfae", # database real name
|
|
"kwargs":{ # connection parameters
|
|
"user":"test",
|
|
"db":"cfae",
|
|
"password":"test123",
|
|
"host":"localhost"
|
|
}
|
|
},
|
|
"cfae":{
|
|
"driver":"mysql.connector",
|
|
"coding":"utf8",
|
|
"dbname":"cfae",
|
|
"kwargs":{
|
|
"user":"test",
|
|
"db":"cfae",
|
|
"password":"test123",
|
|
"host":"localhost"
|
|
}
|
|
}
|
|
}
|
|
|
|
```
|
|
sqlor can using multiple databases and difference databases by using difference database driver
|
|
|
|
### sql description data
|
|
|
|
|
|
## class
|
|
|
|
### DBPools
|
|
|
|
### SQLor
|
|
|