î
úü fE; ã @ s d Z d d l Z d d l Z e j d e ƒ d Z Gd d „ d ƒ Z Gd d „ d ƒ Z Gd d „ d ƒ Z Gd
d „ d e ƒ Z Gd d
„ d
e ƒ Z
d d d „ Z e d k r¾ e ƒ n d S)a Generic output formatting.
Formatter objects transform an abstract flow of formatting events into
specific output events on writer objects. Formatters manage several stack
structures to allow various properties of a writer object to be changed and
restored; writers need not be able to handle relative changes nor any sort
of ``change back'' operation. Specific writer properties which may be
controlled via formatter objects are horizontal alignment, font, and left
margin indentations. A mechanism is provided which supports providing
arbitrary, non-exclusive style settings to a writer as well. Additional
interfaces facilitate formatting events which are not reversible, such as
paragraph separation.
Writer objects encapsulate device interfaces. Abstract devices, such as
file formats, are supported as well as physical devices. The provided
implementations all work with abstract devices. The interface makes
available mechanisms for setting the properties which formatter objects
manage and inserting data into the output.
é NzDthe formatter module is deprecated and will be removed in Python 3.6c @ sú e Z d Z d Z d d d „ Z d d „ Z d d „ Z d d
„ Z d d d „ Z d
d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z d d „ Z d d „ Z d! d" „ Z d# d$ d% „ Z d# d& d' „ Z d S)(Ú
NullFormattera= A formatter which does nothing.
If the writer parameter is omitted, a NullWriter instance is created.
No methods of the writer are called by NullFormatter instances.
Implementations should inherit from this class if implementing a writer
interface but don't need to inherit any implementation.
Nc C s% | d k r t ƒ } n | | _ d S)N)Ú
NullWriterÚwriter)Úselfr © r ú./opt/alt/python34/lib64/python3.4/formatter.pyÚ__init__) s zNullFormatter.__init__c C s d S)Nr )r Ú blankliner r r Ú
end_paragraph- s zNullFormatter.end_paragraphc C s d S)Nr )r r r r Úadd_line_break. s z NullFormatter.add_line_breakc O s d S)Nr )r ÚargsÚkwr r r Ú add_hor_rule/ s zNullFormatter.add_hor_rulec C s d S)Nr )r ÚformatÚcounterr r r r Úadd_label_data0 s z NullFormatter.add_label_datac C s d S)Nr )r Údatar r r Úadd_flowing_data1 s z NullFormatter.add_flowing_datac C s d S)Nr )r r r r r Úadd_literal_data2 s z NullFormatter.add_literal_datac C s d S)Nr )r r r r Úflush_softspace3 s z NullFormatter.flush_softspacec C s d S)Nr )r Úalignr r r Úpush_alignment4 s z NullFormatter.push_alignmentc C s d S)Nr )r r r r Ú
pop_alignment5 s zNullFormatter.pop_alignmentc C s d S)Nr )r Úxr r r Ú push_font6 s zNullFormatter.push_fontc C s d S)Nr )r r r r Úpop_font7 s zNullFormatter.pop_fontc C s d S)Nr )r Úmarginr r r Ú push_margin8 s zNullFormatter.push_marginc C s d S)Nr )r r r r Ú
pop_margin9 s zNullFormatter.pop_marginc C s d S)Nr )r Úspacingr r r Ú set_spacing: s zNullFormatter.set_spacingc G s d S)Nr )r Ústylesr r r Ú
push_style; s zNullFormatter.push_styleé c C s d S)Nr )r Únr r r Ú pop_style< s zNullFormatter.pop_stylec C s d S)Nr )r Úflagr r r Úassert_line_data= s z NullFormatter.assert_line_data)Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r
r r r r r r r r r r r r r r" r% r' r r r r r s& r c @ s e Z d Z d Z d d „ Z d d „ Z d d „ Z d d „ Z d
d d „ Z d
d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z d d „ Z d d „ Z d! d" „ Z d# d$ „ Z d% d& „ Z d' d( „ Z d) d* d+ „ Z d) d, d- „ Z d
S).ÚAbstractFormatterzêThe standard formatter.
This implementation has demonstrated wide applicability to many writers,
and may be used directly in most circumstances. It has been used to
implement a full-featured World Wide Web browser.
c C sy | | _ d | _ g | _ g | _ g | _ d | _ g | _ d | _ d | _ d | _ d | _
d | _ d | _ d S)Nr# r )
r r Ú align_stackÚ
font_stackÚ margin_stackr Ú style_stackÚnospaceÚ softspaceÚpara_endÚparskipÚ
hard_breakÚ
have_label)r r r r r r N s zAbstractFormatter.__init__c C s‹ | j s" | j j ƒ d | _ n | j | k rg | j rg | j j | | j ƒ | | _ d | _ n d | _ | _ | _ d | _ d S)Nr r# ) r5 r Úsend_line_breakr6 r4 Úsend_paragraphr1 r3 r2 )r r r r r r
] s
z AbstractFormatter.end_paragraphc C sO | j p | j s2 | j j ƒ d | _ | _ n d | _ | _ d | _ d S)Nr r# )r5 r3 r r7 r6 r4 r1 r2 )r r r r r h s
z AbstractFormatter.add_line_breakc O s^ | j s | j j ƒ n | j j | | Ž d | _ | _ d | _ | _ | _ | _ d S)Nr# r ) r5 r r7 Ú
send_hor_ruler1 r6 r3 r2 r4 )r r r
r r r r o s
z AbstractFormatter.add_hor_ruleNc C s» | j s | j r# | j j ƒ n | j sK | j j | rA d pD d ƒ n t | t ƒ ry | j j | j | | ƒ ƒ n | j j | ƒ d | _
| _ | _ | _ d | _ | _ d S)Nr# r )
r6 r5 r r7 r3 r8 Ú
isinstanceÚstrÚsend_label_dataÚformat_counterr1 r2 r4 )r r r r r r r r v s z AbstractFormatter.add_label_datac C sª d } x | D]• } | d k r0 | d | } q
| d k rd | d k r¢ | | j | | ƒ } q¢ q
| d k r˜ | d k r¢ | | j | | ƒ } q¢ q
| | } q
W| S)NÚ Ú1z%dZaAr ZiI)Ú
format_letterÚ format_roman)r r r ÚlabelÚcr r r r= ‚ s
z AbstractFormatter.format_counterc C sV d } xI | d k rQ t | d d ƒ \ } } t t | ƒ | ƒ } | | } q W| S)Nr> r r# é )ÚdivmodÚchrÚord)r Úcaser rB r Úsr r r r@ ‘ s z AbstractFormatter.format_letterc C s d d d d g } d d d g } d \ } } x | d k rñ t | d
ƒ \ } } | d k rz | | | | d | } nj | d
k rŸ | | | | | } nE | d k r | | } | d } n d } | | | | } | | } | d } q0 W| d k r| j ƒ S| S)NÚir rC ÚmÚvÚlÚdr> r é
é r# é é ÚI)r> r )rE Úupper) r rH r ZonesZfivesrB Úindexr rI r r r rA œ s&
z AbstractFormatter.format_romanc C sñ | s
d S| d d … j ƒ } | d d … j ƒ } d j | j ƒ ƒ } | j r_ | r_ d S| sn | j r¯ | s– | j s’ d | _ d | _ n d S| j s¯ d | } q¯ n d | _ | _ | _ | _ | _ | | _ | j j
| ƒ d S)Nr# ú r éÿÿÿÿ) ÚisspaceÚjoinÚsplitr1 r2 r4 r5 r3 r6 r Úsend_flowing_data)r r ZprespaceZ postspacer r r r ´ s$ % z"AbstractFormatter.add_flowing_datac C sx | s
d S| j r& | j j d ƒ n | d d … d k | _ d | _ | _ | _ | _ | _ | j j | ƒ d S)NrV r# Ú
r rW ) r2 r r[ r5 r1 r3 r4 r6 Úsend_literal_data)r r r r r r È s %z"AbstractFormatter.add_literal_datac C sN | j rJ d | _ | _ | _ | _ | _ d | _ | j j d ƒ n d S)Nr r# rV )r2 r5 r3 r4 r6 r1 r r[ )r r r r r Ñ s % z!AbstractFormatter.flush_softspacec C sX | rA | | j k rA | j j | ƒ | | _ | j j | ƒ n | j j | j ƒ d S)N)r r Ú
new_alignmentr- Úappend)r r r r r r Ø s
z AbstractFormatter.push_alignmentc C sc | j r | j d =n | j rF | j d | _ } | j j | ƒ n d | _ | j j d ƒ d S)Nr# rW rW )r- r r r^ )r r r r r r à s
z AbstractFormatter.pop_alignmentc
C sý | \ } } } } | j rN d | _ | _ | _ d | _ | j j d ƒ n | j rÇ | j d \ } } } } | t k r… | } n | t k rš | } n | t k r¯ | } n | t k rÇ | } qÇ n | | | | f } | j j | ƒ | j j | ƒ d S)Nr r# rV rW )
r2 r5 r3 r1 r r[ r. ÚAS_ISr_ Únew_font)
r ÚfontÚsizerJ ÚbZttZcsizeZciÚcbZcttr r r r ê s$ zAbstractFormatter.push_fontc C sI | j r | j d =n | j r/ | j d } n d } | j j | ƒ d S)Nr# rW rW )r. r ra )r rb r r r r ú s
zAbstractFormatter.pop_fontc C s] | j j | ƒ d d „ | j Dƒ } | r@ | r@ | d } n | j j | t | ƒ ƒ d S)Nc S s g | ] } | r | ‘ q Sr r )Ú.0rK r r r ú