Source code for robot.libdocpkg.output

#  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 datetime
import os
import time

from robot.utils import file_writer


[docs]class LibdocOutput: def __init__(self, output_path, format): self._output_path = output_path self._format = format.upper() self._output_file = None def __enter__(self): if self._format == 'HTML': self._output_file = file_writer(self._output_path, usage='Libdoc output') return self._output_file return self._output_path def __exit__(self, *exc_info): if self._output_file: self._output_file.close() if any(exc_info): try: os.remove(self._output_path) except OSError: pass
[docs]def get_generation_time(): """Return a timestamp that honors `SOURCE_DATE_EPOCH`. This timestamp is to be used for embedding in output files, so that builds can be made reproducible. """ ts = float(os.getenv('SOURCE_DATE_EPOCH', time.time())) dt = datetime.datetime.fromtimestamp(round(ts), datetime.timezone.utc) return dt.isoformat()