Added docs autogeneration for error list

Change-Id: I4d322863c06731bf0c5f540394711eab7c24de23
This commit is contained in:
sslypushenko 2016-09-07 14:57:05 +03:00
parent 628b30fc2c
commit a71fe26c19
5 changed files with 54 additions and 1 deletions

1
.gitignore vendored
View File

@ -17,6 +17,7 @@ develop-eggs
.installed.cfg
lib
lib64
doc/source/_errors_list.rst
# Installer logs
pip-log.txt

4
doc/source/errors.rst Normal file
View File

@ -0,0 +1,4 @@
==============
List of errors
==============
.. include:: _errors_list.rst

View File

@ -13,6 +13,7 @@ Contents:
readme
installation
errors
usage
contributing

45
tools/gen_errors.py Normal file
View File

@ -0,0 +1,45 @@
# Copyright 2016: Mirantis Inc.
# All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
import jinja2
import six
from muranopkgcheck import error
TEMPLATE = """
============ ================================================================
CODE DESCRITION
============ ================================================================
{% for err in errors %}{{ err.code }} {{err.description}}
{% endfor %}
============ ================================================================
"""
def main():
from muranopkgcheck import validators
print('Validators:')
for v in validators.VALIDATORS:
print(v.__name__)
errors = sorted(six.itervalues(error.errors),
key=lambda item: item['code'])
t = jinja2.Template(TEMPLATE)
r = t.render(errors=errors)
print(r)
with open('doc/source/_errors_list.rst', 'w') as f:
f.write(r)
if __name__ == '__main__':
main()

View File

@ -23,7 +23,9 @@ commands = {posargs}
commands = {toxinidir}/tools/cover.sh {posargs}
[testenv:docs]
commands = python setup.py build_sphinx
commands =
python tools/gen_errors.py
python setup.py build_sphinx
[testenv:releasenotes]
commands =