n3Xc @@ st d d l m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l
Z
d d l Z d d l Z d d l
Z
y d d l Z Wn e k
r d d l Z n Xd d l Z d d l m Z m Z d d l m Z m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d e! f d
YZ" d Z# d Z$ d
d Z% d S( i ( t absolute_importt print_functionN( t Argt MutuallyExclusiveArgList( t
ConfigDatat
ConfigView( t
ArgumentError( t configure_root_logger( t RequestBuilder( t add_default_routest aggregate_subclass_fieldst BaseCommandc B@ s e Z d Z d Z d Z g Z d Z e Z e
Z d d e
d Z e
d Z d Z d Z d Z d Z d Z d Z d
Z d Z d Z d
Z e
d Z e d Z d Z d Z e d Z d Z d Z RS( s3
The basis for a command line tool. To invoke this as a command line tool,
call the run() method on the class. Arguments will be parsed from the
command line. To invoke this in another context, such as from inside
another command, pass keyword arguments to __init__() with names that match
those stored by the argument parser and then call main() to retrieve a
result.
The general workflow of a command involves two methods: main(), which
inspects the arguments stored in self.args, does something, and returns a
result; and print_result(), which takes the output of main() and prints it
to stdout. By default, both of these methods do nothing. It is up to you
to implement them to do what the tool is designed to do.
Important members of this class include:
- DESCRIPTION: a string that describes the tool, which is re-wrapped and
used as part of the command line help string. If it is
not supplied, the class's doc string, if any, will be
used instead.
- USAGE: a usage message for the command line help string. If this
is None, one will be generated automatically.
- ARGS: a list of Arg and/or MutuallyExclusiveArgGroup objects
are used to generate command line arguments. Inheriting
classes needing to add command line arguments should
contain their own ARGS lists, which are combined with
those of their parent classes.
t c K@ s | | _ | | _ d | _ | j | _ i | _ d | _ t | _ | | _
| j | | j | j
r t
j r | j t t
_ n | j | j
r | j n | j y | j WnB t k
r
} | j
r| j r| j j t | q n Xd S( N( t argst configt Nonet logt SUITEt suitet _arg_routest _cli_parsert Falset _BaseCommand__debugt _BaseCommand__do_clit _configure_loggingt _process_configfilesR t% _BaseCommand__CONFIGURED_GLOBAL_STATEt _configure_global_loggingt Truet
_build_parsert process_cli_argst distribute_argst configureR t errort str( t selfR t loglevelt _do_clit kwargst err( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt __init__N s.
c K@ s/ | j d | j j | d | j | } | S( NR$ R ( t
setdefaultR t levelR ( t clst otherR& t new( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt
from_other| s c C@ sW t j | j | _ | d k r4 | j j | n | j rS | j j t j n d S( N( t loggingt getLoggert nameR R t setLevelt debugt DEBUG( R# R$ ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s
c C@ su | j d k r< | j j } t | } t | | _ n | j rq | j j t j
| j j j t j
n d S( N( R R R t list_config_filesR R R3 R R2 R/ R4 ( R# t config_filest config_data( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s c C@ s3 | j j d d k r( t d t n t d S( NR3 t colort colourt use_color( R8 R9 ( R t get_global_optionR R ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s c C@ sI t | j p | j p d } t j d | d | j d t d t j } | j } | j | | | j
d d d d d
d t j d d
| j
d d d d d d t j d d | j
d d d d | j j
d d t d | D r| j
d d d d t j d d n% | j
d d d d d t j d d | | _ d S( NR t descriptiont usaget add_helpt formatter_classs --debugt actiont
store_truet destt _debugt defaultt helps show debugging outputs
--debuggert _debuggers$ launch interactive debugger on errors --versiont versions# show the program's version and exitc s@ s- | ]# } t | t r d | j k Vq d S( s -hN( t
isinstanceR t pargs( t .0t arg_obj( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pys <genexpr> s s --helps show this help message and exits -h( t _rewrap_descriptiont DESCRIPTIONt __doc__t argparset ArgumentParsert USAGER t RawDescriptionHelpFormattert collect_arg_objst _populate_parsert add_argumentt SUPPRESSR t format_versiont anyR ( R# R< t parsert arg_objs( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s0
c C@ s& t | j d } t | | j | S( Nt ARGS( R
t __class__R t DEFAULT_ROUTES( R# RZ ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyRS s c C@ s% x | D] } | j | | q Wd S( N( t# _BaseCommand__add_arg_to_cli_parser( R# RY RZ RK ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyRT s
c C@ sI t | t r | j j d t j k r. g S| j | j | j } | j d k rh d | j
| j <n | j | j
| j <| g Sn t | t r | j
d | j } g } x' | D] } | j | j | | q W| St | t s t | t r/g } x' | D] } | j | j | | qW| St d | j j d S( NRB t requireds Unknown argument type ( N( RH R R& t getRO RV RU RI t routesR R RB R t add_mutually_exclusive_groupt is_requiredt extendR^ t listt tuplet TypeErrorR\ t __name__( R# t arglike_objRY t argt exgroupR
t group_arg( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt __add_arg_to_cli_parser s.
c C@ s t | j j } | j d t r3 t | _ n | j d t rm t | _ t t _ t
j
t
j t n | j
j | t d d i d d 6 } x[ t | j D]G } d | j k s d | j k r | | d k r | | | <q q W| j j d t | d S(
NRC RF t REDACTEDc S@ s d S( Ns
<redacted>( ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt <lambda> s t __repr__t passwordt secrets parsed arguments from CLI: %s( ( t varsR t
parse_argst popR R R t _debugger_except_hookt syst
excepthookt signalt SIGUSR1t _debugger_usr1_handlerR
t updatet typeRe t keyst lowerR R R3 R" ( R# t cli_argst redactedt key( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s $c C@ s x t j | j D] \ } } | | j k rF t d j | n | j | } xB | D]: } | d k rZ t | r | | } n | | | <qZ qZ Wq Wd S( Ns got unrecognized arg: "{0}"( t sixt iteritemsR
R Rg t formatR t callable( R# R t valRa t route( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s
c C@ s d S( N( ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR s c C@ s y | d t } WnMt k
rb} d j t j j t j d } t | t r | g } t
| d d r | j | j
n t
| d d r | d c d 7<| j | j n t d j | d t j n^ t | j d k r| j d rt | | j d d t j n t | t | d t j t d
d D rR n t j d
n Xy | j } | j | Wn t k
r} | j | n Xd S( NR% s {0}: error:i t strerrort filenameit :t t filec s@ s | ] } | t j k Vq d S( N( Rw t argv( RJ Rj ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pys <genexpr>" s s --debugs
--debuggeri ( s --debugs
--debugger( R t ExceptionR t ost patht basenameRw R RH t EnvironmentErrort getattrR t appendR R t printt joint stderrt lenR
R" RX t exitt maint print_resultt handle_cli_exception( R+ t cmdR' t
msg_prefixt err_bitst result( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt run
s. " " c C@ s
| j j S( N( R\ Rh ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR1 + s c C@ s d S( s}
The main processing method. main() is expected to do something with
self.args and return a result.
N( ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR / s c C@ s d S( sJ
Take a result produced by main() and print it to stdout.
N( ( R# t data( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR 6 s c C@ s; | j r t S| j r t St d d D r7 t St S( Nc s@ s | ] } | t j k Vq d S( N( Rw R ( RJ Rj ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pys <genexpr>B s s --debugs
--debugger( s --debugs
--debugger( t& _BaseCommand__config_enables_debuggingR R RX R ( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR3 < s c C@ sl d j t j j t j d } t | t r] | j r] | j r] | j
j t | n t | t
r | g } t | d d r | j | j n t | d d r | d c d 7<| j | j n t d j | d t j n^ t | j d k r0| j d r0t | | j d d t j n t | t | d t j | j r[ n t j d d S(
Ns {0}: error:i R R iR R R i ( R R R R Rw R RH R R R3 R R! R" R R R R R R R R R R R
R ( R# R' R R ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR G s" "" " c C@ sU | j d k r t S| j j d d k r/ t S| j j | j j d rQ t St S( NR3 R8 R9 ( s colors colour( R R R R; R t convert_to_bool( R# ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt __config_enables_debugging` s N( (! Rh t
__module__RN RM R RQ R[ R] R R R R R( t classmethodR. R R R R RS RT R^ R R R R t propertyR1 R R R3 R R ( ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR * s4 . ! c C@ s | t j k r t j d n t j t _ t j j r~ t j j r~ d t j k rn t
j | | | q t j | n t
j | t j d d S( s\
Launch epdb (or pdb if epdb is unavailable) when an uncaught exception
occurs.
i t epdbN( t bdbt BdbQuitRw R t __excepthook__Rx t stdoutt isattyt stdint modulesR t post_mortemt pdbt tracebackt print_tb( t type_t valuet tracebk( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyRv j s
c C@ sV i | d 6} | j | j | j | j t d j t j | d t j d S( s
Show a traceback and local variables when sent SIGUSR1. Note that
this could cause exceptions due to interrupted system calls.
t _frameR R N( R| t f_globalst f_localsR R R t format_stackRw R ( t _t framet
frame_dict( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyR{ } s
iF c @ s i d d 6d d 6d d 6d d 6d d 6 f d f d d f d
} | t d t j j t j d ;} t j | j j d
j
} g } g } d } x | D] } | j s| j | | d | | 2| j d d } q | } | } | rE| j | | d | | 2n, | | k rq| j | | d | | 2n | } | j | q W| r| j | | d | n xV t
t | d d d D]8 }
| |
| |
d k od k n r| |
=qqWd
j | S( s
Split lines into paragraphs based on blank lines and changes in
indentation level, rewrap the text in each of those paragraphs, and
yield each of those paragraphs. In paragraphs that start with
common shell prompt characters (#, $, and %) or bullets (* and -)
followed by whitespace, those characters do not count against the
paragraph's indentation level.
s \1 \2s
^(\s*)\#(\s+)s
^(\s*)\$(\s+)s
^(\s*)\%(\s+)s
^(\s*)\*(\s+)s
^(\s*)\-(\s+)c @ s\ | j s d Sx/ j D]! \ } } t j | | | } q Wt | t | j S( Ni( t stripR t ret subR t lstrip( t linet patternR ( t bullets( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt measure_margin s
c @ s1 x* D]" } | r t j | | r | Sq Wd S( N( R t match( R R ( R ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt find_bullet_pattern s
iF c @ s` | s
d S | d | d } | r t | d t | d j } | d | !} t j | | | d d | d <n t j d j d | D d | } | r d | | | d g g | d D] } d | ^ q } n! g | D] } d | ^ q} d j f d | D } | r\d | | | } n | S( NR i i s
c s@ s | ] } | j Vq d S( N( R ( RJ R ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pys <genexpr> s t widthR c 3@ s | ] } d | Vq d S( R N( ( RJ R ( t margin( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pys <genexpr> s ( R R R R t textwrapt wrapR ( t linesR R t firstline_margint bullet_textt rewrappedR t combined( R R R ( R s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt reformat_paragraph s$ $'
)! t progi s
R R ii ( t dictR R R Rw R R t dedentt rstripR t
splitlinesR R t xrangeR R ( t textR R t in_linest
paragraphst
current_linest current_marginR R R t i( ( R R R s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyRL sL
&$
#((& t
__future__R R RO R R/ t os.pathR R Ry Rw R R t warningsR t ImportErrorR R t requestbuilderR R t requestbuilder.configR R t requestbuilder.exceptionsR t requestbuilder.loggingR t requestbuilder.suiteR t requestbuilder.utilR R
t objectR Rv R{ RL ( ( ( s: /usr/lib/python2.7/site-packages/requestbuilder/command.pyt <module> s4
A