D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
share
/
gdb
/
python
/
gdb
/
Filename :
printing.pyc
back
Copy
� �� Rc @ s� d Z d d l Z d d l Z d d l Z d d l Z e j d d k rX e Z e Z n d e f d � � YZ d e f d � � YZ e d � Z d e f d � � YZ d d d � � YZ d e f d � � YZ d S( s+ Utilities for working with pretty-printers.i����Ni i t PrettyPrinterc B s# e Z d Z d d � Z d � Z RS( s A basic pretty-printer. Attributes: name: A unique string among all printers for the context in which it is defined (objfile, progspace, or global(gdb)), and should meaningfully describe what can be pretty-printed. E.g., "StringPiece" or "protobufs". subprinters: An iterable object with each element having a `name' attribute, and, potentially, "enabled" attribute. Or this is None if there are no subprinters. enabled: A boolean indicating if the printer is enabled. Subprinters are for situations where "one" pretty-printer is actually a collection of several printers. E.g., The libstdc++ pretty-printer has a pretty-printer for each of several different types, based on regexps. c C s | | _ | | _ t | _ d S( N( t namet subprinterst Truet enabled( t selfR R ( ( s% /usr/share/gdb/python/gdb/printing.pyt __init__3 s c C s t d � � d S( Ns PrettyPrinter __call__( t NotImplementedError( R t val( ( s% /usr/share/gdb/python/gdb/printing.pyt __call__8 s N( t __name__t __module__t __doc__t NoneR R ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR s t SubPrettyPrinterc B s e Z d Z d � Z RS( s� Baseclass for sub-pretty-printers. Sub-pretty-printers needn't use this, but it formalizes what's needed. Attributes: name: The name of the subprinter. enabled: A boolean indicating if the subprinter is enabled. c C s | | _ t | _ d S( N( R R R ( R R ( ( s% /usr/share/gdb/python/gdb/printing.pyR G s ( R R R R ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR = s c C s� t | d � r/ t | d � r/ t d � � n t | d � r] t | d � r] t d � � n t | d � s{ t d � � n | d k r� t j d � r� t j d t � n t } n/ t j d � r� t j d | j | j f � n t | d � r�t | j t � st d � � n | j j d � d k r9t d � � n d } xi | j D][ } t | d � r�| j | j k r�| r�| j | =Pq�t d | j � � n | d } qIWn | j j d | � d S( s� Register pretty-printer PRINTER with OBJ. The printer is added to the front of the search list, thus one can override an existing printer if one needs to. Use a different name when overriding an existing printer, otherwise an exception will be raised; multiple printers with the same name are disallowed. Arguments: obj: Either an objfile, progspace, or None (in which case the printer is registered globally). printer: Either a function of one argument (old way) or any object which has attributes: name, enabled, __call__. replace: If True replace any existing copy of the printer. Otherwise if the printer already exists raise an exception. Returns: Nothing. Raises: TypeError: A problem with the type of the printer. ValueError: The printer's name contains a semicolon ";". RuntimeError: A printer with the same name is already registered. If the caller wants the printer to be listable and disableable, it must follow the PrettyPrinter API. This applies to the old way (functions) too. If printer is an object, __call__ is a method of two arguments: self, and the value to be pretty-printed. See PrettyPrinter. R R s printer missing attribute: nameR s" printer missing attribute: enabledR s# printer missing attribute: __call__t verboses) Registering global %s pretty-printer ... s) Registering %s pretty-printer for %s ... s printer name is not a stringt ;i s semicolon ';' in printer names% pretty-printer already registered: %si N( t hasattrt TypeErrorR t gdbt parametert writeR t filenamet isinstancet basestringt findt ValueErrort pretty_printerst RuntimeErrort insert( t objt printert replacet it p( ( s% /usr/share/gdb/python/gdb/printing.pyt register_pretty_printerL s8 " ! t RegexpCollectionPrettyPrinterc B s? e Z d Z d e f d � � YZ d � Z d � Z d � Z RS( sy Class for implementing a collection of regular-expression based pretty-printers. Intended usage: pretty_printer = RegexpCollectionPrettyPrinter("my_library") pretty_printer.add_printer("myclass1", "^myclass1$", MyClass1Printer) ... pretty_printer.add_printer("myclassN", "^myclassN$", MyClassNPrinter) register_pretty_printer(obj, pretty_printer) t RegexpSubprinterc B s e Z d � Z RS( c C sA t t j | � j | � | | _ | | _ t j | � | _ d S( N( t superR$ R% R t regexpt gen_printert ret compilet compiled_re( R R R' R( ( ( s% /usr/share/gdb/python/gdb/printing.pyR � s ( R R R ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR% � s c C s t t | � j | g � d S( N( R& R$ R ( R R ( ( s% /usr/share/gdb/python/gdb/printing.pyR � s c C s# | j j | j | | | � � d S( so Add a printer to the list. The printer is added to the end of the list. Arguments: name: The name of the subprinter. regexp: The regular expression, as a string. gen_printer: A function/method that given a value returns an object to pretty-print it. Returns: Nothing. N( R t appendR% ( R R R' R( ( ( s% /usr/share/gdb/python/gdb/printing.pyt add_printer� s c C sb t j j | j � j } | s" d Sx9 | j D]. } | j r, | j j | � r, | j | � Sq, Wd S( s1 Lookup the pretty-printer for the provided value.N( R t typest get_basic_typet typet tagR R R R+ t searchR( ( R R t typenameR ( ( s% /usr/share/gdb/python/gdb/printing.pyR � s ( R R R R R% R R- R ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR$ � s t _EnumInstancec B s e Z d � Z d � Z RS( c C s | | _ | | _ d S( N( t enumeratorsR ( R R5 R ( ( s% /usr/share/gdb/python/gdb/printing.pyR � s c C s� g } t | j � } t } xH | j D]= \ } } | | @d k r% | j | � | | @} t } q% q% W| sy | d k r� | j d | � n d | j d j | � f S( Ni s <unknown: 0x%x>s 0x%x [%s]s | ( t longR t FalseR5 R, R t join( R t flag_listt vt any_foundt e_namet e_value( ( s% /usr/share/gdb/python/gdb/printing.pyt to_string� s ( R R R R> ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR4 � s t FlagEnumerationPrinterc B s e Z d Z d � Z d � Z RS( s� A pretty-printer which can be used to print a flag-style enumeration. A flag-style enumeration is one where the enumerators are or'd together to create values. The new printer will print these symbolically using '|' notation. The printer must be registered manually. This printer is most useful when an enum is flag-like, but has some overlap. GDB's built-in printing will not handle this case, but this printer will attempt to.c C s# t t | � j | � t | _ d S( N( R& R? R R7 t initialized( R t enum_type( ( s% /usr/share/gdb/python/gdb/printing.pyR � s c C s� | j sy t | _ t j | j � } g | _ x0 | j � D]" } | j j | j | j f � q: W| j j d d � � n | j r� t | j | � Sd Sd S( Nt keyc S s | j S( N( t enumval( t x( ( s% /usr/share/gdb/python/gdb/printing.pyt <lambda> s ( R@ R R t lookup_typeR R5 t fieldsR, RC t sortR R4 R ( R R t flagst field( ( s% /usr/share/gdb/python/gdb/printing.pyR � s ( R R R R R ( ( ( s% /usr/share/gdb/python/gdb/printing.pyR? � s ( ( R R t gdb.typesR) t syst version_infot strR t intR6 t objectR R R7 R# R$ R4 R? ( ( ( s% /usr/share/gdb/python/gdb/printing.pyt <module> s LA