# Copyright 2008-2015 Nokia Networks
# Copyright 2016- Robot Framework Foundation
#
# 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 os
from robot.errors import DataError
from robot.parsing import TEST_EXTENSIONS
from robot.utils import JYTHON, JAVA_VERSION
from .robotbuilder import LibraryDocBuilder, ResourceDocBuilder
from .specbuilder import SpecDocBuilder
if JYTHON:
if JAVA_VERSION < (1, 9):
from .javabuilder import JavaDocBuilder
else:
from .java9builder import JavaDocBuilder
else:
[docs] def JavaDocBuilder():
raise DataError('Documenting Java test libraries requires Jython.')
RESOURCE_EXTENSIONS = (TEST_EXTENSIONS | {'resource'})
[docs]def DocumentationBuilder(library_or_resource):
extension = os.path.splitext(library_or_resource)[1][1:].lower()
if extension in RESOURCE_EXTENSIONS:
return ResourceDocBuilder()
if extension == 'xml':
return SpecDocBuilder()
if extension == 'java':
return JavaDocBuilder()
return LibraryDocBuilder()