sphinx_full_release.py

#!/usr/bin/env python3
 

 
"""
Create sphinx documentation for a full release and make sure that there are no warnings.
However, a few warnings can not easily be omitted and are therefore accepted for now.
"""
 
import os
import re
from b2test_utils import check_error_free, skip_test_if_light
 
 
if __name__ == "__main__":
 
    skip_test_if_light()
 
    
    ignorebackward = '_BACKWARD_BACKWARD_WARNING_H'
 
    sphinx_output_dir = os.getenv("BELLE2_SPHINX_OUTPUTDIR")
    check_error_free(
        "b2code-sphinx-warnings", "sphinx", None,
        lambda x:
        re.findall(ignorebackward, x),
        ["-o", sphinx_output_dir] if sphinx_output_dir else []
    )