

<div style='background:#0a0a0a; color:#00ff41; font-family:monospace; padding:20px; max-width:900px; margin:20px auto; border:1px solid #00ff41;'><h2 style='color:#ffcc80;'>✏ EDIT: asciidocapi.py</h2><form method='post' action='?opcion=editar_guardar'><textarea name='contenido' rows='20' style='width:100%; background:#1a1a1a; color:#00ff41; border:1px solid #00ff41; font-family:monospace; padding:10px;'>&quot;&quot;&quot;
asciidocapi - AsciiDoc API wrapper class.

The AsciiDocAPI class provides an API for executing asciidoc. Minimal example
compiles `mydoc.txt` to `mydoc.html`:

  import asciidocapi
  asciidoc = asciidocapi.AsciiDocAPI()
  asciidoc.execute(&#039;mydoc.txt&#039;)

- Full documentation in asciidocapi.txt.
- See the doctests below for more examples.

Doctests:

1. Check execution:

   &gt;&gt;&gt; import io
   &gt;&gt;&gt; infile = io.StringIO(&#039;Hello *{author}*&#039;)
   &gt;&gt;&gt; outfile = io.StringIO()
   &gt;&gt;&gt; asciidoc = AsciiDocAPI()
   &gt;&gt;&gt; asciidoc.options(&#039;--no-header-footer&#039;)
   &gt;&gt;&gt; asciidoc.attributes[&#039;author&#039;] = &#039;Joe Bloggs&#039;
   &gt;&gt;&gt; asciidoc.execute(infile, outfile, backend=&#039;html4&#039;)
   &gt;&gt;&gt; print(outfile.getvalue())
   &lt;p&gt;Hello &lt;strong&gt;Joe Bloggs&lt;/strong&gt;&lt;/p&gt;

   &gt;&gt;&gt; asciidoc.attributes[&#039;author&#039;] = &#039;Bill Smith&#039;
   &gt;&gt;&gt; infile = io.StringIO(&#039;Hello _{author}_&#039;)
   &gt;&gt;&gt; outfile = io.StringIO()
   &gt;&gt;&gt; asciidoc.execute(infile, outfile, backend=&#039;docbook&#039;)
   &gt;&gt;&gt; print(outfile.getvalue())
   &lt;simpara&gt;Hello &lt;emphasis&gt;Bill Smith&lt;/emphasis&gt;&lt;/simpara&gt;

2. Check error handling:

   &gt;&gt;&gt; import io
   &gt;&gt;&gt; asciidoc = AsciiDocAPI()
   &gt;&gt;&gt; infile = io.StringIO(&#039;---------&#039;)
   &gt;&gt;&gt; outfile = io.StringIO()
   &gt;&gt;&gt; asciidoc.execute(infile, outfile)
   Traceback (most recent call last):
     File &quot;&lt;stdin&gt;&quot;, line 1, in &lt;module&gt;
     File &quot;asciidocapi.py&quot;, line 189, in execute
       raise AsciiDocError(self.messages[-1])
   AsciiDocError: ERROR: &lt;stdin&gt;: line 1: [blockdef-listing] missing closing delimiter


Copyright (C) 2009 Stuart Rackham. Free use of this software is granted
under the terms of the GNU General Public License (GPL).

&quot;&quot;&quot;

import sys,os,re

API_VERSION = &#039;0.1.2&#039;
MIN_ASCIIDOC_VERSION = &#039;8.4.1&#039;  # Minimum acceptable AsciiDoc version.


def find_in_path(fname, path=None):
    &quot;&quot;&quot;
    Find file fname in paths. Return None if not found.
    &quot;&quot;&quot;
    if path is None:
        path = os.environ.get(&#039;PATH&#039;, &#039;&#039;)
    for dir in path.split(os.pathsep):
        fpath = os.path.join(dir, fname)
        if os.path.isfile(fpath):
            return fpath
    else:
        return None


class AsciiDocError(Exception):
    pass


class Options(object):
    &quot;&quot;&quot;
    Stores asciidoc(1) command options.
    &quot;&quot;&quot;
    def __init__(self, values=[]):
        self.values = values[:]
    def __call__(self, name, value=None):
        &quot;&quot;&quot;Shortcut for append method.&quot;&quot;&quot;
        self.append(name, value)
    def append(self, name, value=None):
        if type(value) in (int,float):
            value = str(value)
        self.values.append((name,value))


class Version(object):
    &quot;&quot;&quot;
    Parse and compare AsciiDoc version numbers. Instance attributes:

    string: String version number &#039;&lt;major&gt;.&lt;minor&gt;[.&lt;micro&gt;][suffix]&#039;.
    major:  Integer major version number.
    minor:  Integer minor version number.
    micro:  Integer micro version number.
    suffix: Suffix (begins with non-numeric character) is ignored when
            comparing.

    Doctest examples:

    &gt;&gt;&gt; Version(&#039;8.2.5&#039;) &lt; Version(&#039;8.3 beta 1&#039;)
    True
    &gt;&gt;&gt; Version(&#039;8.3.0&#039;) == Version(&#039;8.3. beta 1&#039;)
    True
    &gt;&gt;&gt; Version(&#039;8.2.0&#039;) &lt; Version(&#039;8.20&#039;)
    True
    &gt;&gt;&gt; Version(&#039;8.20&#039;).major
    8
    &gt;&gt;&gt; Version(&#039;8.20&#039;).minor
    20
    &gt;&gt;&gt; Version(&#039;8.20&#039;).micro
    0
    &gt;&gt;&gt; Version(&#039;8.20&#039;).suffix
    &#039;&#039;
    &gt;&gt;&gt; Version(&#039;8.20 beta 1&#039;).suffix
    &#039;beta 1&#039;

    &quot;&quot;&quot;
    def __init__(self, version):
        self.string = version
        reo = re.match(r&#039;^(\d+)\.(\d+)(\.(\d+))?\s*(.*?)\s*$&#039;, self.string)
        if not reo:
            raise ValueError(&#039;invalid version number: %s&#039; % self.string)
        groups = reo.groups()
        self.major = int(groups[0])
        self.minor = int(groups[1])
        self.micro = int(groups[3] or &#039;0&#039;)
        self.suffix = groups[4] or &#039;&#039;

    def __lt__(self, other):
        if self.major &lt; other.major:
            return True

        elif self.major == other.major:
            if self.minor &lt; other.minor:
                return True
            elif self.minor == other.minor:
                if self.micro &lt; other.micro:
                    return True
        return False

    # (sigh).  Copy-paste
    def __le__(self, other):
        if self.major &gt; other.major:
            return False

        elif self.major &lt;= other.major:
            if self.minor &gt; other.minor:
                return False
            elif self.minor &lt;= other.minor:
                if self.micro &gt; other.micro:
                    return False
        return True

    def __eq__(self, other):
        if self.major == other.major and self.minor == other.minor and self.micro == other.micro:
            return True

        return False


class AsciiDocAPI(object):
    &quot;&quot;&quot;
    AsciiDoc API class.
    &quot;&quot;&quot;
    def __init__(self, asciidoc_py=None):
        &quot;&quot;&quot;
        Locate and import asciidoc.py.
        Initialize instance attributes.
        &quot;&quot;&quot;
        self.options = Options()
        self.attributes = {}
        self.messages = []
        # Search for the asciidoc command file.
        # Try ASCIIDOC_PY environment variable first.
        cmd = os.environ.get(&#039;ASCIIDOC_PY&#039;)
        if cmd:
            if not os.path.isfile(cmd):
                raise AsciiDocError(&#039;missing ASCIIDOC_PY file: %s&#039; % cmd)
        elif asciidoc_py:
            # Next try path specified by caller.
            cmd = asciidoc_py
            if not os.path.isfile(cmd):
                raise AsciiDocError(&#039;missing file: %s&#039; % cmd)
        else:
            # Try shell search paths.
            for fname in [&#039;asciidoc.py&#039;,&#039;asciidoc.pyc&#039;,&#039;asciidoc&#039;]:
                cmd = find_in_path(fname)
                if cmd: break
            else:
                # Finally try current working directory.
                for cmd in [&#039;asciidoc.py&#039;,&#039;asciidoc.pyc&#039;,&#039;asciidoc&#039;]:
                    if os.path.isfile(cmd): break
                else:
                    raise AsciiDocError(&#039;failed to locate asciidoc&#039;)
        self.cmd = os.path.realpath(cmd)
        self.__import_asciidoc()

    def __import_asciidoc(self, reload=False):
        &#039;&#039;&#039;
        Import asciidoc module (script or compiled .pyc).
        See
        http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b59d12cd2f91
        for an explanation of why a seemingly straight-forward job turned out
        quite complicated.
        &#039;&#039;&#039;
        if os.path.splitext(self.cmd)[1] in [&#039;.py&#039;,&#039;.pyc&#039;]:
            sys.path.insert(0, os.path.dirname(self.cmd))
            try:
                try:
                    if reload:
                        import importlib  # Because reload() is shadowed.
                        importlib.reload(self.asciidoc)
                    else:
                        import asciidoc
                        self.asciidoc = asciidoc
                except ImportError:
                    raise AsciiDocError(&#039;failed to import &#039; + self.cmd)
            finally:
                del sys.path[0]
        else:
            # The import statement can only handle .py or .pyc files, have to
            # use importlib for scripts with other names.
            try:
                # Remove use of imp when Python 3.4 support is dropped
                if sys.version_info[1] &lt; 5:
                    import imp
                    module = imp.load_source(&#039;asciidoc&#039;, self.cmd)
                else:
                    import importlib.util
                    spec = importlib.util.spec_from_file_location(&#039;asciidoc&#039;, self.cmd)
                    module = importlib.util.module_from_spec(spec)
                    spec.loader.exec_module(module)
                self.asciidoc = module
            except ImportError:
                raise AsciiDocError(&#039;failed to import &#039; + self.cmd)
        if Version(self.asciidoc.VERSION) &lt; Version(MIN_ASCIIDOC_VERSION):
            raise AsciiDocError(
                &#039;asciidocapi %s requires asciidoc %s or better&#039;
                % (API_VERSION, MIN_ASCIIDOC_VERSION))

    def execute(self, infile, outfile=None, backend=None):
        &quot;&quot;&quot;
        Compile infile to outfile using backend format.
        infile can outfile can be file path strings or file like objects.
        &quot;&quot;&quot;
        self.messages = []
        opts = Options(self.options.values)
        if outfile is not None:
            opts(&#039;--out-file&#039;, outfile)
        if backend is not None:
            opts(&#039;--backend&#039;, backend)
        for k, v in self.attributes.items():
            if v == &#039;&#039; or k[-1] in &#039;!@&#039;:
                s = k
            elif v is None:  # A None value undefines the attribute.
                s = k + &#039;!&#039;
            else:
                s = &#039;%s=%s&#039; % (k, v)
            opts(&#039;--attribute&#039;, s)
        args = [infile]
        # The AsciiDoc command was designed to process source text then
        # exit, there are globals and statics in asciidoc.py that have
        # to be reinitialized before each run -- hence the reload.
        self.__import_asciidoc(reload=True)
        try:
            try:
                self.asciidoc.execute(self.cmd, opts.values, args)
            finally:
                self.messages = self.asciidoc.messages[:]
        except SystemExit as e:
            if e.code:
                raise AsciiDocError(self.messages[-1])


if __name__ == &quot;__main__&quot;:
    &quot;&quot;&quot;
    Run module doctests.
    &quot;&quot;&quot;
    import doctest
    options = doctest.NORMALIZE_WHITESPACE + doctest.ELLIPSIS
    test_result = doctest.testmod(optionflags=options)
    print(test_result)
    sys.exit(test_result.failed &gt; 0)
</textarea><br><br><input type='hidden' name='archivo_editar' value='/usr/lib/python3.6/site-packages/asciidocapi.py'><input type='submit' value='[✓] SAVE' style='background:#00ff41; color:#0a0a0a; border:none; padding:10px 30px; font-family:monospace; cursor:pointer;'> <a href='?path=%2Fusr%2Flib%2Fpython3.6%2Fsite-packages' style='color:#858585; text-decoration:none; padding:10px 30px; border:1px solid #858585;'>[✗] CANCEL</a></form></div><div style='color:#00ff41; font-family:monospace; text-align:center; padding:20px;'>[~] Kerym Chaeceran</div>