一个alembic插件来保存升级和降级的记录。
Audit-Alembic的Python项目详细描述
overview
=
>一个alembic插件,可以保存升级和降级的记录。
*免费软件:MIT许可证
>安装
=====
:
=
===========
快速启动alembic environment
<;http://alembic.zzzcomputing.com/en/latest/tutorial.html>;``如果您没有
已经有一个。编辑其“env.py”以包含以下内容:
导入…
从MyApp导入版本
运行_migrations_offline():
…
上下文。配置(
…
on_version_apply=auditor.listen,
)
…
def运行_migrations_offline():
…
上下文。配置(
…
on_version_apply=auditor.listen
)
…
more involved
----
:meth:`.auditor.create`是一个工厂方法:它为您创建一个alembic history
表,只要求您指定您的应用程序版本(尽管
它还允许定制许多其他版本)。如果您已经在维护一个每当alembic操作发生时要添加记录的
表,并且
您有一个为该表创建行的可调用函数,则可以直接实例化
:类:`.auditor::
auditor=auditor(historytable,historytable.alembic_version_applied)
在这种情况下,“alembic_version_applied”必须返回一个字典,该字典可以作为“historytable”上insert语句的绑定。它的
签名与alembic的“on_version_apply”hook的
注意
当前不支持自定义要填充行的数据,也不支持自定义是否应该显示行
,但在不久的将来
版本的
`planned<;http://github.com/jpassaro/audit alembic/issues/1>;`。欢迎拉取请求。
完整的文档
==0.2.0版本完成后,可以在这里访问这些文档:
https://audit alembic.readthedocs.io/
以及
sqlite。travis似乎不支持mssql或oracle,因此这些db后端的测试状态未知。如果您发现它不适用于您的
后端,请拉取请求以使其被愉快地接受。
请从那里自由扩展。有关要处理的已知
问题的列表,请参阅问题。
testing
----
要运行基本测试::
$virtualenv venv&;source venv/bin/activate
(venv)$python setup.py install
(venv)$pip install pytest psycopg2
(venv)$pytest
要运行所有测试(即py2+py3,在所有数据库驱动程序中),运行:
$tox
有关详细信息,请参阅contribution.rst。
另请参阅我们的“Travis设置”lt;https://travis ci.org/jpassaro/audit alembic>;`.
<0.2.0
----
>预阿尔法发布。
*为alembic的“on-version-apply”回调钩子创建一个侦听器,该钩子将回调信息记录到用户选择的sql表中。
*使用sqlalchemy测试插件和实用程序以及alembic
测试实用程序。
*支持使用--sql和联机模式运行。
*测试覆盖标记、分支和其他一些复杂的用例。
*测试设置覆盖多个数据库后端。已知有效:sqlite、postgresql、
mysql。
0.1.0(2017-06-21)
----
*pypi上的第一个版本。(由Cookiecutter-Pylibrary供电)
…_ Cookiecutter-pylibrary:https://github.com/ionelmc/Cookiecutter-pylibrary