asda?‰PNG
IHDR ? f ??C1 sRGB ?? é gAMA ±? üa pHYs ? ??o¨d GIDATx^íüL”÷ e÷Y?a?("Bh?_ò???￠§?q5k?*:t0A-o??￥]VkJ￠M??f?±8\k2íll￡1]q?ù???T
3
]$ @ 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 ejejdk 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) 2009 Stuart Rackham. Free use of this software is granted
under the terms of the GNU General Public License (GPL).
Nz0.1.2z8.4.1c C sR |dkrt jjdd}x6|jt jD ]"}t jj|| }t jj|r$|S q$W dS dS )z=
Find file fname in paths. Return None if not found.
NPATH )osenvirongetsplitpathseppathjoinisfile)fnamer dirZfpath r !/usr/lib/python3.6/asciidocapi.py find_in_path< s r c @ s e Zd ZdS )
AsciiDocErrorN)__name__
__module__ __qualname__r r r r r J 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__R s zOptions.__init__Nc C s | j || dS )zShortcut for append method.N)append)r namevaluer r r __call__T s zOptions.__call__c C s, t |ttfkrt|}| jj||f d S )N)typeintfloatstrr r )r r r r r r r W s zOptions.append)N)N)r r r __doc__r r r r r r r r N 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 || _ tjd| j }|s&td| j |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 )NTF)r, r- r. )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 )NFT)r, r- r. )r r1 r r r __le__ s zVersion.__le__c C s, | j |j kr(| j|jkr(| j|jkr(dS dS )NTF)r, r- r. )r r1 r r r __eq__ s $zVersion.__eq__N)r r r r! r r2 r3 r4 r r r r r" ] s
r" c @ s. e Zd ZdZd
ddZd ddZd dd ZdS )
AsciiDocAPIz
AsciiDoc API class.
Nc C s t | _i | _g | _tjjd}|r>tjj|st d| nb|r`|}tjj|st d| n@x>d D ]}t
|}|rfP qfW x"d
D ]}tjj|rP qW t dtjj || _ | j
dS ) zX
Locate and import asciidoc.py.
Initialize instance attributes.
Z ASCIIDOC_PYz missing ASCIIDOC_PY file: %szmissing file: %s asciidoc.py asciidoc.pycasciidoczfailed to locate asciidocN)r6 r7 r8 )r6 r7 r8 )r options
attributesmessagesr r r r r r r realpathcmd _AsciiDocAPI__import_asciidoc)r Z asciidoc_pyr= r r r r r s*
zAsciiDocAPI.__init__Fc C s@ t jj| jd d
krtjjdt jj| j zTy,|rLddl}|j| j nddl }|| _ W n" t
k
r~ t d| j Y nX W dtjd= X ny`tj d dk rddl
}|jd| j}n0ddl}|jjd| j}|jj|}|jj| || _ W n$ t
k
r t d| j Y nX t| j jttk r r8 executer=
SystemExitcoder )
r ZinfileZoutfileZbackendZoptskvsargser r r rY s,
zAsciiDocAPI.execute)N)F)NN)r r r r! r r> rY r r r r r5 s
!
+r5 __main__)Z optionflags)N)r! rC r r( rS rR r Exceptionr objectr r" r5 r ZdoctestZNORMALIZE_WHITESPACEELLIPSISr9 ZtestmodZ test_resultprintexitZfailedr r r r 4 s
Jr