Feature/azaytsev/from 2021 4 (#9247)
* Added info on DockerHub CI Framework
* Feature/azaytsev/change layout (#3295)
* Changes according to feedback comments
* Replaced @ref's with html links
* Fixed links, added a title page for installing from repos and images, fixed formatting issues
* Added links
* minor fix
* Added DL Streamer to the list of components installed by default
* Link fixes
* Link fixes
* ovms doc fix (#2988)
* added OpenVINO Model Server
* ovms doc fixes
Co-authored-by: Trawinski, Dariusz <dariusz.trawinski@intel.com>
* Updated openvino_docs.xml
* Updated the link to software license agreements
* Revert "Updated the link to software license agreements"
This reverts commit 706dac500e.
* Docs to Sphinx (#8151)
* docs to sphinx
* Update GPU.md
* Update CPU.md
* Update AUTO.md
* Update performance_int8_vs_fp32.md
* update
* update md
* updates
* disable doc ci
* disable ci
* fix index.rst
Co-authored-by: Andrey Zaytsev <andrey.zaytsev@intel.com>
# Conflicts:
# .gitignore
# docs/CMakeLists.txt
# docs/IE_DG/Deep_Learning_Inference_Engine_DevGuide.md
# docs/IE_DG/Extensibility_DG/Custom_ONNX_Ops.md
# docs/IE_DG/Extensibility_DG/VPU_Kernel.md
# docs/IE_DG/InferenceEngine_QueryAPI.md
# docs/IE_DG/Int8Inference.md
# docs/IE_DG/Integrate_with_customer_application_new_API.md
# docs/IE_DG/Model_caching_overview.md
# docs/IE_DG/supported_plugins/GPU_RemoteBlob_API.md
# docs/IE_DG/supported_plugins/HETERO.md
# docs/IE_DG/supported_plugins/MULTI.md
# docs/MO_DG/prepare_model/convert_model/Convert_Model_From_Caffe.md
# docs/MO_DG/prepare_model/convert_model/Convert_Model_From_Kaldi.md
# docs/MO_DG/prepare_model/convert_model/Convert_Model_From_MxNet.md
# docs/MO_DG/prepare_model/convert_model/Convert_Model_From_ONNX.md
# docs/MO_DG/prepare_model/convert_model/Converting_Model.md
# docs/MO_DG/prepare_model/convert_model/Converting_Model_General.md
# docs/MO_DG/prepare_model/convert_model/Cutting_Model.md
# docs/MO_DG/prepare_model/convert_model/pytorch_specific/Convert_RNNT.md
# docs/MO_DG/prepare_model/convert_model/tf_specific/Convert_EfficientDet_Models.md
# docs/MO_DG/prepare_model/convert_model/tf_specific/Convert_WideAndDeep_Family_Models.md
# docs/MO_DG/prepare_model/convert_model/tf_specific/Convert_YOLO_From_Tensorflow.md
# docs/doxygen/Doxyfile.config
# docs/doxygen/ie_docs.xml
# docs/doxygen/ie_plugin_api.config
# docs/doxygen/ngraph_cpp_api.config
# docs/doxygen/openvino_docs.xml
# docs/get_started/get_started_macos.md
# docs/get_started/get_started_raspbian.md
# docs/get_started/get_started_windows.md
# docs/img/cpu_int8_flow.png
# docs/index.md
# docs/install_guides/VisionAcceleratorFPGA_Configure.md
# docs/install_guides/VisionAcceleratorFPGA_Configure_Windows.md
# docs/install_guides/deployment-manager-tool.md
# docs/install_guides/installing-openvino-linux.md
# docs/install_guides/installing-openvino-macos.md
# docs/install_guides/installing-openvino-windows.md
# docs/optimization_guide/dldt_optimization_guide.md
# inference-engine/ie_bridges/c/include/c_api/ie_c_api.h
# inference-engine/ie_bridges/python/docs/api_overview.md
# inference-engine/ie_bridges/python/sample/ngraph_function_creation_sample/README.md
# inference-engine/ie_bridges/python/sample/speech_sample/README.md
# inference-engine/ie_bridges/python/src/openvino/inference_engine/ie_api.pyx
# inference-engine/include/ie_api.h
# inference-engine/include/ie_core.hpp
# inference-engine/include/ie_version.hpp
# inference-engine/samples/benchmark_app/README.md
# inference-engine/samples/speech_sample/README.md
# inference-engine/src/plugin_api/exec_graph_info.hpp
# inference-engine/src/plugin_api/file_utils.h
# inference-engine/src/transformations/include/transformations_visibility.hpp
# inference-engine/tools/benchmark_tool/README.md
# ngraph/core/include/ngraph/ngraph.hpp
# ngraph/frontend/onnx_common/include/onnx_common/parser.hpp
# ngraph/python/src/ngraph/utils/node_factory.py
# openvino/itt/include/openvino/itt.hpp
# thirdparty/ade
# tools/benchmark/README.md
* Cherry-picked remove font-family (#8211)
* Cherry-picked: Update get_started_scripts.md (#8338)
* doc updates (#8268)
* Various doc changes
* theme changes
* remove font-family (#8211)
* fix css
* Update uninstalling-openvino.md
* fix css
* fix
* Fixes for Installation Guides
Co-authored-by: Andrey Zaytsev <andrey.zaytsev@intel.com>
Co-authored-by: kblaszczak-intel <karol.blaszczak@intel.com>
# Conflicts:
# docs/IE_DG/Bfloat16Inference.md
# docs/IE_DG/InferenceEngine_QueryAPI.md
# docs/IE_DG/OnnxImporterTutorial.md
# docs/IE_DG/supported_plugins/AUTO.md
# docs/IE_DG/supported_plugins/HETERO.md
# docs/IE_DG/supported_plugins/MULTI.md
# docs/MO_DG/prepare_model/convert_model/Convert_Model_From_Kaldi.md
# docs/MO_DG/prepare_model/convert_model/tf_specific/Convert_YOLO_From_Tensorflow.md
# docs/install_guides/installing-openvino-macos.md
# docs/install_guides/installing-openvino-windows.md
# docs/ops/opset.md
# inference-engine/samples/benchmark_app/README.md
# inference-engine/tools/benchmark_tool/README.md
# thirdparty/ade
* Cherry-picked: doc script changes (#8568)
* fix openvino-sphinx-theme
* add linkcheck target
* fix
* change version
* add doxygen-xfail.txt
* fix
* AA
* fix
* fix
* fix
* fix
* fix
# Conflicts:
# thirdparty/ade
* Cherry-pick: Feature/azaytsev/doc updates gna 2021 4 2 (#8567)
* Various doc changes
* Reformatted C++/Pythob sections. Updated with info from PR8490
* additional fix
* Gemini Lake replaced with Elkhart Lake
* Fixed links in IGs, Added 12th Gen
# Conflicts:
# docs/IE_DG/supported_plugins/GNA.md
# thirdparty/ade
* Cherry-pick: Feature/azaytsev/doc fixes (#8897)
* Various doc changes
* Removed the empty Learning path topic
* Restored the Gemini Lake CPIU list
# Conflicts:
# docs/IE_DG/supported_plugins/GNA.md
# thirdparty/ade
* Cherry-pick: sphinx copybutton doxyrest code blocks (#8992)
# Conflicts:
# thirdparty/ade
* Cherry-pick: iframe video enable fullscreen (#9041)
# Conflicts:
# thirdparty/ade
* Cherry-pick: fix untitled titles (#9213)
# Conflicts:
# thirdparty/ade
* Cherry-pick: perf bench graph animation (#9045)
* animation
* fix
# Conflicts:
# thirdparty/ade
* Cherry-pick: doc pytest (#8888)
* docs pytest
* fixes
# Conflicts:
# docs/doxygen/doxygen-ignore.txt
# docs/scripts/ie_docs.xml
# thirdparty/ade
* Cherry-pick: restore deleted files (#9215)
* Added new operations to the doc structure (from removed ie_docs.xml)
* Additional fixes
* Update docs/IE_DG/InferenceEngine_QueryAPI.md
Co-authored-by: Helena Kloosterman <helena.kloosterman@intel.com>
* Update docs/IE_DG/Int8Inference.md
Co-authored-by: Helena Kloosterman <helena.kloosterman@intel.com>
* Update Custom_Layers_Guide.md
* Changes according to review comments
* doc scripts fixes
* Update docs/IE_DG/Int8Inference.md
Co-authored-by: Helena Kloosterman <helena.kloosterman@intel.com>
* Update Int8Inference.md
* update xfail
* clang format
* updated xfail
Co-authored-by: Trawinski, Dariusz <dariusz.trawinski@intel.com>
Co-authored-by: Nikolay Tyukaev <nikolay.tyukaev@intel.com>
Co-authored-by: kblaszczak-intel <karol.blaszczak@intel.com>
Co-authored-by: Yury Gorbachev <yury.gorbachev@intel.com>
Co-authored-by: Helena Kloosterman <helena.kloosterman@intel.com>
This commit is contained in:
2
docs/scripts/tests/utils/__init__.py
Normal file
2
docs/scripts/tests/utils/__init__.py
Normal file
@@ -0,0 +1,2 @@
|
||||
# Copyright (C) 2018-2021 Intel Corporation
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
55
docs/scripts/tests/utils/layout.py
Normal file
55
docs/scripts/tests/utils/layout.py
Normal file
@@ -0,0 +1,55 @@
|
||||
# Copyright (C) 2018-2021 Intel Corporation
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
"""
|
||||
DoxygenLayout.xml parsing routines
|
||||
"""
|
||||
|
||||
from collections import defaultdict
|
||||
import argparse
|
||||
from lxml import etree
|
||||
import re
|
||||
|
||||
|
||||
def parse_arguments():
|
||||
"""
|
||||
Parse arguments
|
||||
"""
|
||||
parser = argparse.ArgumentParser()
|
||||
parser.add_argument('--layout', type=str, required=True, default=None, help='Path to DoxygenLayout.xml file')
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
def format_input(root):
|
||||
"""
|
||||
Format input
|
||||
"""
|
||||
for elem in root.getiterator():
|
||||
if not hasattr(elem.tag, 'find'):
|
||||
continue
|
||||
elem.tag = re.sub(r'{.+}(.+)', r'\1', elem.tag)
|
||||
|
||||
|
||||
def parse_layout(content):
|
||||
"""
|
||||
Parse DoxygenLayout.xml
|
||||
"""
|
||||
parser = etree.XMLParser(encoding='utf-8')
|
||||
root = etree.fromstring(content, parser=parser)
|
||||
format_input(root)
|
||||
files = defaultdict(lambda: set())
|
||||
md_links = filter(
|
||||
lambda x: 'url' in x.attrib and x.attrib['url'].startswith('./') and x.attrib['url'].endswith('.md'),
|
||||
root.xpath('//tab'))
|
||||
for md_link in map(lambda x: x.attrib['url'], md_links):
|
||||
link = md_link[2:] if md_link.startswith('./') else md_link
|
||||
files[link] = set()
|
||||
files[link].update(["The link to this file located in DoxygenLayout.xml is not converted to a doxygen reference ('@ref filename')"])
|
||||
return files
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
arguments = parse_arguments()
|
||||
with open(arguments.layout, 'r', encoding="utf-8") as f:
|
||||
content = f.read()
|
||||
parse_layout(content)
|
||||
110
docs/scripts/tests/utils/log.py
Normal file
110
docs/scripts/tests/utils/log.py
Normal file
@@ -0,0 +1,110 @@
|
||||
# Copyright (C) 2018-2021 Intel Corporation
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
""" Doxygen log parsing routines
|
||||
"""
|
||||
from collections import defaultdict
|
||||
import argparse
|
||||
import re
|
||||
|
||||
|
||||
def parse_arguments():
|
||||
parser = argparse.ArgumentParser()
|
||||
parser.add_argument('--doxygen', type=str, required=True, default=None, help='Path to doxygen.log file')
|
||||
parser.add_argument('--doxygen-strip', type=str, required=False, default='tmp_docs/', help='Path to doxygen.log file')
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
def strip_timestmp(text):
|
||||
"""Strip jenkins timestamp
|
||||
"""
|
||||
return text.split(']')[-1]
|
||||
|
||||
|
||||
def strip_path(path, strip):
|
||||
"""Strip `path` components ends on `strip`
|
||||
"""
|
||||
strip = strip.replace('\\', '/')
|
||||
if not strip.endswith('/'):
|
||||
strip = strip + '/'
|
||||
new_path = path.split(strip)[-1]
|
||||
if new_path.startswith('build/docs/'):
|
||||
new_path = new_path.split('build/docs/')[-1]
|
||||
return new_path
|
||||
|
||||
|
||||
def _get_file_line(text):
|
||||
"""Extracts file and line from Doxygen warning line
|
||||
"""
|
||||
if text:
|
||||
location = text.split()[-1]
|
||||
file_line = location.rsplit(':', 1)
|
||||
if len(file_line) == 2:
|
||||
return file_line
|
||||
return '', ''
|
||||
|
||||
|
||||
def parse(log, strip):
|
||||
"""Extracts {file: errors} from doxygen log
|
||||
"""
|
||||
log = log.splitlines()
|
||||
files = defaultdict(lambda: set()) # pylint: disable=unnecessary-lambda
|
||||
idx = 0
|
||||
prev_file = ''
|
||||
prev_line = ''
|
||||
while idx < len(log): # pylint: disable=too-many-nested-blocks
|
||||
try:
|
||||
log_line = strip_timestmp(log[idx]).strip()
|
||||
processing_verb = next(
|
||||
filter(log_line.startswith,
|
||||
('Reading /', 'Parsing file /', 'Preprocessing /')),
|
||||
None)
|
||||
if processing_verb:
|
||||
files[strip_path(log_line[len(processing_verb) - 1:-3],
|
||||
strip)] = set()
|
||||
elif 'warning:' in log_line:
|
||||
warning = list(map(str.strip, log_line.split(': warning:')))
|
||||
file, line = _get_file_line(warning[0])
|
||||
file = strip_path(file, strip)
|
||||
if len(warning) == 1:
|
||||
file = prev_file
|
||||
line = prev_line
|
||||
error = warning[0]
|
||||
else:
|
||||
error = warning[1]
|
||||
if error.endswith(':'):
|
||||
continuation = []
|
||||
while idx + 1 < len(log):
|
||||
peek = strip_timestmp(log[idx + 1])
|
||||
if not peek.startswith(' '):
|
||||
break
|
||||
continuation += [peek]
|
||||
idx += 1
|
||||
error += ';'.join(continuation)
|
||||
if line:
|
||||
error = '{error} (line: {line})'.format(
|
||||
line=line, error=error)
|
||||
if not file or 'deprecated' in file:
|
||||
files['doxygen_errors'].update([error])
|
||||
else:
|
||||
prev_file = file
|
||||
prev_line = line
|
||||
files[file].update([error])
|
||||
elif log_line.startswith('explicit link request') and 'in layout file' in log_line:
|
||||
match = re.search(r"\'(.+?)\'", log_line)
|
||||
if match:
|
||||
file = match.group(1)
|
||||
files[file].update([log_line])
|
||||
else:
|
||||
files['doxygen_errors'].update([log_line])
|
||||
idx += 1
|
||||
except:
|
||||
print('Parsing error at line {}\n\n{}\n'.format(idx, log[idx]))
|
||||
raise
|
||||
return files
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
arguments = parse_arguments()
|
||||
with open(arguments.doxygen, 'r') as log:
|
||||
files = parse(log.read(), arguments.doxygen_strip)
|
||||
Reference in New Issue
Block a user