Normal
  /   ˆ{‹„„-i[D<†ªoZƒ›Ù«Ã528_‘I|¥‰ÓMdœv ©ƒ†ü+=ÃÂ     ‹      ÍUÑnÚ0}ïWx~Ø\¥Ó¨ã©#HC£€(Ó4M{0±!V“8²Röõsé¨hÚ‹íÄçžœso®MÞ“þüÛt€>ÍïGhúåãhØG¸ðµÓæAµqÝly ƒ1F8²6ëEÑ,:M¥W0ŸAd“øŒÕ2´Mn9¦W¤|G¯‰ãnFÄJ:L¹xBj‰@åÖH.\ÜÆ@3c@¦Yn«±&_¸+HTn„G bpœ°#%Å7å·¼Wñºð­@¶ØÒ—KM‰�ÐšÅr•úØªS"“2:ô1ÈP¥1K›+¹ÄˆÅÖÇß‡ýÉ‡•Ñ”0i±ôñ‡¾?¾�ø¦c–ì0æÞaî01cQ¢¸\JÁ�‚*ðƒüyœ0¨0�0¡–™•*ÝCÁY¬[Ul2æ¼v�ƒH×Q„ÿ-,|‘ŒéÝl0žÃY•^RìÕ�Q%L§L‹Ô¢@jZ¥7;åÛta²ÛçG´Ó¨å*²˜"Ô@‘gËÓÇTiÝ›ËÛAW\¬1uC]àoŠÚ­öMÃómyÝ^§…Ð ë¹Ï¯•¾T1º®üX=œh
Øª/'8ðÞ#ï]¯usÔÁ%’ºƒLB;Õ|‰
ü[ýõ~¿þ_êpFäbíºÓj¾„�?·Â‰‡ìŽwÛKƒ@uAý)R    C   ˆl–äY>”êhŠe@=q�ÜªbÑ¿�þZŽFVnW€Ù$m¶Û ?ŸÆ„í?Å_ŠI|¥�+Wé3ž¯ÅÄ ?÷     """Creates reST files corresponding to Python modules for code documentation.

Parses a directory tree looking for Python modules and packages and creates
ReST files appropriately to create code documentation with Sphinx.  It also
creates a modules index (named modules.<suffix>).

This is derived from the "sphinx-autopackage" script, which is:
Copyright 2008 SociÃ©tÃ© des arts technologiques (SAT),
https://sat.qc.ca/
"""

import argparse
import glob
import locale
import os
import sys
from copy import copy
from fnmatch import fnmatch
from importlib.machinery import EXTENSION_SUFFIXES
from os import path
from typing import Any, Generator, List, Optional, Tuple

import sphinx.locale
from sphinx import __display_version__, package_dir
from sphinx.cmd.quickstart import EXTENSIONS
from sphinx.locale import __
from sphinx.util.osutil import FileAvoidWrite, ensuredir
from sphinx.util.template import ReSTRenderer

# automodule options
if 'SPHINX_APIDOC_OPTIONS' in os.environ:
    OPTIONS = os.environ['SPHINX_APIDOC_OPTIONS'].split(',')
else:
    OPTIONS = [
        'members',
        'undoc-members',
        # 'inherited-members', # disabled because there's a bug in sphinx
        'show-inheritance',
    ]

PY_SUFFIXES = ('.py', '.pyx') + tuple(EXTENSION_SUFFIXES)

template_dir = path.join(package_dir, 'templates', 'apidoc')


def is_initpy(filename: str) -> bool:
    """Check *filename* is __init__ file or not."""
    basename = path.basename(filename)
    for suffix in sorted(PY_SUFFIXES, key=len, reverse=True):
        if basename == '__init__' + suffix:
            return True
    else:
        return False


def module_join(*modnames: str) -> str:
    """Join module names with dots."""
    return '.'.join(filter(None, modnames))


def is_packagedir(dirname: Optional[str] = None, files: Optional[List[str]] = None) -> bool:
    """Check given *files* contains __init__ file."""
    if files is None and dirname is None:
        return False

    if files is None:
        files = os.listdir(dirname)
    return any(f for f in files if is_initpy(f))


def write_file(name: str, text: str, opts: Any) -> None:
    """Write the output file for module/package <name>."""
    quiet = getattr(opts, 'quiet', None)

    fname = path.join(opts.destdir, '%s.%s' % (name, opts.suffix))
    if opts.dryrun:
        if not quiet:
            print(__('Would create file %s.') % fname)
        return
    if not opts.force and path.isfile(fname):
        if not quiet:
            print(__('File %s already exists, skipping.') % fname)
    else:
        if not quiet:
            print(__('Creating file %s.') % fname)
        with FileAvoidWrite(fname) as f:
            f.write(text)


def create_module_file(package: str, basename: str, opts: Any,
                       user_template_dir: Optional[str] = None) -> None:
    """Build the text of the file and write the file."""
    options = copy(OPTIONS)
    if opts.includeprivate and 'private-members' not in options:
        options.append('private-members')

    qualname = module_join(package, basename)
    context = {
        'show_headings': not opts.noheadings,
        'basename': basename,
        'qualname': qualname,
        'automodule_options': options,
    }
    text = ReSTRenderer([user_template_dir, template_dir]).render('module.rst_t', context)
    write_file(qualname, text, opts)


def create_package_file(root: str, mas