BatisX 2.2.4__tar.gz → 2.2.5__tar.gz

{BatisX-2.2.4 → BatisX-2.2.5}/BatisX.egg-info/PKG-INFO

@@ -1,16 +1,15 @@
 Metadata-Version: 2.1
 Name: BatisX
-Version: 2.2.4
+Version: 2.2.5
 Summary: A easy thread safe sql executor for Python like MyBatis with connection pool. It helps you automatically manage database connections and transactions. Support MySQL, PostgreSQL, SQLite etc.
 Home-page: https://gitee.com/summry/batisx
 Author: summy
 Author-email: xiazhongbiao@126.com
-License: UNKNOWN
 Keywords: sql,MySQL,PostgreSQL,MyBatis,python
-Platform: UNKNOWN
 Requires-Python: >=3.5
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: mysqlx>=2.3.1
 
 Mapper file
 '''''''''''
@@ -177,11 +176,10 @@ Transaction
                 insert_func(....)
                 update_func(....)
 
+If you want to use ORM, may be you need SQLORMX: https://pypi.org/project/sqlormx
 
-If you want to operate MySQL database, may be you need MySqlx: https://pypi.org/project/mysqlx
-
-If you want to operate PostgreSQL database, may be you need MySqlx: https://pypi.org/project/pgsqlx
-
-If you just wanted a simple sql executor, may be you need sqlx-exec: https://pypi.org/project/sqlexecx
+If you want to operate MySQL database, may be you need MySQLX: https://pypi.org/project/mysqlx
 
+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 SQLExecX: https://pypi.org/project/sqlexecx

BatisX-2.2.5/BatisX.egg-info/requires.txt

@@ -0,0 +1 @@
+mysqlx>=2.3.1

{BatisX-2.2.4 → BatisX-2.2.5}/PKG-INFO

@@ -1,16 +1,15 @@
 Metadata-Version: 2.1
 Name: BatisX
-Version: 2.2.4
+Version: 2.2.5
 Summary: A easy thread safe sql executor for Python like MyBatis with connection pool. It helps you automatically manage database connections and transactions. Support MySQL, PostgreSQL, SQLite etc.
 Home-page: https://gitee.com/summry/batisx
 Author: summy
 Author-email: xiazhongbiao@126.com
-License: UNKNOWN
 Keywords: sql,MySQL,PostgreSQL,MyBatis,python
-Platform: UNKNOWN
 Requires-Python: >=3.5
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: mysqlx>=2.3.1
 
 Mapper file
 '''''''''''
@@ -177,11 +176,10 @@ Transaction
                 insert_func(....)
                 update_func(....)
 
+If you want to use ORM, may be you need SQLORMX: https://pypi.org/project/sqlormx
 
-If you want to operate MySQL database, may be you need MySqlx: https://pypi.org/project/mysqlx
-
-If you want to operate PostgreSQL database, may be you need MySqlx: https://pypi.org/project/pgsqlx
-
-If you just wanted a simple sql executor, may be you need sqlx-exec: https://pypi.org/project/sqlexecx
+If you want to operate MySQL database, may be you need MySQLX: https://pypi.org/project/mysqlx
 
+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 SQLExecX: https://pypi.org/project/sqlexecx

{BatisX-2.2.4 → BatisX-2.2.5}/README.rst

@@ -163,9 +163,10 @@ Transaction
                 insert_func(....)
                 update_func(....)
 
+If you want to use ORM, may be you need SQLORMX: https://pypi.org/project/sqlormx
 
-If you want to operate MySQL database, may be you need MySqlx: https://pypi.org/project/mysqlx
+If you want to operate MySQL database, may be you need MySQLX: https://pypi.org/project/mysqlx
 
-If you want to operate PostgreSQL database, may be you need MySqlx: https://pypi.org/project/pgsqlx
+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/sqlexecx
+If you just wanted a simple sql executor, may be you need SQLExecX: https://pypi.org/project/sqlexecx

BatisX-2.2.5/batisx/__init__.py

@@ -0,0 +1,71 @@
+"""
+可以设置`SQL_CACHE_SIZE`环境变量来设置缓存大小，默认是128。
+linux or macos:
+export SQL_CACHE_SIZE=256
+windows:
+set SQL_CACHE_SIZE=256
+
+可以设置`LRU_CACHE_SIZE`环境变量来设置缓存大小，默认是64。
+linux or macos:
+export LRU_CACHE_SIZE=128
+windows:
+set LRU_CACHE_SIZE=128
+"""
+
+from mysqlx import (
+    conn,
+    trans,
+    get_connection,
+    close,
+    Driver,
+    Dialect,
+    Engine
+)
+from .sql_mapper import sql, mapper
+
+
+def init_db(*args, **kwargs) -> Engine:
+    """
+    Compliant with the Python DB API 2.0 (PEP-249).
+
+    Addition parameters:
+    - mapper_path: str, path of mapper files
+    - driver=None: str|Driver, 'psycopg2' or 'pymysql' or 'mysql.connector' or 'sqlite3' or 'turso'
+    - pool_size=0: int, default 0, size of connection pool
+    - show_sql=False: bool,  if True, print sql
+    - debug=False: bool, if True, print debug context
+
+    Other parameters of connection pool refer to DBUtils: https://webwareforpython.github.io/DBUtils/main.html#pooleddb-pooled-db
+
+    Examples
+    --------
+    >>> from mysqlx import db, trans, init_db
+    >>> init_db('db.sqlite3', mapper_path='./mapper', driver='sqlite3', debug=True)
+    Engine.SQLITE
+    >>> init_db("postgres://user:password@127.0.0.1:5432/testdb", driver='psycopg2', pool_size=5, debug=True)
+    Engine.POSTGRESQL
+    >>> init_db(user='root', password='xxx', host='127.0.0.1', port=3306, database='testdb', driver='pymysql', mapper_path='./mapper')
+    Engine.MYSQL
+    """
+    from mysqlx.sql_holder import load_mapper
+
+    mapper_path = kwargs.pop(InitArgs.MAPPER_PATH) if InitArgs.MAPPER_PATH in kwargs else None
+    engine = _init(*args, **kwargs)
+    if mapper_path:
+        load_mapper(mapper_path)
+    return engine
+    
+
+__all__ = [
+    'conn',
+    'trans',
+    'get_connection',
+    'close',
+    'Driver',
+    'Dialect',
+    'Engine',
+    'init_db',
+    'sql',
+    'mapper'
+]
+

