MySQLX 2.1.1__tar.gz

mysqlx-2.1.1/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.1
+Name: mysqlx
+Version: 2.1.1
+Summary: A thread safe sql executor for MySQL like MyBatis with connection pool. It helps you automatically manage database connections and transactions. It also provides ORM operations for single tables.
+Home-page: https://gitee.com/summry/mysqlx
+Author: summy
+Author-email: xiazhongbiao@126.com
+License: UNKNOWN
+Keywords: sql,MySQL,MyBatis,python
+Platform: UNKNOWN
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+
+Mapper file
+'''''''''''
+
+Create a mapper file in 'mapper' folder, you can named
+'user_mapper.xml', like follow:
+
+.. code:: xml
+
+   <?xml version="1.0" encoding="UTF-8"?>
+   <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://gitee.com/summry/mysqlx/blob/master/dtd/mapper.dtd">
+   <mapper namespace="user">
+       <select id="select_all">
+           select id, name, age from user
+        </select>
+
+        <select id="select_by_name">
+           select id, name, age from user where name = ?
+        </select>
+
+        <select id="select_by_name2">
+           select id, name, age from user where name = :name
+        </select>
+
+        <select id="select_include" include="select_all">
+           {{ select_all }}
+             {% if name -%}
+              where name = :name
+             {%- endif -%}
+        </select>
+   </mapper>
+
+Usage Sample
+''''''''''''
+
+.. code:: python
+
+    from mysqlx.orm import Model
+    from typing import List, Tuple, Mapping
+    from mysqlx import mapper, sql, db, dbx, init_db
+
+    @mapper(namespace='user')
+    def select_all(): List
+
+    @mapper(namespace='user')
+    def select_by_name(name: str): List
+
+    @mapper(namespace='user')
+    def select_by_name2(name: str): List
+
+    @mapper(namespace='user')
+    def select_include(name: str): List
+
+    @sql('select id, name, age from user where name = ?')
+    def query_by_name(name: str): List(Mapping)
+
+    @sql('select id, name, age from user where name = :name')
+    def query_by_name2(name: str): List(Mapping)
+
+    if __name__ == '__main__':
+        init_db(host='127.0.0.1', port='3306', user='xxx', password='xxx', database='test', pool_size=5, show_sql=True, mapper_path='./mapper')
+
+        users = select_all()
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = select_by_name('zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_by_name2(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_include(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = query_by_name('zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+
+        users = query_by_name2(name='zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+       
+        # you can use dbx execte mapper sql with full sql id: namespace join sql id
+        users = dbx.select('user.select_all')  # 'user' is namespace, 'select_all' is sql id
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = dbx.select('user.select_by_name', name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = dbx.sql('user.select_by_name').select(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        # you can direct execute sql with db
+        effected_rowcount = db.insert(table='user', name='zhaoliu', age=66)
+
+        users = db.select('select id, name, age from user')
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = db.query('select id, name, age from user name = :name', name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        users = db.sql('select id, name, age from user name = :name').query(name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        # you can use orm to operate a single table
+        class User(Model):
+            __key__ = 'id'
+            __table__ = 'user'
+
+            def __init__(self, id: int = None, name: str = None, age: int = None):
+                self.id = id
+                self.name = name
+                self.age = age
+
+
+        effected_rowcount = User.insert(name='tianqi', age=77)
+
+        users = User.query(name='tianqi')
+        # select id, name, age from user where name = :name
+        # result:
+        # {'id': 7, 'name': 'tianqi', 'age': 77}
+
+        users = User.query(name__eq='zhangsan')
+        # select id, name, age from user where name = :name
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+Transaction
+'''''''''''
+
+.. code:: python
+
+   from mysqlx import with_transaction, transaction
+
+   @with_transaction
+   def test_transaction():
+       insert_func(....)
+       update_func(....)
+
+
+   def test_transaction2():
+       with transaction():
+           insert_func(....)
+           update_func(....)
+
+You can generate model class with mysqlx-generator: https://pypi.org/project/mysqlx-generator
+
+If you want to operate PostgreSQL database, may be you need PgSqlx: https://pypi.org/project/pgsqlx
+
+If you just wanted a simple sql executor, may be you need sqlx-exec: https://pypi.org/project/sqlx-exec
+
+If you wanted simultaneously support MySQL and PostgreSQL, may be you need sqlx-batis: https://pypi.org/project/sqlx-batis
+
+

