sanic-api 0.2.9__tar.gz → 0.3.0a1__tar.gz

sanic_api-0.3.0a1/.gitignore

@@ -0,0 +1,145 @@
+# ---> Python
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# pycharm
+.idea/
+
+# rye
+.python-version
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/

sanic_api-0.3.0a1/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  # bandit
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.10
+    hooks:
+      - id: bandit
+        args: [ "-c", "pyproject.toml" ]
+        additional_dependencies: [ "bandit[toml]" ]
+
+  # ruff
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: 'v0.6.9'
+    hooks:
+      - id: ruff
+        args: [ --fix, --exit-non-zero-on-fix, --show-fixes ]
+      - id: ruff-format

sanic_api-0.3.0a1/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.6] -2023-07-05
+
+### Fixed
+
+- 修复配置类报错的问题
+
+### Changed
+
+- 升级sanic依赖版本为22.3
+- 增加`setuptools`依赖
+
+## [0.2.5] - 2023-04-09
+
+### Added
+
+- 支持捕获在中间件期间发生错误的异常情况
+- 增加配置类功能
+- 示例文件更新
+- 工具方法中新增自动蓝图方法
+
+### Changed
+
+- 默认的json dumps方法改为orjson
+- sanic 最低版本依赖更新至22.12
+- 优化API响应封装及响应文档的生成
+
+### Fixed
+
+- 修复openapi tag重复的问题
+- 修复日志级别判断不准问题
+
+## [0.2.4] - 2023-02-05
+
+### Fixed
+
+- 修复示例文件不生效的问题
+
+## [0.2.3] - 2023-02-03
+
+### Fixed
+
+- 修复无蓝图的api接口blueprint.ctx.desc报错的问题
+- 实现_missing_方法，修复枚举基类无法识别枚举值的问题
+
+### Changed
+
+- 请求接口无参数时访问日志中不打印 “args:”
+- 枚举基类字段类名称修改，避免重名
+
+### Added
+
+- API接口类支持自定义接口标签和接口描述
+- 添加types-ujson包
+- 自动生成的文档支持识别必须和可选参数
+- 枚举基类增加to_desc方法列出枚举的所有描述
+
+## [0.2.0] - 2023-01-19
+
+### Changed
+
+- api json序列化改为使用ujson
+- 移除部分3.10以上的语法
+
+### Added
+
+- 日志功能优化改进:
+    - 实现方式更加简洁优雅
+    - 可按照类型去区分
+    - 日志增加打印请求ID
+- json响应体格式设置为可配置的
+- 添加ujson包，移除orjson包
+- 读取蓝图上面的 blueprint.ctx.desc 属性来代替name设置中文tag名
+- 引入mypy、autoflake等代码检查工具
+- 添加配置文件基类
+
+## [0.1.1] - 2022-12-19
+
+### Changed
+
+- pip 首页的文件修改
+
+## [0.1.0] - 2022-12-19
+
+### Added
+
+- 接口参数校验
+- 接口文档生成
+- 日志使用`loguru`代替
+- 接口异常拦截
+- 接口响应统一化

sanic_api-0.3.0a1/COMMIT_GUIDE.MD

@@ -0,0 +1,10 @@
+- ✨  feat: 一个新特性
+- ➕  improvement: 对现有特性的提升
+- 🐛  fix: 修复Bug
+- 🛠  refactor: 代码重构，注意和特性、重构区分开
+- 📚  docs: 变更文档
+- 💅  style: 修改格式，不影响功能，例如空格、代码格式等
+- 📈  perf: 性能提升
+- 🔧  ci: 修改ci相关配置、脚本等
+- ⏪  revert: 回退版本
+- 🗯  chore: 杂务，不属于以上类型，例如run build、引入或更新软件包等

{sanic-api-0.2.9 → sanic_api-0.3.0a1}/PKG-INFO

@@ -1,10 +1,38 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: sanic-api
-Version: 0.2.9
+Version: 0.3.0a1
 Summary: Sanic 框架实用API工具集，拥有自动生成文档、参数校验、配置的导入、日志功能的优化等功能，更好的助力接口的开发
-License: MIT
+Project-URL: homepage, https://github.com/x-haose/sanic-api
+Project-URL: repository, https://github.com/x-haose/sanic-api
+Project-URL: documentation, https://github.com/x-haose/sanic-api
 Author-email: 昊色居士 <xhrtxh@gmail.com>
