findpath.py

from sphinx.util import logging
import os

def Error(msg, location):
    logger = logging.getLogger(__name__)
    logger.error(msg, location=location)

def Assert(flag, msg, location=None):
    if not flag:
        Error(msg, location=location)

def FindPath(relpath, location):
    """
    relpath: path to file relative to repository root
             or relative to predefined locations, see Try(...)
    location: caller location (docname, lineno)
    Returns:
    abspath: absolute path to file
    relpath: update path relative to repository root
    """
    def Try(abspath, *path):
        s = os.path.abspath(os.path.join(*path))
        if os.path.exists(s):
            Assert(not abspath,
                "Ambiguous path: target found in '{:}' and '{:}'".format(
                abspath, s), location)
            return s
        return abspath

    r = relpath
    repo = os.path.abspath(os.path.join(os.getcwd(), "../../"))
    a = "" # absolute path
    a = Try(a, repo, r)
    a = Try(a, repo, "deploy", r)
    a = Try(a, repo, "doc/sphinx/src/log", r)
    a = Try(a, repo, "deploy/lib", r)
    a = Try(a, repo, "deploy/scripts", r)
    a = Try(a, repo, "deploy/scripts_gen", r)
    a = Try(a, repo, "src", r)
    if not a:
        return a, a
    return a, os.path.relpath(a, repo)