mysqlx-2.1.1/README.rst

@@ -0,0 +1,167 @@
+Mapper file
+'''''''''''
+
+Create a mapper file in 'mapper' folder, you can named
+'user_mapper.xml', like follow:
+
+.. code:: xml
+
+   <?xml version="1.0" encoding="UTF-8"?>
+   <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://gitee.com/summry/mysqlx/blob/master/dtd/mapper.dtd">
+   <mapper namespace="user">
+       <select id="select_all">
+           select id, name, age from user
+        </select>
+
+        <select id="select_by_name">
+           select id, name, age from user where name = ?
+        </select>
+
+        <select id="select_by_name2">
+           select id, name, age from user where name = :name
+        </select>
+
+        <select id="select_include" include="select_all">
+           {{ select_all }}
+             {% if name -%}
+              where name = :name
+             {%- endif -%}
+        </select>
+   </mapper>
+
+Usage Sample
+''''''''''''
+
+.. code:: python
+
+    from mysqlx.orm import Model
+    from typing import List, Tuple, Mapping
+    from mysqlx import mapper, sql, db, dbx, init_db
+
+    @mapper(namespace='user')
+    def select_all(): List
+
+    @mapper(namespace='user')
+    def select_by_name(name: str): List
+
+    @mapper(namespace='user')
+    def select_by_name2(name: str): List
+
+    @mapper(namespace='user')
+    def select_include(name: str): List
+
+    @sql('select id, name, age from user where name = ?')
+    def query_by_name(name: str): List(Mapping)
+
+    @sql('select id, name, age from user where name = :name')
+    def query_by_name2(name: str): List(Mapping)
+
+    if __name__ == '__main__':
+        init_db(host='127.0.0.1', port='3306', user='xxx', password='xxx', database='test', pool_size=5, show_sql=True, mapper_path='./mapper')
+
+        users = select_all()
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = select_by_name('zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_by_name2(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_include(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = query_by_name('zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+
+        users = query_by_name2(name='zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+       
+        # you can use dbx execte mapper sql with full sql id: namespace join sql id
+        users = dbx.select('user.select_all')  # 'user' is namespace, 'select_all' is sql id
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = dbx.select('user.select_by_name', name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = dbx.sql('user.select_by_name').select(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        # you can direct execute sql with db
+        effected_rowcount = db.insert(table='user', name='zhaoliu', age=66)
+
+        users = db.select('select id, name, age from user')
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = db.query('select id, name, age from user name = :name', name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        users = db.sql('select id, name, age from user name = :name').query(name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        # you can use orm to operate a single table
+        class User(Model):
+            __key__ = 'id'
+            __table__ = 'user'
+
+            def __init__(self, id: int = None, name: str = None, age: int = None):
+                self.id = id
+                self.name = name
+                self.age = age
+
+
+        effected_rowcount = User.insert(name='tianqi', age=77)
+
+        users = User.query(name='tianqi')
+        # select id, name, age from user where name = :name
+        # result:
+        # {'id': 7, 'name': 'tianqi', 'age': 77}
+
+        users = User.query(name__eq='zhangsan')
+        # select id, name, age from user where name = :name
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+Transaction
+'''''''''''
+
+.. code:: python
+
+   from mysqlx import with_transaction, transaction
+
+   @with_transaction
+   def test_transaction():
+       insert_func(....)
+       update_func(....)
+
+
+   def test_transaction2():
+       with transaction():
+           insert_func(....)
+           update_func(....)
+
+You can generate model class with mysqlx-generator: https://pypi.org/project/mysqlx-generator
+
+If you want to operate PostgreSQL database, may be you need PgSqlx: https://pypi.org/project/pgsqlx
+
+If you just wanted a simple sql executor, may be you need sqlx-exec: https://pypi.org/project/sqlx-exec
+
+If you wanted simultaneously support MySQL and PostgreSQL, may be you need sqlx-batis: https://pypi.org/project/sqlx-batis

mysqlx-2.1.1/mysqlx/__init__.py

