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 : events.py

"""
    sphinx.events
    ~~~~~~~~~~~~~

Sphinx core events.

Gracefully adapted from the TextPress system by Armin.

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

from collections import defaultdict
from operator import attrgetter
from typing import TYPE_CHECKING, Any, Callable, Dict, List, NamedTuple, Tuple, Type

from sphinx.errors import ExtensionError, SphinxError
from sphinx.locale import __
from sphinx.util import logging
from sphinx.util.inspect import safe_getattr

if TYPE_CHECKING:
    from sphinx.application import Sphinx

logger = logging.getLogger(__name__)

class EventListener(NamedTuple):
    id: int
    handler: Callable
    priority: int

# List of all known core events. Maps name to arguments description.
core_events = {
    'builder-inited': '',
    'config-inited': 'config',
    'env-get-outdated': 'env, added, changed, removed',
    'env-get-updated': 'env',
    'env-purge-doc': 'env, docname',
    'env-before-read-docs': 'env, docnames',
    'env-check-consistency': 'env',
    'source-read': 'docname, source text',
    'doctree-read': 'the doctree before being pickled',
    'env-merge-info': 'env, read docnames, other env instance',
    'missing-reference': 'env, node, contnode',
    'warn-missing-reference': 'domain, node',
    'doctree-resolved': 'doctree, docname',
    'env-updated': 'env',
    'build-finished': 'exception',
}

class EventManager:
    """Event manager for Sphinx."""

def __init__(self, app: "Sphinx") -> None:
        self.app = app
        self.events = core_events.copy()
        self.listeners: Dict[str, List[EventListener]] = defaultdict(list)
        self.next_listener_id = 0

def add(self, name: str) -> None:
        """Register a custom Sphinx event."""
        if name in self.events:
            raise ExtensionError(__('Event %r already present') % name)
        self.events[name] = ''

def connect(self, name: str, callback: Callable, priority: int) -> int:
        """Connect a handler to specific event."""
        if name not in self.events:
            raise ExtensionError(__('Unknown event name: %s') % name)

listener_id = self.next_listener_id
        self.next_listener_id += 1
        self.listeners[name].append(EventListener(listener_id, callback, priority))
        return listener_id

def disconnect(self, listener_id: int) -> None:
        """Disconnect a handler."""
        for listeners in self.listeners.values():
            for listener in listeners[:]:
                if listener.id == listener_id:
                    listeners.remove(listener)

def emit(self, name: str, *args: Any,
             allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> List:
        """Emit a Sphinx event."""
        try:
            logger.debug('[app] emitting event: %r%s', name, repr(args)[:100])
        except Exception:
            # not every object likes to be repr()'d (think
            # random stuff coming via autodoc)
            pass

results = []
        listeners = sorted(self.listeners[name], key=attrgetter("priority"))
        for listener in listeners:
            try:
                results.append(listener.handler(self.app, *args))
            except allowed_exceptions:
                # pass through the errors specified as *allowed_exceptions*
                raise
            except SphinxError:
                raise
            except Exception as exc:
                modname = safe_getattr(listener.handler, '__module__', None)
                raise ExtensionError(__("Handler %r for event %r threw an exception") %
                                     (listener.handler, name), exc, modname=modname) from exc
        return results

def emit_firstresult(self, name: str, *args: Any,
                         allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> Any:
        """Emit a Sphinx event and returns first result.

This returns the result of the first handler that doesn't return ``None``.
        """
        for result in self.emit(name, *args, allowed_exceptions=allowed_exceptions):
            if result is not None:
                return result
        return None

${this.title}

Code Editor : events.py