-Requires-Python: >=3.8,<3.12
+License: MIT
+Keywords: Sanic,Sanic扩展,异步
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: hs-config==0.1.3a5
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: loki-logger-handler>=0.1.4
+Requires-Dist: orjson>=3.8.6
+Requires-Dist: pydantic-settings[toml,yaml]>=2.5.2
+Requires-Dist: pydantic[dotenv]>=2.9.2
+Requires-Dist: requests>=2.32.3
+Requires-Dist: sanic-ext>=23.12.0
+Requires-Dist: sanic>=23.12.0
+Requires-Dist: sentry-sdk>=2.17.0
+Requires-Dist: ujson>=5.7.0
 Description-Content-Type: text/markdown
 
 ![logo](https://images.haose.pro/2022/12/19/logo_17%3A34%3A07_qkt9yi4d7u.png)
@@ -86,4 +114,3 @@ if __name__ == '__main__':
 ## 文档
 
 [文档](https://linktodocumentation)
-

sanic-api-0.2.9/README.MD → sanic_api-0.3.0a1/README.md

@@ -1,79 +1,79 @@
-![logo](https://images.haose.pro/2022/12/19/logo_17%3A34%3A07_qkt9yi4d7u.png)
-
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
-[![Python](https://img.shields.io/badge/Python-3.8+-yellow.svg?logo=python)]()
-[![Sanic](https://img.shields.io/badge/framework-Sanic-Server.svg)](http://www.gnu.org/licenses/agpl-3.0)
-[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
-
-# Sanic-API
-
-让您的sanic服务程序更好的支持API文档、参数校验、日志打印、响应规范等
-
-## 特性
-
-- 无需任何多余改动，全自动生成openapi文档，使用更加方便
-
-- 基于`pydantic`的参数校验器，让接口的请求及响应更符合你的预期
-
-- 使用`loguru`库代替官方`logging`日志库，并对访问日志进行扩展，支持打印接口耗时、接口参数
-
-- 使用`{code: 0, data: null, msg: ""}`样式的接口返回
-
-- 对接口中的异常进行拦截，及自定义错误码
-
-- 接口返回样式可自定义配置
-
-## 截图
-
-## 路线图
-
-- 增加一键生成预设项目cli命令
-
-- 编写详细文档
-
-- API接口增加请求头、URL路径参数收集和校验:
-
-## 安装
-
-使用 pip 安装 sanic-api
-
-```bash
-  pip install sanic-api
-```
-
-## 使用方法/示例
-
-```python
-from sanic import Sanic, text
-from sanic_api import init_api
-
-app = Sanic("Sanic-API")
-
-
-@app.get('/')
-async def index(request):
-    return text("Sanic-API Example")
-
-
-def main():
-    init_api(app)
-    app.run(access_log=True)
-
-
-if __name__ == '__main__':
-    main()
-
-```
-
-## 开发
-
-要部署这个项目，请运行
-
-```bash
-  pip install pdm
-  pdm sync
-```
-
-## 文档
-
-[文档](https://linktodocumentation)
+![logo](https://images.haose.pro/2022/12/19/logo_17%3A34%3A07_qkt9yi4d7u.png)
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![Python](https://img.shields.io/badge/Python-3.8+-yellow.svg?logo=python)]()
+[![Sanic](https://img.shields.io/badge/framework-Sanic-Server.svg)](http://www.gnu.org/licenses/agpl-3.0)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+# Sanic-API
+
+让您的sanic服务程序更好的支持API文档、参数校验、日志打印、响应规范等
+
+## 特性
+
+- 无需任何多余改动，全自动生成openapi文档，使用更加方便
+
+- 基于`pydantic`的参数校验器，让接口的请求及响应更符合你的预期
+
+- 使用`loguru`库代替官方`logging`日志库，并对访问日志进行扩展，支持打印接口耗时、接口参数
+
+- 使用`{code: 0, data: null, msg: ""}`样式的接口返回
+
+- 对接口中的异常进行拦截，及自定义错误码
+
+- 接口返回样式可自定义配置
+
+## 截图
+
+## 路线图
+
+- 增加一键生成预设项目cli命令
+
+- 编写详细文档
+
+- API接口增加请求头、URL路径参数收集和校验:
+
+## 安装
+
+使用 pip 安装 sanic-api
+
+```bash
+  pip install sanic-api
+```
+
+## 使用方法/示例
+
+```python
+from sanic import Sanic, text
+from sanic_api import init_api
+
+app = Sanic("Sanic-API")
+
+
+@app.get('/')
+async def index(request):
+    return text("Sanic-API Example")
+
+
+def main():
+    init_api(app)
+    app.run(access_log=True)
+
+
+if __name__ == '__main__':
+    main()
+
+```
+
+## 开发
+
+要部署这个项目，请运行
+
+```bash
+  pip install pdm
+  pdm sync
+```
+
+## 文档
+
+[文档](https://linktodocumentation)

sanic_api-0.3.0a1/example/app.py

@@ -0,0 +1,56 @@
+from pydantic import BaseModel, Field
+from sanic import Blueprint, Sanic, json
+from sanic.log import logger
+
+from sanic_api.api import BaseRespTml, Request
+from sanic_api.app import BaseApp
+
+user_blueprint = Blueprint("user", "/user")
+
+
+class UserInfoModel(BaseModel):
+    user_id: int = Field(title="用户ID")
+
+
+class UserInfoResponse(BaseRespTml):
+    user_name: str = Field(title="用户名")
+
+
+class UseLoginRequest(Request):
+    form_data: UserInfoModel
+
+
+@user_blueprint.post("info")
+async def user_info(request: Request, json_data: UserInfoModel):
+    """
+    获取用户信息
+    """
+    logger.info(f"data: {json_data}")
+    info = UserInfoResponse(user_name="张三")
+    info.temp_data.code = "0000"
+    info.temp_data.msg = "查询成功"
+    return info.resp()
+
+
+@user_blueprint.post("login")
+async def user_login(request: UseLoginRequest):
+    """
+    用户登录
+    """
+    logger.info(f"user_id: {request.form_data.user_id}")
+    return json(request.form_data.model_dump())
+
+
+class App(BaseApp):
+    """
+    服务示例
+    """
+
+    async def setup_route(self, app: Sanic):
+        api = Blueprint.group(url_prefix="api")
+        api.append(user_blueprint)
+        app.blueprint(api)
+
+
+if __name__ == "__main__":
+    App.run()