| Server IP : 61.19.30.66 / Your IP : 216.73.216.15 Web Server : Apache/2.2.22 (Ubuntu) System : Linux klw 3.11.0-15-generic #25~precise1-Ubuntu SMP Thu Jan 30 17:39:31 UTC 2014 x86_64 User : www-data ( 33) PHP Version : 5.3.10-1ubuntu3.48 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority, MySQL : ON | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python2.7/dist-packages/twisted/python/ |
Upload File : |
ó
ˆV£Nc @ sÀ d Z d d l Z d d l Z d d l Z d d l m Z m Z m Z d „ Z d e j f d „ ƒ YZ
d e f d „ ƒ YZ d e f d
„ ƒ YZ
d e f d „ ƒ YZ d
„ Z d „ Z d S( sÐ
No public APIs are provided by this module. Internal use only.
This module implements dynamic tab-completion for any command that uses
twisted.python.usage. Currently, only zsh is supported. Bash support may
be added in the future.
Maintainer: Eric P. Mangold - twisted AT teratorn DOT org
In order for zsh completion to take place the shell must be able to find an
appropriate "stub" file ("completion function") that invokes this code and
displays the results to the user.
The stub used for Twisted commands is in the file C{twisted-completion.zsh},
which is also included in the official Zsh distribution at
C{Completion/Unix/Command/_twisted}. Use this file as a basis for completion
functions for your own commands. You should only need to change the first line
to something like C{#compdef mycommand}.
The main public documentation exists in the L{twisted.python.usage.Options}
docstring, the L{twisted.python.usage.Completions} docstring, and the
Options howto.
iÿÿÿÿN( t reflectt utilt usagec C s¶ | d j d ƒ \ } } t | ƒ } | d 8} | | } x5 | d k rp | | d j d ƒ rl | d 8} q< Pq< W| | } t | d d ƒ } | r–d } y% t j | | j | j ƒ \ } } Wn t j k
rÔ n X| rSxu | j D]g \ }
} } }
| d |
k s| d | k rå | ƒ } | | _
t | | | | ƒ } | j ƒ d Sqå Wn t
} | j d ƒ rqt } n t | | | ƒ } | j d | ƒ n t | | | ƒ } | j ƒ d S(
so
Perform shell completion.
A completion function (shell script) is generated for the requested
shell and written to C{shellCompFile}, typically C{stdout}. The result
is then eval'd by the shell to produce the desired completions.
@type config: L{twisted.python.usage.Options}
@param config: The L{twisted.python.usage.Options} instance to generate
completions for.
@type cmdName: C{str}
@param cmdName: The name of the command we're generating completions for.
In the case of zsh, this is used to print an appropriate
"#compdef $CMD" line at the top of the output. This is
not necessary for the functionality of the system, but it
helps in debugging, since the output we produce is properly
formed and may be saved in a file and used as a stand-alone
completion function.
@type words: C{list} of C{str}
@param words: The raw command-line words passed to use by the shell
stub function. argv[0] has already been stripped off.
@type shellCompFile: C{file}
@param shellCompFile: The file to write completion data to.
iÿÿÿÿt :i i t -t subCommandsi Nt genSubs( t splitt intt
startswitht getattrt Nonet getoptt shortOptt longOptt errorR t parentt ZshSubcommandBuildert writet Truet Falset
ZshBuilder( t configt cmdNamet wordst
shellCompFilet shellNamet positiont cWordR t argst optst cmdt shortt parsert doct
subOptionst genR ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt
shellComplete" sB
t SubcommandActionc B s e Z d „ Z RS( c C s* | t j k r d St d | f ƒ ‚ d S( Ns *::subcmd:->subcmds Unknown shellType %r( R t _ZSHt NotImplementedError( t selft optNamet shellType( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt
_shellCode‚ s ( t __name__t
__module__R, ( ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR& s R c B s# e Z d Z d „ Z e d „ Z RS( sµ
Constructs zsh code that will complete options for a given usage.Options
instance, possibly including a list of subcommand names.
Completions for options to subcommands won't be generated because this
class will never be used if the user is completing options for a specific
subcommand. (See L{ZshSubcommandBuilder} below)
@type options: L{twisted.python.usage.Options}
@ivar options: The L{twisted.python.usage.Options} instance defined for this
command.
@type cmdName: C{str}
@ivar cmdName: The name of the command we're generating completions for.
@type file: C{file}
@ivar file: The C{file} to write the completion function to.
c C s | | _ | | _ | | _ d S( N( t optionsR t file( R) R/ R R0 ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt __init__œ s c C sõ | rÌ t | j d d ƒ d k rÌ t | j | j | j ƒ } | j j d t ƒ ƒ | j ƒ | j j d ƒ x: | j j
D], \ } } } } | j j d | | f ƒ qy W| j j d ƒ | j j d ƒ n% t | j | j | j ƒ } | j ƒ d S( s—
Generate the completion function and write it to the output file
@return: C{None}
@type genSubs: C{bool}
@param genSubs: Flag indicating whether or not completions for the list
of subcommand should be generated. Only has an effect
if the C{subCommands} attribute has been defined on the
L{twisted.python.usage.Options} instance.
R i s. local _zsh_subcmds_array
_zsh_subcmds_array=(
s "%s:%s"
s )
s+ _describe "sub-command" _zsh_subcmds_array
N( R
R/ R t ZshArgumentsGeneratorR R0 t extraActionst insertR& R R ( R) R R$ R R R! t desc( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR ¢ s !
( R- R. t __doc__R1 R R ( ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR ‰ s R c B s e Z d Z d „ Z d „ Z RS( s‰
Constructs zsh code that will complete options for a given usage.Options
instance, and also for a single sub-command. This will only be used in
the case where the user is completing options for a specific subcommand.
@type subOptions: L{twisted.python.usage.Options}
@ivar subOptions: The L{twisted.python.usage.Options} instance defined for
the sub command.
c G s | | _ t j | | Œ d S( N( R# R R1 ( R) R# R ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR1 Æ s c C sd t | j | j | j ƒ } | j j d t ƒ ƒ | j ƒ t | j | j | j ƒ } | j ƒ d S( sk
Generate the completion function and write it to the output file
@return: C{None}
i N( R2 R/ R R0 R3 R4 R& R R# ( R) R$ ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR Ë s
( R- R. R6 R1 R ( ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR ¼ s R2 c B s e Z d Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z e
d „ Z d „ Z d
„ Z
d „ Z d „ Z d
„ Z d „ Z RS( s£
Generate a call to the zsh _arguments completion function
based on data in a usage.Options instance
@type options: L{twisted.python.usage.Options}
@ivar options: The L{twisted.python.usage.Options} instance to generate for
@type cmdName: C{str}
@ivar cmdName: The name of the command we're generating completions for.
@type file: C{file}
@ivar file: The C{file} to write the completion function to
The following non-constructor variables are populated by this class
with data gathered from the C{Options} instance passed in, and its
base classes.
@type descriptions: C{dict}
@ivar descriptions: A dict mapping long option names to alternate
descriptions. When this variable is defined, the descriptions
contained here will override those descriptions provided in the
optFlags and optParameters variables.
@type multiUse: C{list}
@ivar multiUse: An iterable containing those long option names which may
appear on the command line more than once. By default, options will
only be completed one time.
@type mutuallyExclusive: C{list} of C{tuple}
@ivar mutuallyExclusive: A sequence of sequences, with each sub-sequence
containing those long option names that are mutually exclusive. That is,
those options that cannot appear on the command line together.
@type optActions: C{dict}
@ivar optActions: A dict mapping long option names to shell "actions".
These actions define what may be completed as the argument to the
given option, and should be given as instances of
L{twisted.python.usage.Completer}.
Callables may instead be given for the values in this dict. The
callable should accept no arguments, and return a C{Completer}
instance used as the action.
@type extraActions: C{list} of C{twisted.python.usage.Completer}
@ivar extraActions: Extra arguments are those arguments typically
appearing at the end of the command-line, which are not associated
with any particular named option. That is, the arguments that are
given to the parseArgs() method of your usage.Options subclass.
c C s‡ | | _ | | _ | | _ i | _ t ƒ | _ g | _ i | _ g | _ xŸ t t
j | j ƒ ƒ D]… } t
| d d ƒ } | rd | j j | j ƒ | j j | j ƒ | j j | j ƒ | j j | j ƒ | j ré | j | _ qé qd qd Wt j } t j } g } g } | | j d | ƒ | | j d | ƒ xE t | ƒ D]7 \ }
} t | ƒ d k r>t j d | ƒ | |
<q>q>WxE t | ƒ D]7 \ }
} t | ƒ d k r†t j d | ƒ | |
<q†q†W| | _ | | _ i } x | D] } | d | | d <qàW| | _ i }
x | D] } | d |
| d <qW|
| _ i } | j | ƒ | j |
ƒ | | _ | j ƒ | j ƒ | j ƒ | _ d S( Nt compDatat optFlagst
optParametersi i i i (! R/ R R0 t descriptionst sett multiUset mutuallyExclusivet
optActionsR3 t reversedt inspectt getmrot __class__R
R t updatet extendR t accumulateClassListt accumulateClassDictt enumeratet lenR t padToR8 t optParamst paramNameToDefinitiont flagNameToDefinitiont allOptionsNameToDefinitiont addAdditionalOptionst verifyZshNamest makeExcludesDictt excludes( R) R/ R R0 t clst datat aCLt aCDR8 RJ t it optListRK RL RM ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR1 s\
c C s, | j ƒ | j ƒ | j ƒ | j ƒ d S( sf
Write the zsh completion code to the file given to __init__
@return: C{None}
N( t writeHeadert writeExtrast writeOptionst writeFooter( R) ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR R s
c C s | j j d | j f ƒ d S( s^
This is the start of the code that calls _arguments
@return: C{None}
s% #compdef %s
_arguments -s -A "-*" \
N( R0 R R ( R) ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRX ] s c C s; | j j ƒ } | j ƒ x | D] } | j | ƒ q Wd S( s]
Write out zsh code for each option in this command
@return: C{None}
N( RM t keyst sortt writeOpt( R) t optNamest longname( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRZ f s
c C s¥ xž t | j ƒ D] \ } } d } | j r7 | j } n | j rh | t | j ƒ d k rh t d ƒ ‚ n | j j t | j d t
j ƒ ƒ ƒ | j j d ƒ q Wd S( s©
Write out completion information for extra arguments appearing on the
command-line. These are extra positional arguments not associated
with a named option. That is, the stuff that gets passed to
Options.parseArgs().
@return: C{None}
@raises: ValueError: if C{Completer} with C{repeat=True} is found and
is not the last item in the C{extraActions} list.
t i sD Completer with repeat=True must be last item in Options.extraActionss \
N( RG R3 t _descrt _repeatRH t
ValueErrorR0 R t escapeR, R R' ( R) RV t actiont descr( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRY q s "%c C s | j j d ƒ d S( sj
Write the last bit of code that finishes the call to _arguments
@return: C{None}
s && return 0
N( R0 R ( R) ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR[ ‰ s c s™ ‡ f d † } xB t j ˆ j ˆ j ˆ j ƒ D]" } | ˆ j k r. | | ƒ q. q. Wx> ˆ j D]3 } x* | D]" } | ˆ j k rk | | ƒ qk qk Wq^ Wd S( s»
Ensure that none of the option names given in the metadata are typoed
@return: C{None}
@raise ValueError: Raised if unknown option names have been found.
c s t d | ˆ j f ƒ ‚ d S( NsJ Unknown option name "%s" found while
examining Completions instances on %s( Rd R/ ( t name( R) ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt err— s N( t itertoolst chainR: R> R< RM R= ( R) Ri Rh t seq( ( R) s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRO ‘ s
c C sú | | j k r% | j | j ƒ } n t ƒ } | | j k r‡ | t k rw | j | ƒ } | d k r„ | j | ƒ q„ q‡ | j | ƒ n | s‘ d Sg } xE | D]= } t | ƒ d k rÊ | j d | ƒ qž | j d | ƒ qž W| j
ƒ d d j | ƒ S( sœ
Generate an "exclusion string" for the given option
@type longname: C{str}
@param longname: The long option name (e.g. "verbose" instead of "v")
@type buildShort: C{bool}
@param buildShort: May be True to indicate we're building an excludes
string for the short option that correspondes to the given long opt.
@return: The generated C{str}
Ra i R s --s (%s)t N( RQ t copyR; R< R t getShortOptionR t addRH t appendR] t join( R) R` t
buildShortt
exclusionsR t stringsR* ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt
excludeStr§ s$
c C s i } xE t j | j | j ƒ D]+ } | d d k r | d | | d <q q Wi } x± | j D]¦ } x t | ƒ D] \ } } t | | | | d ƒ } x4 | j ƒ D]& } | | k r¦ | j | | ƒ q¦ q¦ W| | k rö | | j
| ƒ | | <qq | | | <qq Wq^ W| S( sã
@return: A C{dict} that maps each option name appearing in
self.mutuallyExclusive to a list of those option names that is it
mutually exclusive with (can't appear on the cmd line with).
i i N( Rj Rk RJ R8 R R= RG R; Rn Rp t union( R) t longToShortRW RQ t lstRV R` t tmpRh ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRP Ò s c C sa | | j k r d | } n
d | } | j | ƒ } | d k rN d | } n d } | j | ƒ } | j d d ƒ } | j d d ƒ } d | } | j | ƒ } | | j k r¸ d
} n d } | j | ƒ } | r$| j | d t ƒ}
| j j
t d |
| | | | f ƒ ƒ | j j
d
ƒ n | j j
t d | | | | | f ƒ ƒ | j j
d
ƒ d S( s
Write out the zsh code for the given argument. This is just part of the
one big call to _arguments
@type longname: C{str}
@param longname: The long option name (e.g. "verbose" instead of "v")
@return: C{None}
s --%ss --%s=R Ra t [s \[t ]s \]s [%s]t *Rs s
%s%s%s%s%ss \
N( RL Ro R t getDescriptiont replacet getActionR< Rv R R0 R Re ( R) R` t longFieldR t
shortFieldRg t descriptionFieldt actionFieldt
multiFieldt longExclusionsFieldt shortExclusionsField( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR^ î s0
c C ss | | j k rU t | j | ƒ r5 | j | ƒ } n
| j | } | j | t j ƒ S| | j k ro d | f Sd S( s]
Return a zsh "action" string for the given argument
@return: C{str}
s
:%s:_filesRa ( R> t callableR, R R' RK ( R) R` Rf ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR€ s
c C sÜ | | j k r | j | Sy | j | d } Wn@ t k
rq y | j | d } Wqr t k
rm d } qr Xn X| d k r‚ | S| j d d ƒ } t | j d | d ƒ } | d k rØ t | ƒ } | d k rØ | Sn | S( s]
Return the description to be used for this argument
@return: C{str}
i i R t _s opt_%sN( R: RL t KeyErrorRK R R R
R/ t descrFromDoc( R) R` Rg t longMangledt obj( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR~ . s$
c C s | j | } | d p d S( s[
Return the short option letter or None
@return: C{str} or C{None}
i N( RM R ( R) R` RW ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRo N s
c
C s i } t j | j | d ƒ i } x> | j ƒ D]0 } t | ƒ d k r/ | | | | <| | =q/ q/ Wx| j ƒ D] \ } } | j d d ƒ } | | j k r£ qp n | j | ƒ } d } | | k rÑ | | } n | j
j j } | d k r7| j
j | | d | g ƒ | d | g | j | <| d | g | j | <qp | j j | | | g ƒ | | g | j | <| d | g | j | <qp Wd S( s±
Add additional options to the optFlags and optParams lists.
These will be defined by 'opt_foo' methods of the Options subclass
@return: C{None}
t opt_i R‰ R i N( R t accumulateMethodsR/ Rn RH t itemsR RM R~ R t im_funct func_codet co_argcountRJ Rq RK R8 RL (
R) t methodsDictt
methodToShortRh t
methodNamet methodObjR` Rg R t reqArgs( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRN W s.
( R- R. R6 R1 R RX RZ RY R[ RO R Rv RP R^ R€ R~ Ro RN ( ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR2 Ù s 1 G + / c C sm | j d k s | j j ƒ r" d Sg | j j d ƒ D]% } | r5 | j ƒ r5 | j ƒ ^ q5 } d j | ƒ S( sP
Generate an appropriate description from docstring of the given object
s
Rm N( R6 R t isspaceR t stripRr ( R t xt lines( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyR‹ € s
%c C s` d | k r d | d Sd } x1 | D]) } | d k rD | d } n | | } q% W| d } | S( sw
Shell escape the given string
Implementation borrowed from now-deprecated commands.mkarg() in the stdlib
s 't "s \$"`s \( ( R› t st c( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyRe s
( R6 Rj R R@ t twisted.pythonR R R R% t CompleterR& t objectR R R2 R‹ Re ( ( ( s= /usr/lib/python2.7/dist-packages/twisted/python/_shellcomp.pyt <module> s $ _3 ÿ ¨