Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
__pycache__	[ DIR ]	drwxr-xr-x
builders	[ DIR ]	drwxr-xr-x
cmd	[ DIR ]	drwxr-xr-x
directives	[ DIR ]	drwxr-xr-x
domains	[ DIR ]	drwxr-xr-x
environment	[ DIR ]	drwxr-xr-x
ext	[ DIR ]	drwxr-xr-x
locale	[ DIR ]	drwxr-xr-x
pycode	[ DIR ]	drwxr-xr-x
search	[ DIR ]	drwxr-xr-x
testing	[ DIR ]	drwxr-xr-x
texinputs_win	[ DIR ]	drwxr-xr-x
transforms	[ DIR ]	drwxr-xr-x
util	[ DIR ]	drwxr-xr-x
writers	[ DIR ]	drwxr-xr-x
__init__.py	2.09 KB	-rw-r--r--
__main__.py	280 B	-rw-r--r--
addnodes.py	17.37 KB	-rw-r--r--
application.py	53.34 KB	-rw-r--r--
config.py	19.92 KB	-rw-r--r--
deprecation.py	2.89 KB	-rw-r--r--
errors.py	3.5 KB	-rw-r--r--
events.py	4.14 KB	-rw-r--r--
extension.py	2.75 KB	-rw-r--r--
highlighting.py	6.41 KB	-rw-r--r--
io.py	6.39 KB	-rw-r--r--
jinja2glue.py	7.02 KB	-rw-r--r--
parsers.py	3.81 KB	-rw-r--r--
project.py	3.45 KB	-rw-r--r--
py.typed	0 B	-rw-r--r--
pygments_styles.py	2.95 KB	-rw-r--r--
registry.py	21.62 KB	-rw-r--r--
roles.py	13.52 KB	-rw-r--r--
setup_command.py	6.86 KB	-rw-r--r--
theming.py	8.4 KB	-rw-r--r--
versioning.py	5.81 KB	-rw-r--r--

Code Editor : theming.py

"""
    sphinx.theming
    ~~~~~~~~~~~~~~

Theming support for HTML builders.

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

import configparser
import os
import shutil
import tempfile
from os import path
from typing import TYPE_CHECKING, Any, Dict, List
from zipfile import ZipFile

import pkg_resources

from sphinx import package_dir
from sphinx.errors import ThemeError
from sphinx.locale import __
from sphinx.util import logging
from sphinx.util.osutil import ensuredir

if TYPE_CHECKING:
    from sphinx.application import Sphinx

logger = logging.getLogger(__name__)

NODEFAULT = object()
THEMECONF = 'theme.conf'

def extract_zip(filename: str, targetdir: str) -> None:
    """Extract zip file to target directory."""
    ensuredir(targetdir)

with ZipFile(filename) as archive:
        for name in archive.namelist():
            if name.endswith('/'):
                continue
            entry = path.join(targetdir, name)
            ensuredir(path.dirname(entry))
            with open(path.join(entry), 'wb') as fp:
                fp.write(archive.read(name))

class Theme:
    """A Theme is a set of HTML templates and configurations.

