Not Found

The requested URL was not found on this server.

Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.

1#@!#!123s

: / lib / python3.6 / site-packages /

Filename : asciidocapi.py

back

"""
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('mydoc.txt')

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

Doctests:

1. Check execution:

   >>> import io
   >>> infile = io.StringIO('Hello *{author}*')
   >>> outfile = io.StringIO()
   >>> asciidoc = AsciiDocAPI()
   >>> asciidoc.options('--no-header-footer')
   >>> asciidoc.attributes['author'] = 'Joe Bloggs'
   >>> asciidoc.execute(infile, outfile, backend='html4')
   >>> print(outfile.getvalue())
   <p>Hello <strong>Joe Bloggs</strong></p>

   >>> asciidoc.attributes['author'] = 'Bill Smith'
   >>> infile = io.StringIO('Hello _{author}_')
   >>> outfile = io.StringIO()
   >>> asciidoc.execute(infile, outfile, backend='docbook')
   >>> print(outfile.getvalue())
   <simpara>Hello <emphasis>Bill Smith</emphasis></simpara>

2. Check error handling:

   >>> import io
   >>> asciidoc = AsciiDocAPI()
   >>> infile = io.StringIO('---------')
   >>> outfile = io.StringIO()
   >>> asciidoc.execute(infile, outfile)
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
     File "asciidocapi.py", line 189, in execute
       raise AsciiDocError(self.messages[-1])
   AsciiDocError: ERROR: <stdin>: 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).

"""

import sys,os,re

API_VERSION = '0.1.2'
MIN_ASCIIDOC_VERSION = '8.4.1'  # Minimum acceptable AsciiDoc version.


