[placement] Fix placement-api-ref check tool
Some time ago the placement-api-ref source structure was changed (Ia2fd62ae7f401cad34ee7c2b355c9a5ab1c93f6b) to use inc-files istead of putting all in index.rst, but that change broke placement_api_docs.py. This change modifies placement_api_docs.py to go through all *.inc files in placement-api-ref directory and scan for the "rest method" header. Change-Id: I60150ab51173934f848662499dcf6af18625697e
This commit is contained in:
parent
640b152004
commit
90cabd0c8c
|
@ -11,6 +11,7 @@
|
|||
# under the License.
|
||||
"""Test to see if docs exists for routes and methods in the placement API."""
|
||||
|
||||
import os
|
||||
import sys
|
||||
|
||||
from nova.api.openstack.placement import handler
|
||||
|
@ -25,8 +26,8 @@ def _header_line(map_entry):
|
|||
return line
|
||||
|
||||
|
||||
def inspect_doc(doc_file):
|
||||
"""Load up doc_file and see if any routes are missing.
|
||||
def inspect_doc(doc_files):
|
||||
"""Load up doc_files and see if any routes are missing.
|
||||
|
||||
The routes are defined in handler.ROUTE_DECLARATIONS.
|
||||
"""
|
||||
|
@ -42,8 +43,10 @@ def inspect_doc(doc_file):
|
|||
for map_entry in routes:
|
||||
header_lines.append(_header_line(map_entry))
|
||||
|
||||
content_lines = []
|
||||
for doc_file in doc_files:
|
||||
with open(doc_file) as doc_fh:
|
||||
content_lines = doc_fh.read().splitlines()
|
||||
content_lines.extend(doc_fh.read().splitlines())
|
||||
|
||||
missing_lines = []
|
||||
for line in header_lines:
|
||||
|
@ -60,5 +63,7 @@ def inspect_doc(doc_file):
|
|||
|
||||
|
||||
if __name__ == '__main__':
|
||||
doc_file = sys.argv[1]
|
||||
sys.exit(inspect_doc(doc_file))
|
||||
path = sys.argv[1]
|
||||
doc_files = [os.path.join(path, file)
|
||||
for file in os.listdir(path) if file.endswith(".inc")]
|
||||
sys.exit(inspect_doc(doc_files))
|
||||
|
|
2
tox.ini
2
tox.ini
|
@ -149,7 +149,7 @@ commands =
|
|||
# TODO(cdent): Get rid of the leading '-' after all the existing
|
||||
# routes have been documented. It causes the non-zero exit code to
|
||||
# ignored.
|
||||
- python tools/placement_api_docs.py placement-api-ref/source/index.rst
|
||||
- python tools/placement_api_docs.py placement-api-ref/source/
|
||||
rm -rf placement-api-ref/build
|
||||
sphinx-build -W -b html -d placement-api-ref/build/doctrees placement-api-ref/source placement-api-ref/build/html
|
||||
|
||||
|
|
Loading…
Reference in New Issue