@@ -0,0 +1,41 @@
+from sqlbatis import (
+    connection,
+    transaction,
+    with_connection,
+    with_transaction,
+    get_connection,
+    close,
+    Driver,
+    sql,
+    mapper,
+    init_snowflake,
+    get_snowflake_id,
+    init_db as _init_db
+)
+from sqlexec import Dialect, Engine
+
+
+def init_db(*args, **kwargs):
+    """
+    Compliant with the Python DB API 2.0 (PEP-249).
+
+    from mysqlx import init_db
+    init_db('test.db', driver='sqlite3', show_sql=True, debug=True)
+    or
+    init_db("postgres://user:password@127.0.0.1:5432/testdb", mapper_path='./mapper', driver='psycopg2', pool_size=5, show_sql=True, debug=True)
+    or
+    init_db(user='root', password='xxx', host='127.0.0.1', port=3306, database='testdb', mapper_path='./mapper', driver='pymysql', pool_size=5, show_sql=True, debug=True)
+
+    Addition parameters:
+    :param mapper_path: str, path of mapper files
+    :param driver=None: str, import driver, 'import pymysql'
+    :param pool_size=0: int, default 0, size of connection pool
+    :param show_sql=False: bool,  if True, print sql
+    :param debug=False: bool, if True, print debug context
+    :param trans_placeholder=True: bool, if True, sql placeholder '?' --> '%s'
+
+    Other parameters of connection pool refer to DBUtils: https://webwareforpython.github.io/DBUtils/main.html#pooleddb-pooled-db
+    """
+
+    Dialect.init(Engine.MYSQL)
+    _init_db(*args, **kwargs)

mysqlx-2.1.1/mysqlx/db.py

@@ -0,0 +1,8 @@
+
+# Don't remove. Import for not repetitive implementation
+from sqlbatis.db import insert, save, save_sql, execute, batch_insert, batch_execute, get, query, query_one, select, select_one, do_execute,\
+    do_save_sql, do_get, do_query, do_query_one, do_select, do_select_one, do_query_page, do_select_page, query_page, select_page, sql, page, table,\
+    drop, truncate
+
+
+

mysqlx-2.1.1/mysqlx/dbx.py

@@ -0,0 +1,2 @@
+from sqlbatis.dbx import save, batch_execute, execute, get, query, query_one, select, select_one, select_page, query_page, sql, page
+

mysqlx-2.1.1/mysqlx/log_support.py

@@ -0,0 +1,14 @@
+# Don't remove. Import for not repetitive implementation
+from sqlbatis.log_support import logger
+
+
+def save_log(table, **kwargs):
+    logger.debug("Exec func 'mysqlx.db.save' \n\t Table: '%s', kwargs: %s" % (table, kwargs))
+
+
+def sql_id_log(function: str, sql_id: str, *args, **kwargs):
+    logger.debug("Exec func 'mysqlx.dbx.%s', sql_id: %s, args: %s, kwargs: %s" % (function, sql_id.strip(), args, kwargs))
+
+
+def orm_insert_log(function, class_name, **kwargs):
+    logger.debug("Exec func 'mysqlx.orm.Model.%s' \n\t Class: '%s', kwargs: %s" % (function, class_name, kwargs))

mysqlx-2.1.1/mysqlx/orm.py