{BatisX-2.2.4 → BatisX-2.2.5}/batisx/db.py

@@ -1,3 +1,4 @@
+from typing import Any
 from mysqlx import sql_support
 # Don't remove. Import for not repetitive implementation
 from sqlexecx import save_select_key, do_save_sql_select_key
@@ -6,7 +7,7 @@ from mysqlx.db import insert, save, execute, batch_insert, batch_execute, get, q
     do_save_sql, drop_table, truncate_table, sql, table, page
 
 
-def save_sql(sql: str, *args, **kwargs):
+def save_sql(sql: str, *args, **kwargs) -> Any:
     """
     Insert data into table, return primary key.
 
@@ -25,7 +26,7 @@ def save_sql(sql: str, *args, **kwargs):
     return do_save_sql(sql, *args)
 
 
-def save_sql_select_key(select_key: str, sql: str, *args, **kwargs):
+def save_sql_select_key(select_key: str, sql: str, *args, **kwargs) -> Any:
     """
     Insert data into table, return primary key.
 

{BatisX-2.2.4 → BatisX-2.2.5}/batisx/dbx.py

@@ -1,3 +1,4 @@
+from typing import Any
 from mysqlx import sql_holder as holder
 from mysqlx.dbx import batch_execute, execute, get, query, query_one, select, select_one, select_page, query_page, sql, page
 
@@ -5,7 +6,7 @@ from . import db
 from .log_support import logger, sql_id_log, page_sql_id_log, sql_id_select_key_log
 
 
-def save(sql_id: str, *args, **kwargs):
+def save(sql_id: str, *args, **kwargs) -> Any:
     """
     Execute insert SQL, return primary key.
     :return: Primary key
@@ -19,7 +20,7 @@ def save(sql_id: str, *args, **kwargs):
     return db.do_save_sql(sql, *args)
 
 
-def save_select_key(select_key, sql_id: str, *args, **kwargs):
+def save_select_key(select_key, sql_id: str, *args, **kwargs) -> Any:
     """
     Execute insert SQL, return primary key.
     :return: Primary key

{BatisX-2.2.4 → BatisX-2.2.5}/batisx/sql_id_exec.py

@@ -1,3 +1,4 @@
+from typing import Any
 from . import dbx
 from mysqlx.sql_id_exec import SqlExec as _SqlExec
 from sqlexecx.page_exec import PageExec
@@ -5,7 +6,7 @@ from sqlexecx.page_exec import PageExec
 
 class SqlExec(_SqlExec):
 
-    def save_select_key(self, select_key: str, *args, **kwargs):
+    def save_select_key(self, select_key: str, *args, **kwargs) -> Any:
         """
         Insert data into table, return primary key.
 
@@ -16,10 +17,10 @@ class SqlExec(_SqlExec):
         return self.exec.save_select_key(select_key, self.sql, *args, **kwargs)
 
 
-def sql(sql: str) :
+def sql(sql: str) -> SqlExec:
     assert sql, "Parameter 'sql' must not be none"
     return SqlExec(dbx, sql)
 
 
-def page(page_num: int, page_size: int) :
+def page(page_num: int, page_size: int) -> PageExec:
     return PageExec(dbx, page_num, page_size)

{BatisX-2.2.4 → BatisX-2.2.5}/batisx/sql_page_exec.py

@@ -3,7 +3,7 @@ from sqlexecx.sql_exec import SqlExec
 from sqlexecx.page_exec import PageExec
 
 
-def sql(sql: str):
+def sql(sql: str) -> SqlExec:
     """
     Get a SqlExec instance
 
@@ -16,7 +16,7 @@ def sql(sql: str):
     return SqlExec(db, sql)
 
 
-def page(page_num: int, page_size: int):
+def page(page_num: int, page_size: int) -> PageExec:
     """
     Get a PageExec instance
 

{BatisX-2.2.4 → BatisX-2.2.5}/setup.py

@@ -18,9 +18,9 @@ setup(
     long_description=long_description,
     long_description_content_type='text/markdown',
     install_requires=[
-        'mysqlx>=2.2.8',
+        'mysqlx>=2.3.1',
     ],
-    version='2.2.4',
+    version='2.2.5',
     url='https://gitee.com/summry/batisx',
     author='summy',
     author_email='xiazhongbiao@126.com',

BatisX-2.2.4/BatisX.egg-info/requires.txt

@@ -1 +0,0 @@
-mysqlx>=2.2.8

BatisX-2.2.4/batisx/__init__.py

@@ -1,11 +0,0 @@
-from mysqlx import (
-    conn,
-    trans,
-    get_connection,
-    close,
-    Driver,
-    Dialect,
-    init_db
-)
-from .sql_mapper import sql, mapper
-