grthtrhthjhtyjytjytkergtrhtrjytjerhrfh4:24 29/09/2026a
a' @ s d Z ddlZddlZddlZdZdZdddZG dd deZG d d
d
e Z
G d d d e Z G d
d de Z e
dkrddlZejej ZejedZee eejdk dS )a
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())
Hello Joe Bloggs
>>> asciidoc.attributes['author'] = 'Bill Smith'
>>> infile = io.StringIO('Hello _{author}_')
>>> outfile = io.StringIO()
>>> asciidoc.execute(infile, outfile, backend='docbook')
>>> print(outfile.getvalue())
Hello Bill Smith
2. Check error handling:
>>> import io
>>> asciidoc = AsciiDocAPI()
>>> infile = io.StringIO('---------')
>>> outfile = io.StringIO()
>>> asciidoc.execute(infile, outfile)
Traceback (most recent call last):
File "", line 1, in
File "asciidocapi.py", line 189, in execute
raise AsciiDocError(self.messages[-1])
AsciiDocError: ERROR: : line 1: [blockdef-listing] missing closing delimiter
Copyright (C) 2002-2013 Stuart Rackham.
Copyright (C) 2013-2020 AsciiDoc Contributors.
Free use of this software is granted under the terms of the GNU General
Public License version 2 (GPLv2).
Nz0.1.2z8.4.1c C sN |du rt jdd}|t jD ]&}t j|| }t j|r"| S q"dS )z=
Find file fname in paths. Return None if not found.
NPATH )osenvirongetsplitpathseppathjoinisfile)fnamer dirZfpath r //usr/lib/python3.9/site-packages/asciidocapi.py find_in_pathA s
r c @ s e Zd ZdS )
AsciiDocErrorN)__name__
__module__ __qualname__r r r r r O s r c @ s0 e Zd ZdZg fddZd ddZd
ddZdS ) Optionsz-
Stores asciidoc(1) command options.
c C s |d d | _ d S N)values)selfr r r r __init__W s zOptions.__init__Nc C s | || dS )zShortcut for append method.N)appendr namevaluer r r __call__Z s zOptions.__call__c C s, t |ttfv rt|}| j||f d S r )typeintfloatstrr r r r r r r ^ s zOptions.append)N)N)r r r __doc__r r r r r r r r S s
r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) Versiona
Parse and compare AsciiDoc version numbers. Instance attributes:
string: String version number '.[.][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'
c C sn || _ td| j }|s&td| j | }t|d | _t|d | _t|d pVd| _|d pfd| _ d S ) Nz#^(\d+)\.(\d+)(\.(\d+))?\s*(.*?)\s*$zinvalid version number: %sr 0 r )
stringrematch
ValueErrorgroupsr majorminormicrosuffix)r versionZreor- r r r r s zVersion.__init__c C sL | j |j k rdS | j |j krH| j|jk r,dS | j|jkrH| j|jk rHdS dS NTFr. r/ r0 r otherr r r __lt__ s zVersion.__lt__c C sL | j |j krdS | j |j krH| j|jkr,dS | j|jkrH| j|jkrHdS dS )NFTr4 r5 r r r __le__ s zVersion.__le__c C s, | j |j kr(| j|jkr(| j|jkr(dS dS r3 r4 r5 r r r __eq__ s
zVersion.__eq__N)r r r r# r r7 r8 r9 r r r r r$ d s
r$ c @ s. e Zd ZdZd
ddZd ddZd dd ZdS )
AsciiDocAPIz
AsciiDoc API class.
Nc C s t | _i | _g | _tjd}|r>tj|st d| n|r`|}tj|st d| nntj
tj t }dD ]}t
||d}|rx qqxdD ]}t
|}|r qqdD ]}tj|r qqt dtj || _| dS )zX
Locate and import asciidoc.py.
Initialize instance attributes.
Z ASCIIDOC_PYz missing ASCIIDOC_PY file: %szmissing file: %s)z asciidoc.pyz asciidoc.pycasciidoc)r zfailed to locate asciidocN)r options
attributesmessagesr r r r r r dirnamerealpath__file__r cmd _AsciiDocAPI__import_asciidoc)r Z asciidoc_pyrB Z this_pathr r r r r s4 zAsciiDocAPI.__init__Fc
C s4 t j| jd dv rtjdt j| j zZz,|rLddl}|| j nddl }|| _ W n t
y| t d| j Y n0 W tjd= n
tjd= 0 ntzPddl m
}m} ddlm} |d| j}|d|}||} |j| | | _ W n" t
y t d| j Y n0 t| j jttk r0t d ttf dS )
a
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.
r% )z.pyz.pycr Nzfailed to import )spec_from_loadermodule_from_spec)SourceFileLoaderr; z-asciidocapi %s requires asciidoc %s or better)r r splitextrB sysinsertr? importlibreloadr; ImportErrorr importlib.utilrD rE importlib.machineryrF loader exec_moduler$ ZVERSIONMIN_ASCIIDOC_VERSION API_VERSION)
r rK rJ r; rD rE rF rO specmoduler r r Z__import_asciidoc s8
z AsciiDocAPI.__import_asciidocc
C s$ g | _ t| jj}|dur$|d| |dur6|d| | j D ]J\}}|dks\|d dv rb|}n |du rt|d }n d||f }|d | q@|g}| jd
d zDz*| j| j |j| W | jj dd | _ n| jj dd | _ 0 W n< t
y } z"| j r
t | j d W Y d} ~ n
d} ~ 0 0 dS ) z
Compile infile to outfile using backend format.
infile can outfile can be file path strings or file like objects.
Nz
--out-filez --backendr z!@!z%s=%sz --attributeT)rK )
r> r r< r r= itemsrC r; executerB
SystemExitcoder )
r ZinfileZoutfileZbackendZoptskvsargser r r rX s,
,zAsciiDocAPI.execute)N)F)NN)r r r r# r rC rX r r r r r: s
-
(r: __main__)Z optionflags)N)r# rH r r* rR rQ r Exceptionr objectr r$ r: r ZdoctestZNORMALIZE_WHITESPACEELLIPSISr< ZtestmodZ test_resultprintexitZfailedr r r r s 8
L{