@@ -0,0 +1,142 @@
+from datetime import datetime
+from . import get_snowflake_id
+from typing import Union, Sequence
+from sqlbatis.constant import LIMIT_1
+from .db import insert, do_execute, save
+from .log_support import orm_insert_log, logger
+import warnings
+
+# Don't remove. Import for not repetitive implementation
+from sqlbatis.orm import DelFlag, KeyStrategy, Model as BaseModel
+
+
+class Model(BaseModel):
+    """
+    Create a class extends Model:
+
+    class Person(Model):
+        __key__ = 'id'
+        __table__ = 'person'
+        __update_by__ = 'update_by'
+        __update_time__ = 'update_time'
+        __del_flag__ = 'del_flag'
+
+        def __init__(self, id: int = None, name: str = None, age: int = None, update_by: int = None, update_time: datetime = None, del_flag: int = None):
+            self.id = id
+
+            self.update_by = update_by
+            self.update_time = update_time
+            self.del_flag = del_flag
+            self.name = name
+            self.age = age
+
+    then you can use like follow:
+        init_db(person='xxx', password='xxx', database='xxx', host='xxx', ...)  # or dbx.init_db(...) init db first,
+        person = Person(name='张三', age=55)
+        effect_rowcount = person.persist()
+        id = person.inst_save()
+    """
+
+    @classmethod
+    def save(cls, **kwargs):
+        """
+        id = Person.save(name='张三', age=20)
+        :return: Primary key
+        """
+        orm_insert_log('save', cls.__name__, **kwargs)
+        key, table = cls._get_key_and_table()
+        if key in kwargs:
+            insert(table, **kwargs)
+            return kwargs[key]
+
+        key_strategy = cls._get_key_strategy()
+        if key_strategy == KeyStrategy.SNOWFLAKE:
+            kwargs[key] = get_snowflake_id()
+            insert(table, **kwargs)
+            return kwargs[key]
+        else:
+            return save(table, **kwargs)
+
+    @classmethod
+    def update_by_id(cls, _id: Union[int, str], **kwargs):
+        """
+        rowcount = User.update_by_id(id=1, name='王五')
+        return: Effect rowcount
+        """
+        logger.debug("Exec func 'mysqlx.orm.Model.%s' \n\t Class: '%s', id: %d, kwargs: %s" % ('update_by_id', cls.__name__, _id, kwargs))
+        assert kwargs, 'Must set update kv'
+        key = cls._get_key()
+        where = '`%s` = ?' % key
+        cols, args = zip(*kwargs.items())
+        sql, update_time_arg = cls._update_sql(where, *cols)
+        if update_time_arg:
+            args = [*args, update_time_arg]
+        return do_execute(sql, *args, _id, LIMIT_1)
+
+    @classmethod
+    def delete_by_id(cls, _id: Union[int, str]):
+        """
+        Physical delete
+        rowcount = User.delete_by_id(id=1)
+        return: Effect rowcount
+        """
+        logger.debug("Exec func 'mysqlx.orm.Model.%s' \n\t Class: '%s', id: %d" % ('delete_by_id', cls.__name__, _id))
+        key, table = cls._get_key_and_table()
+        sql = 'DELETE FROM `%s` WHERE `%s` = ? LIMIT ?' % (table, key)
+        return do_execute(sql, _id, LIMIT_1)
+
+    @classmethod
+    def _update_sql(cls, where, *update_fields):
+        update_time_arg = None
+        table = cls.get_table()
+        update_time_field = cls._get_update_time_field()
+        if update_time_field is not None and update_time_field not in update_fields:
+            update_fields = [*update_fields, update_time_field]
+            update_time_arg = datetime.now()
+
+        update_fields = ','.join(['`{}` = ?'.format(col) for col in update_fields])
+        return 'UPDATE `{}` SET {} WHERE {} LIMIT ?'.format(table, update_fields, where), update_time_arg
+
+    @classmethod
+    def _logical_delete_by_id_op(cls, _id: Union[int, str], update_by: Union[int, str] = None, del_status=DelFlag.DELETED):
+        key, table = cls._get_key_and_table()
+        del_flag_field = cls._get_del_flag_field()
+        update_by_field = cls._get_update_by_field()
+
+        where = '`%s` = ?' % key
+        if update_by is not None and update_by_field is not None:
+            sql, update_time_arg = cls._update_sql(where, del_flag_field, update_by_field)
+            if update_time_arg:
+                return do_execute(sql, del_status.value, update_by, update_time_arg, _id, LIMIT_1)
+            return do_execute(sql, del_status.value, update_by, _id, LIMIT_1)
+        else:
+            sql, update_time_arg = cls._update_sql(where, del_flag_field)
+            if update_time_arg:
+                return do_execute(sql, del_status.value, update_time_arg, _id, LIMIT_1)
+            return do_execute(sql, del_status.value, _id, LIMIT_1)
+
+    @classmethod
+    def _do_logical_delete_by_ids(cls, ids: Union[Sequence[int], Sequence[str]], update_by: Union[int, str] = None, del_status=DelFlag.DELETED):
+        ids_size = len(ids)
+        key = cls._get_key()
+        del_flag_field = cls._get_del_flag_field()
+        update_by_field = cls._get_update_by_field()
+
+        where = '`%s` in (%s)' % (key, ','.join(['?' for _ in range(ids_size)]))
+        if update_by is not None and update_by_field is not None:
+            sql, update_time_arg = cls._update_sql(where, del_flag_field, update_by_field)
+            if update_time_arg:
+                return do_execute(sql, del_status.value, update_by, update_time_arg, *ids, ids_size)
+            return do_execute(sql, del_status.value, update_by, *ids, ids_size)
+        else:
+            sql, update_time_arg = cls._update_sql(where, del_flag_field)
+            if update_time_arg:
+                return do_execute(sql, del_status.value, update_time_arg, *ids, ids_size)
+            return do_execute(sql, del_status.value, *ids, ids_size)
+
+    @classmethod
+    def _delete_by_ids(cls, ids: Union[Sequence[int], Sequence[str]]):
+        ids_size = len(ids)
+        key, table = cls._get_key_and_table()
+        sql = 'DELETE FROM `{}` WHERE `{}` in ({}) LIMIT ?'.format(table, key, ','.join(['?' for _ in range(ids_size)]))
+        return do_execute(sql, *ids, ids_size)

