Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
__pycache__	[ DIR ]	drwxr-xr-x
stemmer	[ DIR ]	drwxr-xr-x
__init__.py	19.24 KB	-rw-r--r--
build_phase.py	417 B	-rw-r--r--
cfamily.py	13.96 KB	-rw-r--r--
compat.py	1.2 KB	-rw-r--r--
console.py	3.48 KB	-rw-r--r--
docfields.py	16.11 KB	-rw-r--r--
docstrings.py	3.65 KB	-rw-r--r--
docutils.py	18.53 KB	-rw-r--r--
fileutil.py	3.72 KB	-rw-r--r--
i18n.py	9.71 KB	-rw-r--r--
images.py	2.92 KB	-rw-r--r--
inspect.py	31.36 KB	-rw-r--r--
inventory.py	6.28 KB	-rw-r--r--
jsdump.py	5.69 KB	-rw-r--r--
logging.py	17.92 KB	-rw-r--r--
matching.py	3.22 KB	-rw-r--r--
math.py	1.85 KB	-rw-r--r--
nodes.py	22.31 KB	-rw-r--r--
osutil.py	6.79 KB	-rw-r--r--
parallel.py	5.28 KB	-rw-r--r--
png.py	1.56 KB	-rw-r--r--
pycompat.py	2.04 KB	-rw-r--r--
requests.py	4.06 KB	-rw-r--r--
rst.py	3.35 KB	-rw-r--r--
smartypants.py	15.61 KB	-rw-r--r--
tags.py	2.72 KB	-rw-r--r--
template.py	4.65 KB	-rw-r--r--
texescape.py	5.46 KB	-rw-r--r--
typing.py	18.44 KB	-rw-r--r--

Code Editor : fileutil.py

"""
    sphinx.util.fileutil
    ~~~~~~~~~~~~~~~~~~~~

File utility functions for Sphinx.

:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
    :license: BSD, see LICENSE for details.
"""

import os
import posixpath
from typing import TYPE_CHECKING, Callable, Dict

from docutils.utils import relative_path

from sphinx.util.osutil import copyfile, ensuredir
from sphinx.util.typing import PathMatcher

if TYPE_CHECKING:
    from sphinx.util.template import BaseRenderer

def copy_asset_file(source: str, destination: str,
                    context: Dict = None, renderer: "BaseRenderer" = None) -> None:
    """Copy an asset file to destination.

On copying, it expands the template variables if context argument is given and
    the asset is a template file.

:param source: The path to source file
    :param destination: The path to destination file or directory
    :param context: The template variables.  If not given, template files are simply copied
    :param renderer: The template engine.  If not given, SphinxRenderer is used by default
    """
    if not os.path.exists(source):
        return

if os.path.isdir(destination):
        # Use source filename if destination points a directory
        destination = os.path.join(destination, os.path.basename(source))

if source.lower().endswith('_t') and context is not None:
        if renderer is None:
            from sphinx.util.template import SphinxRenderer
            renderer = SphinxRenderer()

with open(source, encoding='utf-8') as fsrc:
            if destination.lower().endswith('_t'):
                destination = destination[:-2]
            with open(destination, 'w', encoding='utf-8') as fdst:
                fdst.write(renderer.render_string(fsrc.read(), context))
    else:
        copyfile(source, destination)

def copy_asset(source: str, destination: str, excluded: PathMatcher = lambda path: False,
               context: Dict = None, renderer: "BaseRenderer" = None,
               onerror: Callable[[str, Exception], None] = None) -> None:
    """Copy asset files to destination recursively.

On copying, it expands the template variables if context argument is given and
    the asset is a template file.

:param source: The path to source file or directory
    :param destination: The path to destination directory
    :param excluded: The matcher to determine the given path should be copied or not
    :param context: The template variables.  If not given, template files are simply copied
    :param renderer: The template engine.  If not given, SphinxRenderer is used by default
    :param onerror: The error handler.
    """
    if not os.path.exists(source):
        return

if renderer is None:
        from sphinx.util.template import SphinxRenderer
        renderer = SphinxRenderer()

ensuredir(destination)
    if os.path.isfile(source):
        copy_asset_file(source, destination, context, renderer)
        return

for root, dirs, files in os.walk(source, followlinks=True):
        reldir = relative_path(source, root)
        for dir in dirs[:]:
            if excluded(posixpath.join(reldir, dir)):
                dirs.remove(dir)
            else:
                ensuredir(posixpath.join(destination, reldir, dir))

for filename in files:
            if not excluded(posixpath.join(reldir, filename)):
                try:
                    copy_asset_file(posixpath.join(root, filename),
                                    posixpath.join(destination, reldir),
                                    context, renderer)
                except Exception as exc:
                    if onerror:
                        onerror(posixpath.join(root, filename), exc)
                    else:
                        raise

${this.title}

Code Editor : fileutil.py