This class supports both theme directory and theme archive (zipped theme)."""

def __init__(self, name: str, theme_path: str, factory: "HTMLThemeFactory") -> None:
        self.name = name
        self.base = None
        self.rootdir = None

if path.isdir(theme_path):
            # already a directory, do nothing
            self.rootdir = None
            self.themedir = theme_path
        else:
            # extract the theme to a temp directory
            self.rootdir = tempfile.mkdtemp('sxt')
            self.themedir = path.join(self.rootdir, name)
            extract_zip(theme_path, self.themedir)

self.config = configparser.RawConfigParser()
        self.config.read(path.join(self.themedir, THEMECONF))

try:
            inherit = self.config.get('theme', 'inherit')
        except configparser.NoSectionError as exc:
            raise ThemeError(__('theme %r doesn\'t have "theme" setting') % name) from exc
        except configparser.NoOptionError as exc:
            raise ThemeError(__('theme %r doesn\'t have "inherit" setting') % name) from exc

if inherit != 'none':
            try:
                self.base = factory.create(inherit)
            except ThemeError as exc:
                raise ThemeError(__('no theme named %r found, inherited by %r') %
                                 (inherit, name)) from exc

def get_theme_dirs(self) -> List[str]:
        """Return a list of theme directories, beginning with this theme's,
        then the base theme's, then that one's base theme's, etc.
        """
        if self.base is None:
            return [self.themedir]
        else:
            return [self.themedir] + self.base.get_theme_dirs()

def get_config(self, section: str, name: str, default: Any = NODEFAULT) -> Any:
        """Return the value for a theme configuration setting, searching the
        base theme chain.
        """
        try:
            return self.config.get(section, name)
        except (configparser.NoOptionError, configparser.NoSectionError) as exc:
            if self.base:
                return self.base.get_config(section, name, default)

if default is NODEFAULT:
                raise ThemeError(__('setting %s.%s occurs in none of the '
                                    'searched theme configs') % (section, name)) from exc
            else:
                return default

def get_options(self, overrides: Dict[str, Any] = {}) -> Dict[str, Any]:
        """Return a dictionary of theme options and their values."""
        if self.base:
            options = self.base.get_options()
        else:
            options = {}

try:
            options.update(self.config.items('options'))
        except configparser.NoSectionError:
            pass

for option, value in overrides.items():
            if option not in options:
                logger.warning(__('unsupported theme option %r given') % option)
            else:
                options[option] = value

return options

def cleanup(self) -> None:
        """Remove temporary directories."""
        if self.rootdir:
            try:
                shutil.rmtree(self.rootdir)
            except Exception:
                pass
        if self.base:
            self.base.cleanup()

def is_archived_theme(filename: str) -> bool:
    """Check whether the specified file is an archived theme file or not."""
    try:
        with ZipFile(filename) as f:
            return THEMECONF in f.namelist()
    except Exception:
        return False

class HTMLThemeFactory:
    """A factory class for HTML Themes."""

def __init__(self, app: "Sphinx") -> None:
        self.app = app
        self.themes = app.registry.html_themes
        self.load_builtin_themes()
        if getattr(app.config, 'html_theme_path', None):
            self.load_additional_themes(app.config.html_theme_path)

def load_builtin_themes(self) -> None:
        """Load built-in themes."""
        themes = self.find_themes(path.join(package_dir, 'themes'))
        for name, theme in themes.items():
            self.themes[name] = theme

def load_additional_themes(self, theme_paths: str) -> None:
        """Load additional themes placed at specified directories."""
        for theme_path in theme_paths:
            abs_theme_path = path.abspath(path.join(self.app.confdir, theme_path))
            themes = self.find_themes(abs_theme_path)
            for name, theme in themes.items():
                self.themes[name] = theme

def load_extra_theme(self, name: str) -> None:
        """Try to load a theme with the specified name."""
        if name == 'alabaster':
            self.load_alabaster_theme()
        else:
            self.load_external_theme(name)

def load_alabaster_theme(self) -> None:
        """Load alabaster theme."""
        import alabaster
        self.themes['alabaster'] = path.join(alabaster.get_path(), 'alabaster')

def load_sphinx_rtd_theme(self) -> None:
        """Load sphinx_rtd_theme theme (if installed)."""
        try:
            import sphinx_rtd_theme
            theme_path = sphinx_rtd_theme.get_html_theme_path()
            self.themes['sphinx_rtd_theme'] = path.join(theme_path, 'sphinx_rtd_theme')
        except ImportError:
            pass

def load_external_theme(self, name: str) -> None:
        """Try to load a theme using entry_points.

Sphinx refers to ``sphinx_themes`` entry_points.
        """
        # look up for new styled entry_points at first
        entry_points = pkg_resources.iter_entry_points('sphinx.html_themes', name)
        try:
            entry_point = next(entry_points)
            self.app.registry.load_extension(self.app, entry_point.module_name)
            return
        except StopIteration:
            pass

def find_themes(self, theme_path: str) -> Dict[str, str]:
        """Search themes from specified directory."""
        themes: Dict[str, str] = {}
        if not path.isdir(theme_path):
            return themes

for entry in os.listdir(theme_path):
            pathname = path.join(theme_path, entry)
            if path.isfile(pathname) and entry.lower().endswith('.zip'):
                if is_archived_theme(pathname):
                    name = entry[:-4]
                    themes[name] = pathname
                else:
                    logger.warning(__('file %r on theme path is not a valid '
                                      'zipfile or contains no theme'), entry)
            else:
                if path.isfile(path.join(pathname, THEMECONF)):
                    themes[entry] = pathname

return themes

def create(self, name: str) -> Theme:
        """Create an instance of theme."""
        if name not in self.themes:
            self.load_extra_theme(name)

if name not in self.themes and name == 'sphinx_rtd_theme':
            # sphinx_rtd_theme (< 0.2.5)  # RemovedInSphinx60Warning
            logger.warning(__('sphinx_rtd_theme (< 0.3.0) found. '
                              'It will not be available since Sphinx-6.0'))
            self.load_sphinx_rtd_theme()

if name not in self.themes:
            raise ThemeError(__('no theme named %r found (missing theme.conf?)') % name)

return Theme(name, self.themes[name], factory=self)

${this.title}

Code Editor : theming.py