从您的Django项目创建模型定义文档。
项目描述
从您的django项目创建模型定义文档。此项目有助于与Django模型相关的文档。
快速开始
将“modelsdoc”添加到您的INSTALLED_APPS设置中,如下所示
INSTALLED_APPS = ( ... 'modelsdoc', )
运行 python manage.py listing_models 来列出模型定义
您可以看到执行此命令的结果,链接到tests/models.py。
选项
–app(-a)
您可以传递指定应用程序名称。仅列出指定的应用程序。
$ python manage.py listing_models --app polls
–output(-o)
它将结果写入指定的文件。
$ python manage.py listing_models --output sample.rst
–format(-f)
您可以选择输出格式。 rst(reStructuredText)或 md(Markdown)。默认格式是 rst。
$ python manage.py listing_models --format md
自定义设置
MODELSDOC_APPS
您可以选择应用程序并更改顺序。
# output only models of poll MODELSDOC_APPS = (polls,)
MODELSDOC_DISPLAY_FIELDS
您可以选择字段值并更改顺序。
MODELSDOC_DISPLAY_FIELDS = ( ('Fullname', 'verbose_name'), ('Name', 'name'), ('Type', 'db_type'), ('PK', 'primary_key'), ('Unique', 'unique'), ('Index', 'db_index'), ('Null/Blank', 'null_blank'), ('Comment', 'comment'), )
MODELSDOC_MODEL_OPTIONS
# TODO 更详细的文档
MODELSDOC_MODEL_OPTIONS = ( 'unique_together', 'index_together', 'ordering', 'permissions', 'get_latest_by', 'order_with_respect_to', 'db_tablespace', 'abstract', 'swappable', 'select_on_save', 'default_permissions', 'default_related_name' )
其他设置
# TODO 更详细的文档
MODELSDOC_OUTPUT_TEMPLATE = 'modelsdoc/models' MODELSDOC_OUTPUT_FORMAT = 'rst' # default format MODELSDOC_MODEL_WRAPPER = 'modelsdoc.wrappers.ModelWrapper' MODELSDOC_FIELD_WRAPPER = 'modelsdoc.wrappers.FieldWrapper' MODELSDOC_INCLUDE_AUTO_CREATED = True
Python和Django支持
Django.1.5 |
Django1.6 |
Django1.7 |
Django1.8 |
Django1.9 |
Django1.10 |
Django1.11 |
Django2.0 |
|
Python 2.7 |
◯ |
◯ |
◯ |
◯ |
◯ |
◯ |
◯ |
|
PyPy |
◯ |
◯ |
◯ |
◯ |
◯ |
◯ |
◯ |
|
Python 3.3 |
◯ |
◯ |
||||||
Python 3.4 |
◯ |
◯ |
◯ |
◯ |
◯ |
◯ |
||
Python 3.5 |
◯ |
◯ |
◯ |
◯ |
◯ |
|||
Python 3.6 |
◯ |
◯ |
◯ |
◯ |
◯ |
许可
MIT 许可证。具体条款请参阅 LICENSE 文件。
历史
0.1.11(2019年11月28日)
添加 models.yaml 模板文件。
0.1.10(2019年11月28日)
添加对 YAML 格式的支持。
0.1.9(2018年2月8日)
修复 动态设置部分长度。感谢 wanshot。
0.1.8(2017年12月3日)
添加对 Django2.0 的支持。
0.1.7(2017年5月29日)
添加对 Django1.11 和 Python 3.6 的支持。
0.1.6(2016年11月4日)
添加对 Django1.10 的支持。
0.1.5(2016年5月4日)
添加对 Python3.5 和 Django1.9 的支持。
0.1.4(2015年9月23日)
修复错误。打印模型时忽略换行符。
在“listing_models”结果中添加 ManyToManyField 的信息。
0.1.3(2015年7月19日)
修复错误。安装测试代码。
添加新选项“MODELSDOC_INCLUDE_AUTO_CREATED”
0.1.2(2015年6月21日)
错误修复。不包括输出模板。
0.1.0(2015年6月21日)
首次发布
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。
源代码分发
构建分发
哈希值 for django_modelsdoc-0.1.11-py2.py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 21c5b56bfd480feb59e4d8c4d6dc5b3848a8cbd5877cd50b739d1ae4371f23d7 |
|
MD5 | 731f498881b9d0489b35ef46e29a6e58 |
|
BLAKE2b-256 | 3a5add0097a8e7cab4cc8382dfcc4ad0642e64dec90a56c3cb9e8fbe77a8b5b2 |