Metadata-Version: 2.1
Name: annosSQL
Version: 2.0.0
Summary: python for mysql operation
Home-page: https://gitee.com/chx516/annosSQL
Author: czh
Author-email: utowe@qq.com
License: MIT
Keywords: python annos
Platform: UNKNOWN
Requires-Python: >=3
Description-Content-Type: text/markdown

# annosSQL

#### 介绍
annosSQL是一个基于python实现对mysql、oracle、sqllite数据库交互库，基础是基于对pymysql等库的封装，其用法有些特别。annosSQL中实现了一种缓存算法（通过LRU算法实现），对于近期相同sql的查询，
会优先从缓存获取，当缓存空间不存在该数据时，再次访问数据库。

#### 安装教程
```shell
pip install annosSQL
```

#### 使用说明

1. 使用案例
```python
from annosSQL.Innos.Interface import Interface, Handler
from annosSQL.Donos.doconn import Connection
from annosSQL.Donos.dosql import execute

@Interface()
class T4:
    #配置处理器，这是入口，是必须
    @Handler()
    def hand(self) -> list: pass

    #配置连接池
    @Connection(driver="mysql", host="127.0.0.1", user="root", password="123456", port=3306, database="czh")
    def conn(self) -> any: pass

    '''
    查询所有数据，p1方法不能有任何的形参变量，必须是空函数，'->'箭头后面跟的是返回值类型，'list'或'dict'或'tuple'都行
    这里返回list数据类型
    '''
    @execute(sql="select * from user_copy1")
    def p1(self) -> list: pass

    @execute(sql="select * from user_copy1")
    def p2(self) -> dict: pass

    @execute(sql="select * from user_copy1")
    def p3(self) -> tuple: pass

    '''
    占位符使用 {}/#{}/%s,
    条件查询时，函数的形参必须带类型，如s1方法里的id必须写出：id:int
    '''
    # {}占位符是通过str().format()实现的，此时，函数形参的位置十分重要，它将影响sql的条件的正确性
    @execute(sql="select * from user_copy1 where id={}")
    def s1(self,id:int) -> list: pass
    # #{}占位符的基本形式如下：#{1}，通过#{}大括号里的数值来定位绑定到函数的形参
    @execute(sql="select * from user_copy1 where id=#{1}")
    def s2(self, id: int) -> dict: pass
    # %s 多行占位符 支持数据多行数据类型：列表与元组
    @execute(sql="select * from user_copy1 where id=%s")
    def s3(self, id: int) -> tuple: pass

    '''
    快捷符的使用：A(select)
    '''
    @execute(sql="A(select) user_copy1")
    def a1(self) -> tuple: pass



if __name__=='__main__':
    t4=T4()
    t4.hand() #调用入口
    print('p1返回的数据：')
    p1=t4.p1()
    print(p1)

    print('p2返回的数据：')
    p2 = t4.p2()
    print(p2)

    print('p3返回的数据：')
    p3 = t4.p3()
    print(p3)

    print('s1返回的数据：')
    s1 = t4.s1(1)
    print(s1)

    print('s2返回的数据：')
    s2 = t4.s2(1)
    print(s2)

    print('s3返回的数据：')
    s3 = t4.s2(1)
    print(s3)

    print('a1返回的数据：')
    a1 = t4.a1()
    print(a1)    

```
2. 运行结果
```text
p1返回的数据：
[[1, 'chx', '123455', '1'], [2, 'czh', '123456', '2']]
p2返回的数据：
[{'id': 1, 'user': 'chx', 'password': '123455', 'z': '1'}, {'id': 2, 'user': 'czh', 'password': '123456', 'z': '2'}]
p3返回的数据：
((1, 'chx', '123455', '1'), (2, 'czh', '123456', '2'))
s1返回的数据：
[[1, 'chx', '123455', '1']]
s2返回的数据：
[{'id': 1, 'user': 'chx', 'password': '123455', 'z': '1'}]
s3返回的数据：
[{'id': 1, 'user': 'chx', 'password': '123455', 'z': '1'}]
a1返回的数据：
((1, 'chx', '123455', '1'), (2, 'czh', '123456', '2'))
```
3. xxxx
#### 其他说明
> #{} %s {}
    # #{}、 {} 普通占位符
    # %s 多行占位符 支持数据多行数据类型：列表与元组
    # select * from  ->  A(select) user
    # insert into table values(S{,}[])
    # insert into table values(C{})
    # insert into table values(L{})
    # insert into table values(T{%s,%s})