mysqlx-2.1.1/mysqlx.egg-info/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.1
+Name: mysqlx
+Version: 2.1.1
+Summary: A thread safe sql executor for MySQL like MyBatis with connection pool. It helps you automatically manage database connections and transactions. It also provides ORM operations for single tables.
+Home-page: https://gitee.com/summry/mysqlx
+Author: summy
+Author-email: xiazhongbiao@126.com
+License: UNKNOWN
+Keywords: sql,MySQL,MyBatis,python
+Platform: UNKNOWN
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+
+Mapper file
+'''''''''''
+
+Create a mapper file in 'mapper' folder, you can named
+'user_mapper.xml', like follow:
+
+.. code:: xml
+
+   <?xml version="1.0" encoding="UTF-8"?>
+   <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://gitee.com/summry/mysqlx/blob/master/dtd/mapper.dtd">
+   <mapper namespace="user">
+       <select id="select_all">
+           select id, name, age from user
+        </select>
+
+        <select id="select_by_name">
+           select id, name, age from user where name = ?
+        </select>
+
+        <select id="select_by_name2">
+           select id, name, age from user where name = :name
+        </select>
+
+        <select id="select_include" include="select_all">
+           {{ select_all }}
+             {% if name -%}
+              where name = :name
+             {%- endif -%}
+        </select>
+   </mapper>
+
+Usage Sample
+''''''''''''
+
+.. code:: python
+
+    from mysqlx.orm import Model
+    from typing import List, Tuple, Mapping
+    from mysqlx import mapper, sql, db, dbx, init_db
+
+    @mapper(namespace='user')
+    def select_all(): List
+
+    @mapper(namespace='user')
+    def select_by_name(name: str): List
+
+    @mapper(namespace='user')
+    def select_by_name2(name: str): List
+
+    @mapper(namespace='user')
+    def select_include(name: str): List
+
+    @sql('select id, name, age from user where name = ?')
+    def query_by_name(name: str): List(Mapping)
+
+    @sql('select id, name, age from user where name = :name')
+    def query_by_name2(name: str): List(Mapping)
+
+    if __name__ == '__main__':
+        init_db(host='127.0.0.1', port='3306', user='xxx', password='xxx', database='test', pool_size=5, show_sql=True, mapper_path='./mapper')
+
+        users = select_all()
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = select_by_name('zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_by_name2(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = select_include(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = query_by_name('zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+
+        users = query_by_name2(name='zhangsan')
+        # result:
+        # {'id': 3, 'name': 'zhangsan', 'age': 15}
+       
+        # you can use dbx execte mapper sql with full sql id: namespace join sql id
+        users = dbx.select('user.select_all')  # 'user' is namespace, 'select_all' is sql id
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = dbx.select('user.select_by_name', name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        users = dbx.sql('user.select_by_name').select(name='zhangsan')
+        # result:
+        # (3, 'zhangsan', 15)
+
+        # you can direct execute sql with db
+        effected_rowcount = db.insert(table='user', name='zhaoliu', age=66)
+
+        users = db.select('select id, name, age from user')
+        # result:
+        # (3, 'zhangsan', 15)
+        # (4, 'lisi', 26)
+        # (5, 'wangwu', 38)
+
+        users = db.query('select id, name, age from user name = :name', name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        users = db.sql('select id, name, age from user name = :name').query(name='zhangsan')
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+        # you can use orm to operate a single table
+        class User(Model):
+            __key__ = 'id'
+            __table__ = 'user'
+
+            def __init__(self, id: int = None, name: str = None, age: int = None):
+                self.id = id
+                self.name = name
+                self.age = age
+
+
+        effected_rowcount = User.insert(name='tianqi', age=77)
+
+        users = User.query(name='tianqi')
+        # select id, name, age from user where name = :name
+        # result:
+        # {'id': 7, 'name': 'tianqi', 'age': 77}
+
+        users = User.query(name__eq='zhangsan')
+        # select id, name, age from user where name = :name
+        # result:
+        # [{'id': 3, 'name': 'zhangsan', 'age': 15}]
+
+Transaction
+'''''''''''
+
+.. code:: python
+
+   from mysqlx import with_transaction, transaction
+
+   @with_transaction
+   def test_transaction():
+       insert_func(....)
+       update_func(....)
+
+
+   def test_transaction2():
+       with transaction():
+           insert_func(....)
+           update_func(....)
+
+You can generate model class with mysqlx-generator: https://pypi.org/project/mysqlx-generator
+
+If you want to operate PostgreSQL database, may be you need PgSqlx: https://pypi.org/project/pgsqlx
+
+If you just wanted a simple sql executor, may be you need sqlx-exec: https://pypi.org/project/sqlx-exec
+
+If you wanted simultaneously support MySQL and PostgreSQL, may be you need sqlx-batis: https://pypi.org/project/sqlx-batis
+
+