def find_in_path(fname, path=None):
    """
    Find file fname in paths. Return None if not found.
    """
    if path is None:
        path = os.environ.get('PATH', '')
    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):
    """
    Stores asciidoc(1) command options.
    """
    def __init__(self, values=[]):
        self.values = values[:]
    def __call__(self, name, value=None):
        """Shortcut for append method."""
        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):
    """
    Parse and compare AsciiDoc version numbers. Instance attributes:

    string: String version number '<major>.<minor>[.<micro>][suffix]'.
    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:

    >>> Version('8.2.5') < Version('8.3 beta 1')
    True
    >>> Version('8.3.0') == Version('8.3. beta 1')
    True
    >>> Version('8.2.0') < Version('8.20')
    True
    >>> Version('8.20').major
    8
    >>> Version('8.20').minor
    20
    >>> Version('8.20').micro
    0
    >>> Version('8.20').suffix
    ''
    >>> Version('8.20 beta 1').suffix
    'beta 1'

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

    def __lt__(self, other):
        if self.major < other.major:
            return True

        elif self.major == other.major:
            if self.minor < other.minor:
                return True
            elif self.minor == other.minor:
                if self.micro < other.micro:
                    return True
        return False

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

        elif self.major <= other.major:
            if self.minor > other.minor:
                return False
            elif self.minor <= other.minor:
                if self.micro > 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):
    """
    AsciiDoc API class.
    """
    def __init__(self, asciidoc_py=None):
        """
        Locate and import asciidoc.py.
        Initialize instance attributes.
        """
        self.options = Options()
        self.attributes = {}
        self.messages = []
        # Search for the asciidoc command file.
        # Try ASCIIDOC_PY environment variable first.
        cmd = os.environ.get('ASCIIDOC_PY')
        if cmd:
            if not os.path.isfile(cmd):
                raise AsciiDocError('missing ASCIIDOC_PY file: %s' % cmd)
        elif asciidoc_py:
            # Next try path specified by caller.
            cmd = asciidoc_py
            if not os.path.isfile(cmd):
                raise AsciiDocError('missing file: %s' % cmd)
        else:
            # Try shell search paths.
            for fname in ['asciidoc.py','asciidoc.pyc','asciidoc']:
                cmd = find_in_path(fname)
                if cmd: break
            else:
                # Finally try current working directory.
                for cmd in ['asciidoc.py','asciidoc.pyc','asciidoc']:
                    if os.path.isfile(cmd): break
                else:
                    raise AsciiDocError('failed to locate asciidoc')
        self.cmd = os.path.realpath(cmd)
        self.__import_asciidoc()

    def __import_asciidoc(self, reload=False):
        '''
        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.
        '''
        if os.path.splitext(self.cmd)[1] in ['.py','.pyc']:
            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('failed to import ' + 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] < 5:
                    import imp
                    module = imp.load_source('asciidoc', self.cmd)
                else:
                    import importlib.util
                    spec = importlib.util.spec_from_file_location('asciidoc', self.cmd)
                    module = importlib.util.module_from_spec(spec)
                    spec.loader.exec_module(module)
                self.asciidoc = module
            except ImportError:
                raise AsciiDocError('failed to import ' + self.cmd)
        if Version(self.asciidoc.VERSION) < Version(MIN_ASCIIDOC_VERSION):
            raise AsciiDocError(
                'asciidocapi %s requires asciidoc %s or better'
                % (API_VERSION, MIN_ASCIIDOC_VERSION))

    def execute(self, infile, outfile=None, backend=None):
        """
        Compile infile to outfile using backend format.
        infile can outfile can be file path strings or file like objects.
        """
        self.messages = []
        opts = Options(self.options.values)
        if outfile is not None:
            opts('--out-file', outfile)
        if backend is not None:
            opts('--backend', backend)
        for k, v in self.attributes.items():
            if v == '' or k[-1] in '!@':
                s = k
            elif v is None:  # A None value undefines the attribute.
                s = k + '!'
            else:
                s = '%s=%s' % (k, v)
            opts('--attribute', 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__ == "__main__":
    """
    Run module doctests.
    """
    import doctest
    options = doctest.NORMALIZE_WHITESPACE + doctest.ELLIPSIS
    test_result = doctest.testmod(optionflags=options)
    print(test_result)
    sys.exit(test_result.failed > 0)

Name	Size	Last Modified	Owner	Permissions
asn1crypto	Dir	September 10 2020 5:22:33	root	0755
asn1crypto-0.24.0-py3.6.egg-info	Dir	September 10 2020 5:22:32	root	0755
babel	Dir	March 13 2023 2:30:48	root	0755
Babel-2.5.1-py3.6.egg-info	Dir	March 13 2023 2:30:46	root	0755
beautifulsoup4-4.6.3-py3.6.egg-info	Dir	August 16 2021 8:28:30	root	0755
bs4	Dir	August 16 2021 8:28:30	root	0755
chardet	Dir	September 10 2020 5:22:32	root	0755
chardet-3.0.4-py3.6.egg-info	Dir	September 10 2020 5:22:32	root	0755
cloudinit	Dir	March 15 2024 8:07:24	root	0755
cloud_init-23.4-py3.6.egg-info	Dir	March 15 2024 8:07:24	root	0755
cssselect	Dir	August 16 2021 8:28:30	root	0755
cssselect-0.9.2-py3.6.egg-info	Dir	August 16 2021 8:28:30	root	0755
dateutil	Dir	September 10 2020 4:53:08	root	0755
decorator-4.2.1-py3.6.egg-info	Dir	September 10 2020 4:52:52	root	0755
distro-1.4.0-py3.6.egg-info	Dir	February 05 2024 7:51:51	root	0755
dnf	Dir	February 05 2024 7:55:32	root	0755
dnf-plugins	Dir	February 05 2024 7:55:33	root	0755
dnfpluginscore	Dir	February 05 2024 7:55:33	root	0755
file_magic-0.3.0-py3.6.egg-info	Dir	March 15 2024 8:07:15	root	0755
firewall	Dir	February 05 2024 7:51:52	root	0755
html5lib	Dir	August 16 2021 8:28:30	root	0755
html5lib-0.999999999-py3.6.egg-info	Dir	August 16 2021 8:28:30	root	0755
idna	Dir	July 25 2024 7:42:34	root	0755
idna-2.5-py3.6.egg-info	Dir	July 25 2024 7:42:34	root	0755
isc	Dir	March 15 2024 8:06:15	root	0755
jinja2	Dir	March 15 2024 8:07:21	root	0755
Jinja2-2.10.1-py3.6.egg-info	Dir	March 15 2024 8:07:21	root	0755
jsonpatch-1.21-py3.6.egg-info	Dir	September 10 2020 5:22:38	root	0755
jsonpointer-1.10-py3.6.egg-info	Dir	September 10 2020 5:22:38	root	0755
jsonschema	Dir	September 10 2020 5:22:38	root	0755
jsonschema-2.6.0-py3.6.egg-info	Dir	September 10 2020 5:22:38	root	0755
jwt	Dir	September 10 2020 5:22:33	root	0755
mockbuild	Dir	December 04 2020 5:19:05	root	0755
nftables	Dir	February 05 2024 7:51:51	root	0755
oauthlib	Dir	September 10 2020 5:22:33	root	0755
oauthlib-2.1.0-py3.6.egg-info	Dir	September 10 2020 5:22:33	root	0755
pexpect	Dir	August 16 2021 8:28:29	root	0755
pip	Dir	March 15 2024 8:06:21	root	0755
pip-9.0.3.dist-info	Dir	March 15 2024 8:11:03	root	0755
pkg_resources	Dir	March 13 2023 2:47:03	root	0755
ply	Dir	August 16 2021 8:28:30	root	0755
ply-3.9-py3.6.egg-info	Dir	August 16 2021 8:28:30	root	0755
prettytable-0.7.2-py3.6.egg-info	Dir	September 10 2020 5:22:37	root	0755
procfs	Dir	February 05 2024 7:51:51	root	0755
ptyprocess	Dir	August 16 2021 8:28:29	root	0755
__pycache__	Dir	July 25 2024 7:43:21	root	0755
pycparser	Dir	September 10 2020 5:22:32	root	0755
pycparser-2.14-py3.6.egg-info	Dir	September 10 2020 5:22:32	root	0755
pydbus	Dir	February 18 2021 1:02:33	root	0755
pydbus-0.6.0-py3.6.egg-info	Dir	February 18 2021 1:02:33	root	0755
PyJWT-1.6.1-py3.6.egg-info	Dir	September 10 2020 5:22:33	root	0755
pyparsing-2.1.10.dist-info	Dir	December 04 2020 5:08:46	root	0755
pyserial-3.1.1-py3.6.egg-info	Dir	March 15 2024 8:07:21	root	0755
PySocks-1.6.8-py3.6.egg-info	Dir	September 10 2020 5:22:32	root	0755
python_dateutil-2.6.1-py3.6.egg-info	Dir	September 10 2020 4:53:08	root	0755
python_linux_procfs-0.7.3-py3.6.egg-info	Dir	February 05 2024 7:51:51	root	0755
pytz	Dir	February 05 2024 7:56:22	root	0755
pytz-2017.2-py3.6.egg-info	Dir	February 05 2024 7:56:22	root	0755
pyudev	Dir	September 10 2020 4:53:08	root	0755
pyudev-0.21.0-py3.6.egg-info	Dir	September 10 2020 4:53:08	root	0755
requests	Dir	February 05 2024 7:51:52	root	0755
requests-2.20.0-py3.6.egg-info	Dir	February 05 2024 7:51:52	root	0755
sepolgen	Dir	July 25 2024 7:40:58	root	0755
sepolicy	Dir	July 25 2024 7:40:58	root	0755
serial	Dir	March 15 2024 8:07:21	root	0755
setroubleshoot	Dir	February 05 2024 7:52:55	root	0755
setuptools	Dir	March 13 2023 2:47:03	root	0755
setuptools-39.2.0.dist-info	Dir	March 13 2023 2:47:03	root	0755
six-1.11.0.dist-info	Dir	September 10 2020 4:52:49	root	0755
slip	Dir	March 13 2023 2:49:44	root	0755
sos	Dir	July 25 2024 7:40:59	root	0755
sos-4.7.1-py3.6.egg-info	Dir	July 25 2024 7:40:59	root	0755
SSSDConfig	Dir	July 25 2024 7:40:58	root	0755
syspurpose	Dir	February 05 2024 7:51:52	root	0755
syspurpose-1.28.42-py3.6.egg-info	Dir	February 05 2024 7:51:52	root	0755
tracer	Dir	February 05 2024 7:55:33	root	0755
tuned	Dir	July 25 2024 7:42:34	root	0755
urllib3	Dir	February 05 2024 7:51:52	root	0755
urllib3-1.24.2-py3.6.egg-info	Dir	February 05 2024 7:51:52	root	0755
vdo	Dir	February 05 2024 7:55:47	root	0755
webencodings	Dir	August 16 2021 8:28:30	root	0755
webencodings-0.5.1-py3.6.egg-info	Dir	August 16 2021 8:28:30	root	0755
asciidocapi.py	9.228 KB	May 13 2019 10:59:12	root	0644
configobj-5.0.6-py3.6.egg-info	2.955 KB	May 11 2019 3:28:44	root	0644
configobj.py	87.526 KB	August 26 2014 1:11:36	root	0644
decorator.py	16.18 KB	January 14 2018 10:00:21	root	0644
distro.py	42.237 KB	February 04 2019 8:25:26	root	0644
easy_install.py	0.123 KB	January 24 2023 7:53:02	root	0644
isc-2.0-py3.6.egg-info	0.261 KB	February 26 2024 1:52:58	root	0644
jsonpatch.py	23.896 KB	December 30 2017 2:06:28	root	0644
jsonpointer.py	9.148 KB	October 28 2015 7:06:33	root	0644
magic.py	8.657 KB	October 25 2023 6:08:43	root	0644
nftables-0.1-py3.6.egg-info	0.608 KB	November 15 2023 6:48:06	root	0644
pexpect-4.3.1-py3.6.egg-info	2.231 KB	May 14 2019 11:19:32	root	0644
prettytable.py	52.934 KB	April 06 2013 11:44:06	root	0644
ptyprocess-0.5.2-py3.6.egg-info	0.258 KB	May 14 2019 4:25:40	root	0644
pyparsing.py	224.479 KB	May 11 2019 3:27:54	root	0644
seobject.py	106.421 KB	April 16 2024 1:49:57	root	0644
sepolicy-1.1-py3.6.egg-info	0.222 KB	April 16 2024 1:49:57	root	0644
setroubleshoot-1.1-py3.6.egg-info	0.212 KB	November 22 2023 12:47:37	root	0644
six.py	30.164 KB	May 11 2019 3:31:40	root	0644
slip-0.6.4-py3.6.egg-info	0.191 KB	May 04 2022 7:05:21	root	0644
slip.dbus-0.6.4-py3.6.egg-info	0.263 KB	May 04 2022 7:05:21	root	0644
sockshandler.py	2.845 KB	December 21 2017 4:05:00	root	0644
socks.py	31.524 KB	December 21 2017 4:05:00	root	0644
SSSDConfig-2.9.4-py3.6.egg-info	0.2 KB	April 18 2024 12:49:19	root	0644
validate.py	46.13 KB	August 26 2014 1:11:36	root	0644
_version.py	0.021 KB	August 26 2014 1:11:36	root	0644

2017 © D7net \| D704T team