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

"""
    sphinx.util.docstrings
    ~~~~~~~~~~~~~~~~~~~~~~

Utilities for docstring processing.

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

import re
import sys
import warnings
from typing import Dict, List, Tuple

from docutils.parsers.rst.states import Body

from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning

field_list_item_re = re.compile(Body.patterns['field_marker'])

def separate_metadata(s: str) -> Tuple[str, Dict[str, str]]:
    """Separate docstring into metadata and others."""
    in_other_element = False
    metadata: Dict[str, str] = {}
    lines = []

if not s:
        return s, metadata

for line in prepare_docstring(s):
        if line.strip() == '':
            in_other_element = False
            lines.append(line)
        else:
            matched = field_list_item_re.match(line)
            if matched and not in_other_element:
                field_name = matched.group()[1:].split(':', 1)[0]
                if field_name.startswith('meta '):
                    name = field_name[5:].strip()
                    metadata[name] = line[matched.end():].strip()
                else:
                    lines.append(line)
            else:
                in_other_element = True
                lines.append(line)

return '\n'.join(lines), metadata

def extract_metadata(s: str) -> Dict[str, str]:
    warnings.warn("extract_metadata() is deprecated.",
                  RemovedInSphinx60Warning, stacklevel=2)

docstring, metadata = separate_metadata(s)
    return metadata

def prepare_docstring(s: str, ignore: int = None, tabsize: int = 8) -> List[str]:
    """Convert a docstring into lines of parseable reST.  Remove common leading
    indentation, where the indentation of a given number of lines (usually just
    one) is ignored.

Return the docstring as a list of lines usable for inserting into a docutils
    ViewList (used as argument of nested_parse().)  An empty line is added to
    act as a separator between this docstring and following content.
    """
    if ignore is None:
        ignore = 1
    else:
        warnings.warn("The 'ignore' argument to prepare_docstring() is deprecated.",
                      RemovedInSphinx50Warning, stacklevel=2)

lines = s.expandtabs(tabsize).splitlines()
    # Find minimum indentation of any non-blank lines after ignored lines.
    margin = sys.maxsize
    for line in lines[ignore:]:
        content = len(line.lstrip())
        if content:
            indent = len(line) - content
            margin = min(margin, indent)
    # Remove indentation from ignored lines.
    for i in range(ignore):
        if i < len(lines):
            lines[i] = lines[i].lstrip()
    if margin < sys.maxsize:
        for i in range(ignore, len(lines)):
            lines[i] = lines[i][margin:]
    # Remove any leading blank lines.
    while lines and not lines[0]:
        lines.pop(0)
    # make sure there is an empty line at the end
    if lines and lines[-1]:
        lines.append('')
    return lines

def prepare_commentdoc(s: str) -> List[str]:
    """Extract documentation comment lines (starting with #:) and return them
    as a list of lines.  Returns an empty list if there is no documentation.
    """
    result = []
    lines = [line.strip() for line in s.expandtabs().splitlines()]
    for line in lines:
        if line.startswith('#:'):
            line = line[2:]
            # the first space after the comment is ignored
            if line and line[0] == ' ':
                line = line[1:]
            result.append(line)
    if result and result[-1]:
        result.append('')
    return result

${this.title}

Code Editor : docstrings.py