mysqlx-2.1.1/mysqlx.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.rst
+setup.py
+mysqlx/__init__.py
+mysqlx/db.py
+mysqlx/dbx.py
+mysqlx/log_support.py
+mysqlx/orm.py
+mysqlx.egg-info/PKG-INFO
+mysqlx.egg-info/SOURCES.txt
+mysqlx.egg-info/dependency_links.txt
+mysqlx.egg-info/not-zip-safe
+mysqlx.egg-info/requires.txt
+mysqlx.egg-info/top_level.txt

mysqlx-2.1.1/mysqlx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mysqlx-2.1.1/mysqlx.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

mysqlx-2.1.1/mysqlx.egg-info/requires.txt

@@ -0,0 +1 @@
+sqlx-batis>=2.1.1

mysqlx-2.1.1/mysqlx.egg-info/top_level.txt

@@ -0,0 +1 @@
+mysqlx

mysqlx-2.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mysqlx-2.1.1/setup.py

@@ -0,0 +1,38 @@
+import os
+from setuptools import setup
+
+# INSTALL_PACKAGES = open(path.join(DIR, 'requirements.txt')).read().splitlines()
+def read(rel_path: str) -> str:
+    here = os.path.abspath(os.path.dirname(__file__))
+    # intentionally *not* adding an encoding option to open, See:
+    #   https://github.com/pypa/virtualenv/issues/201#issuecomment-3145690
+    with open(os.path.join(here, rel_path), 'r', encoding='UTF-8') as fp:
+        return fp.read()
+
+long_description = read("README.rst")
+
+setup(
+    name='mysqlx',
+    packages=['mysqlx'],
+    description="A thread safe sql executor for MySQL like MyBatis with connection pool. It helps you automatically manage database connections and transactions. It also provides ORM operations for single tables.",
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    install_requires=[
+        # 'Jinja2>=2.7.0',
+        'sqlx-batis>=2.1.1',
+        # 'mysql-connector-python>=8.0.13',
+    ],
+    version='2.1.1',
+    url='https://gitee.com/summry/mysqlx',
+    author='summy',
+    author_email='xiazhongbiao@126.com',
+    keywords=['sql', 'MySQL', 'MyBatis', 'python'],
+    package_data={
+        # include json and txt files
+        '': ['*.rst', '*.dtd', '*.tpl'],
+    },
+    include_package_data=True,
+    python_requires='>=3.5',
+    zip_safe=False
+)
+