ó
|
[\¬Qc @ s¥ d Z d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z m Z m
|
Z
|
m Z m Z d d l m Z d f d YZ d e f d
|
YZ d S( st distutils.cmd
|
|
Provides the Command class, the base class for the command classes
|
in the distutils.command package.
|
s $Id$iÿÿÿÿN( t DistutilsOptionError( t utilt dir_utilt file_utilt archive_utilt dep_util( t logt Commandc B sy e Z d Z g Z d Z d Z d Z d Z d Z d# d d Z
|
d Z d d
|
Z d Z d# d Z d# d Z d Z d# d Z d Z d Z d Z d Z d d Z d d Z d Z d Z d Z d# d d Z d d Z d d d# d d Z d d d d d Z d d Z d d d Z d# d# d# d# d! Z! d# d# d d" Z" RS($ s} Abstract base class for defining command classes, the "worker bees"
|
of the Distutils. A useful analogy for command classes is to think of
|
them as subroutines with local variables called "options". The options
|
are "declared" in 'initialize_options()' and "defined" (given their
|
final values, aka "finalized") in 'finalize_options()', both of which
|
must be defined by every command class. The distinction between the
|
two is necessary because option values might come from the outside
|
world (command line, config file, ...), and any options dependent on
|
other options must be computed *after* these outside influences have
|
been processed -- hence 'finalize_options()'. The "body" of the
|
subroutine, where it does all its work based on the values of its
|
options, is the 'run()' method, which must also be implemented by every
|
command class.
|
c C s d d l m } t | | s+ t d n | j t k rF t d n | | _ | j d | _
|
| j | _ d | _ d | _ d | _ d S( sÞ Create and initialize a new Command object. Most importantly,
|
invokes the 'initialize_options()' method, which is the real
|
initializer and depends on the actual command being
|
instantiated.
|
iÿÿÿÿ( t Distributions$ dist must be a Distribution instances Command is an abstract classi N( t distutils.distR t
|
isinstancet TypeErrort __class__R t RuntimeErrort distributiont initialize_optionst Nonet _dry_runt verboset forcet helpt finalized( t selft distR ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt __init__1 s
|
|
c C sO | d k rB t | d | } | d k r; t | j | S| Sn t | d S( Nt dry_runt _( t getattrR R t AttributeError( R t attrt myval( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt __getattr__a s c C s# | j s | j n d | _ d S( Ni ( R t finalize_options( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt ensure_finalizedk s c C s t d | j d S( sÙ Set default values for all the options that this command
|
supports. Note that these defaults may be overridden by other
|
commands, by the setup script, by config files, or by the
|
command-line. Thus, this is not the place to code dependencies
|
between options; generally, 'initialize_options()' implementations
|
are just a bunch of "self.foo = None" assignments.
|
|
This method must be implemented by all command classes.
|
s, abstract method -- subclass %s must overrideN( R R ( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR } s
|
c C s t d | j d S( s Set final values for all the options that this command supports.
|
This is always called as late as possible, ie. after any option
|
assignments from the command-line or from other commands have been
|
done. Thus, this is the place to code option dependencies: if
|
'foo' depends on 'bar', then it is safe to set 'foo' from 'bar' as
|
long as 'foo' still has the same value it was assigned in
|
'initialize_options()'.
|
|
This method must be implemented by all command classes.
|
s, abstract method -- subclass %s must overrideN( R R ( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR s t c C sÓ d d l m } | d k r/ d | j } n | j | | d t j | d } xy | j D]n \ } } } | j | } | d d k r | d } n t | | } | j | d | | f d t j q] Wd S( Niÿÿÿÿ( t longopt_xlates command options for '%s':t levels t =s %s = %s(
|
t distutils.fancy_getoptR# R t get_command_namet announceR t INFOt user_optionst translateR ( R t headert indentR# t optionR t value( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt dump_options s
|
c C s t d | j d S( s¾ A command's raison d'etre: carry out the action it exists to
|
perform, controlled by the options initialized in
|
'initialize_options()', customized by other commands, the setup
|
script, the command-line, and config files, and finalized in
|
'finalize_options()'. All terminal output and filesystem
|
interaction should be done by 'run()'.
|
|
This method must be implemented by all command classes.
|
s, abstract method -- subclass %s must overrideN( R R ( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt run§ s
|
i c C s t j | | d S( sm If the current verbosity level is of greater than or equal to
|
'level' print 'msg' to stdout.
|
N( R ( R t msgR$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR( ´ s c C s/ d d l m } | r+ | GHt j j n d S( s~ Print 'msg' to stdout if the global DEBUG (taken from the
|
DISTUTILS_DEBUG environment variable) flag is true.
|
iÿÿÿÿ( t DEBUGN( t distutils.debugR3 t syst stdoutt flush( R R2 R3 ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt debug_printº s c C s[ t | | } | d k r/ t | | | | St | t sW t d | | | f n | S( Ns '%s' must be a %s (got `%s`)( R R t setattrR
|
t strR ( R R. t whatt defaultt val( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt _ensure_stringlikeÑ s c C s | j | d | d S( sW Ensure that 'option' is a string; if not defined, set it to
|
'default'.
|
t stringN( R> ( R R. R< ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt ensure_stringÛ s c C sµ t | | } | d k r d St | t rM t | | t j d | nd t | t r d } x0 | D] } t | t si d } Pqi qi Wn d } | s± t d | | f n d S( sî Ensure that 'option' is a list of strings. If 'option' is
|
currently a string, we split it either on /,\s*/ or /\s+/, so
|
"foo bar baz", "foo,bar,baz", and "foo, bar baz" all become
|
["foo", "bar", "baz"].
|
Ns ,\s*|\s+i i s' '%s' must be a list of strings (got %r)( R R R
|
R: R9 t ret splitt listR ( R R. R= t okt element( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt ensure_string_listá s c C sL | j | | | } | d k rH | | rH t d | | | f n d S( Ns error in '%s' option: ( R> R R ( R R. t testerR; t error_fmtR< R= ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt _ensure_tested_stringý s c C s | j | t j j d d d S( s5 Ensure that 'option' is the name of an existing file.t filenames$ '%s' does not exist or is not a fileN( RI t ost patht isfile( R R. ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt ensure_filename s c C s | j | t j j d d d S( Ns directory names) '%s' does not exist or is not a directory( RI RK RL t isdir( R R. ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt ensure_dirname
|
s c C s$ t | d r | j S| j j Sd S( Nt command_name( t hasattrRQ R t __name__( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR' s c G sh | j j | } | j xE | D]= \ } } t | | d k r# t | | t | | q# q# Wd S( s> Set the values of any "undefined" options from corresponding
|
option values in some other command object. "Undefined" here means
|
"is None", which is the convention used to indicate that an option
|
has not been changed between 'initialize_options()' and
|
'finalize_options()'. Usually called from 'finalize_options()' for
|
options that depend on some other command rather than another
|
option of the same command. 'src_cmd' is the other command from
|
which option values will be taken (a command object will be created
|
for it if necessary); the remaining arguments are
|
'(src_option,dst_option)' tuples which mean "take the value of
|
'src_option' in the 'src_cmd' command object, and copy it to
|
'dst_option' in the current command object".
|
N( R t get_command_objR! R R R9 ( R t src_cmdt option_pairst src_cmd_objt
|
src_optiont
|
dst_option( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt set_undefined_options s
|
c C s# | j j | | } | j | S( sû Wrapper around Distribution's 'get_command_obj()' method: find
|
(create if necessary and 'create' is true) the command object for
|
'command', call its 'ensure_finalized()' method, and return the
|
finalized command object.
|
( R RT R! ( R t commandt createt cmd_obj( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt get_finalized_command1 s
|
i c C s | j j | | S( N( R t reinitialize_command( R R[ t reinit_subcommands( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR_ = s c C s | j j | d S( s Run some other command: uses the 'run_command()' method of
|
Distribution, which creates and finalizes the command object if
|
necessary and then invokes its 'run()' method.
|
N( R t run_command( R R[ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRa A s c C sL g } x? | j D]4 \ } } | d k s4 | | r | j | q q W| S( sk Determine the sub-commands that are relevant in the current
|
distribution (ie., that need to be run). This is based on the
|
'sub_commands' class attribute: each tuple in that list may include
|
a method that we call to determine if the subcommand needs to be
|
run for the current distribution. Return a list of command names.
|
N( t sub_commandsR t append( R t commandst cmd_namet method( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt get_sub_commandsH s
|
c C s! t j d | j | f d S( Ns warning: %s: %s
|
( R t warnR' ( R R2 ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRh X s c C s t j | | | d | j d S( NR ( R t executeR ( R t funct argsR2 R$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRi \ s iÿ c C s t j | | d | j d S( NR ( R t mkpathR ( R t namet mode( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRl _ s c C s) t j | | | | | j | d | j S( sÑ Copy a file respecting verbose, dry-run and force flags. (The
|
former two default to whatever is in the Distribution object, and
|
the latter defaults to false for commands that don't define it.)R ( R t copy_fileR R ( R t infilet outfilet preserve_modet preserve_timest linkR$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRo b s c C s) t j | | | | | | j d | j S( s\ Copy an entire directory tree respecting verbose, dry-run,
|
and force flags.
|
R ( R t copy_treeR R ( R Rp Rq Rr Rs t preserve_symlinksR$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRu o s
|
|
c C s t j | | d | j S( s$ Move a file respecting dry-run flag.R ( R t move_fileR ( R t srct dstR$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRw { s c C s* d d l m } | | | d | j d S( s2 Spawn an external command respecting dry-run flag.iÿÿÿÿ( t spawnR N( t distutils.spawnRz R ( R t cmdt search_pathR$ Rz ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyRz s c C s+ t j | | | | d | j d | d | S( NR t ownert group( R t make_archiveR ( R t base_namet formatt root_dirt base_dirR~ R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR s c C s | d k r d | } n t | t r4 | f } n! t | t t f sU t d n | d k r} d | d j | f } n | j s t j | | r± | j
|
| | | | n t j | d S( sÌ Special case of 'execute()' for operations that process one or
|
more input files and generate one output file. Works just like
|
'execute()', except the operation is skipped and a different
|
message printed if 'outfile' already exists and is newer than all
|
files listed in 'infiles'. If the command defined 'self.force',
|
and it is true, then the command is unconditionally run -- does no
|
timestamp checks.
|
s skipping %s (inputs unchanged)s9 'infiles' must be a string, or a list or tuple of stringss generating %s from %ss , N( R R
|
R: RC t tupleR t joinR R t newer_groupRi R t debug( R t infilesRq Rj Rk t exec_msgt skip_msgR$ ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt make_file s
|
N(# RS t
|
__module__t __doc__Rb R R R! R R R R0 R1 R( R8 R> R@ RF RI RN RP R' RZ R^ R_ Ra Rg Rh Ri Rl Ro Ru Rw Rz R R ( ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR sD 0
|
|
|
t install_miscc B s; e Z d Z d g Z d Z d Z d Z d Z RS( s{ Common base class for installing some files in a subdirectory.
|
Currently used by install_data and install_scripts.
|
s install-dir=t ds! directory to install the files toc C s d | _ g | _ d S( N( R t install_dirt outfiles( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR ¸ s c C s | j d | d f d S( Nt installR ( RZ ( R t dirname( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt _install_dir_from¼ s c C sm g | _ | s d S| j | j xC | D]; } | j | | j | j j t j j | j | q* Wd S( N( R Rl R Ro Rc RK RL R ( R t filelistt f( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt _copy_files¿ s c C s | j S( N( R ( R ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt get_outputsÈ s ( s install-dir=R s! directory to install the files to( RS R R R* R R R R ( ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyR ± s ( R t __revision__R5 RK RA t distutils.errorsR t distutilsR R R R R R R R ( ( ( sU /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/distutils/cmd.pyt <module> s $(ÿ ¤
|
