File: //proc/3/root/proc/2/task/2/root/proc/self/root/usr/lib/python2.4/distutils/dist.pyc
m
=5Dc @ s d Z d Z d k Z d k Z d k Z d k Z d k Td k l Z y
d k Z Wn e j
o
e
Z n Xd k Td k l
Z
l Z d k l Z l Z l Z d k l Z d k l Z e i d Z d
f d YZ d f d
YZ d Z e d j o e Z d GHn d S( s} distutils.dist
Provides the Distribution class, which represents the module distribution
being built/installed/distributed.
s0 $Id: dist.py 37828 2004-11-10 22:23:15Z loewis $N( t *( s copy( s FancyGetopts translate_longopt( s
check_environs strtobools
rfc822_escape( s log( s DEBUGs ^[a-zA-Z]([a-zA-Z0-9_]*)$t Distributionc B sH t Z d Z dT dU dV dW g Z d e d f d e d f dX d e d f d e d f d e d f d e d f d e d f d e d f d! e d" f d# e d$ f d% e d& f d' e d( f d) e d* f d+ e d, f d- e d. f d/ e d0 f d1 e d2 f g Z e d3 e Z h d d <Z e d4 Z d5 Z
e e d6 d7 Z d8 Z e d9 Z
d: Z d; Z d< Z d= Z d d g d> Z d? Z d@ Z dA Z dB Z dC Z dD Z d dE Z e dF Z dG dH Z d dI Z dJ Z dK Z dL Z dM Z dN Z! dO Z" dP Z# dQ Z$ dR Z% dS Z& RS(Y s The core of the Distutils. Most of the work hiding behind 'setup'
is really done within a Distribution instance, which farms the work out
to the Distutils commands specified on the command line.
Setup scripts will almost never instantiate Distribution directly,
unless the 'setup()' function is totally inadequate to their needs.
However, it is conceivable that a setup script might wish to subclass
Distribution for some specialized purpose, and then pass the subclass
to 'setup()' as the 'distclass' keyword argument. If so, it is
necessary to respect the expectations that 'setup' has of Distribution.
See the code for 'setup()', in core.py, for details.
t verboset vs run verbosely (default)i t quiett qs! run quietly (turns verbosity off)s dry-runt ns don't actually do anythingt helpt hs show detailed help messages
help-commandss list all available commandst names print package namet versiont Vs print package versiont fullnames print <package name>-<version>t authors print the author's names author-emails print the author's email addresst
maintainers print the maintainer's names maintainer-emails$ print the maintainer's email addresst contacts7 print the maintainer's name if known, else the author'ss
contact-emails@ print the maintainer's email address if known, else the author'st urls print the URL for this packaget licenses print the license of the packaget licences alias for --licenset descriptions print the package descriptions long-descriptions" print the long package descriptiont platformss print the list of platformst classifierss print the list of classifierst keywordss print the list of keywordsc C s t | d S( Ni ( t translate_longoptt x( R ( ( t$ /usr/lib/python2.4/distutils/dist.pyt <lambda>e s c
C s d | _ d | _ d | _ x! | i D] } t | | d q% Wt | _ x: | i i D], } d | } t | | t | i | qX Wh | _
d | _ d | _ d | _ h | _ d | _ h | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ h | _ h | _ | o| i" d } | od | d =xZ | i$ D]H \ }
} | i' |
} x* | i$ D] \ } } d | f | | <qWqdWn | i+ d oQ | d | d <| d =d } t- d j o t- i. | qt/ i0 i1 | d n x | i$ D] \ } } t3 | i | o t | i | | q"t3 | | o t | | | q"d
t4 | } t- d j o t- i. | q"t/ i0 i1 | d q"Wn | i5 d S( s0 Construct a new Distribution instance: initialize all the
attributes of a Distribution, and then use 'attrs' (a dictionary
mapping attribute names to values) to assign some of those
attributes their "real" values. (Any attributes not mentioned in
'attrs' will be assigned to some null value: 0, None, an empty list
or dictionary, etc.) Most importantly, initialize the
'command_obj' attribute to the empty dictionary; this will be
filled in with real command objects by 'parse_command_line()'.
i i t get_t optionss setup scriptR R s: 'licence' distribution option is deprecated; use 'license's
s Unknown distribution option: %sN(6 t selfR t dry_runR t display_option_namest attrt setattrt DistributionMetadatat metadatat _METHOD_BASENAMESt basenamet method_namet getattrt cmdclasst Nonet command_packagest script_namet script_argst command_optionst packagest package_datat package_dirt
py_modulest librariest headerst ext_modulest ext_packaget include_dirst
extra_patht scriptst
data_filest command_objt have_runt attrst getR t itemst commandt cmd_optionst get_option_dictt opt_dictt optt valt has_keyt msgt warningst warnt syst stderrt writet keyt hasattrt reprt finalize_options(
R R< RC R RB R% R@ R R& RD R? RL RF ( ( R t __init__n sv
c C s8 | i i | } | d j o h } | i | <n | S( s Get the option dictionary for a given command. If that
command's option dictionary hasn't been created yet, then create it
and return the new dictionary; otherwise, return the existing
option dictionary.
N( R R- R= R? t dictR) ( R R? RQ ( ( R RA s
t c C s d k l } | d j o | i i } | i n | d j o | | GH| d } n | p | d GHd Sn x | D]y } | i i | } | d j o | d | GHqz | d | GH| | } x' t i | d D] } | d | GHq Wqz Wd S( N( s pformats s no commands known yets no option dict for '%s' commands option dict for '%s' command:s
( t pprintt pformatt commandsR) R R- t keyst sortt headert indentt cmd_nameR= RB t outt stringt splitt line( R RX RU RY R^ RT RZ RB R[ ( ( R t dump_option_dicts s(
c C s g } t t i i t i d i } t i i | d } t i i | o | i | n t i
d j o
d } n d } t i i d oI t i i t i i d | } t i i | o | i | q n d } t i i | o | i | n | S( sX Find as many configuration files as should be processed for this
platform, and return a list of filenames in the order in which they
should be parsed. The filenames returned are guaranteed to exist
(modulo nasty race conditions).
There are three possible config files: distutils.cfg in the
Distutils installation directory (ie. where the top-level
Distutils __inst__.py file lives), a file in the user's home
directory named .pydistutils.cfg on Unix and pydistutils.cfg
on Windows/Mac, and setup.cfg in the current directory.
t distutilss
distutils.cfgt posixs .pydistutils.cfgs pydistutils.cfgt HOMEs setup.cfgN( t filest
check_environt ost patht dirnameRI t modulest __file__t sys_dirt joint sys_filet isfilet appendR t
user_filenamet environRE R= t user_filet
local_file( R Rc Rr Rq Rj Rl Ro ( ( R t find_config_files! s$
!c
C s d k l } | d j o | i } n t o d GHn | } x | D] }
t o
d G|
GHn | i |
x | i D]} } | i | } | i | } xV | D]N } | d j o; | i | | } t i | d d } |
| f | | <q q Wq~ W| i qJ W| i i d o x | i d i D] \ } \ } } | i i | } y] | o t | | t | n8 | d
j o t | | t | n t | | | Wq4t j
o } t | q4Xq4Wn d S( N( s ConfigParsers" Distribution.parse_config_files():s readingt __name__t -t _t globalR R ( s verboses dry_run( t ConfigParsert filenamesR) R Rs t DEBUGt parsert filenamet readt sectionst sectionR RA RB RC R= RD R\ t replaceRP R- RE R> t srct negative_optt aliasR! t strtoboolt
ValueErrorRF t DistutilsOptionError(
R Ry RC R RD RB R{ R R RF R| R Rx ( ( R t parse_config_filesN sD
c C sp | i } t i d j o5 d k } | i } | i | | i | | _
n g | _ t | | i } | i | i | i h d d < | i d | i
d | } | i } t i | i | i | o d Sn x3 | o+ | i | | } | d j o d Sq q W| i o3 | i | d t | i d j d | i d Sn | i p
t d
n d S( s Parse the setup script's command line, taken from the
'script_args' instance attribute (which defaults to 'sys.argv[1:]'
-- see 'setup()' in core.py). This list is first processed for
"global options" -- options that set attributes of the Distribution
instance. Then, it is alternately scanned for Distutils commands
and options for that command. Each new command terminates the
options for the previous command. The allowed options for a
command are determined by the 'user_options' attribute of the
command class -- thus, we have to be able to load command classes
in order to parse the command line. Any error in that 'options'
attribute raises DistutilsGetoptError; any error on the
command-line raises DistutilsArgError. If no Distutils commands
were found on the command line, raises DistutilsArgError. Return
true if command-line was successfully parsed and we should carry
on with executing commands; false if no errors but we shouldn't
execute commands (currently, this only happens if user asks for
help).
t macNR R t argst objectt display_optionsi RU s no commands suppliedi ( R t _get_toplevel_optionst toplevel_optionsRI t platformt EasyDialogst get_command_listt cmdlistt GetArgvR R, RU t FancyGetoptR{ t set_negative_aliasesR t set_aliasest getoptR t get_option_ordert option_ordert logt
set_verbosityR t handle_display_optionst _parse_command_optsR) R t
_show_helpt lent DistutilsArgError( R R R R{ R R R ( ( R t parse_command_line~ s8
c C s | i d g S( s Return the non-display options recognized at the top level.
This includes options that are recognized *only* at the top
level as well as options recognized for commands.
s command-packages=s0 list of packages that provide distutils commandsN( s command-packages=Ns0 list of packages that provide distutils commands( R t global_optionsR) ( R ( ( R R s c C s d k l } | d } t i | p t d | n | i i | y | i
| } Wn t j
o } t | n Xt | | p t d | n t | d o t | i t j p t d d | n | i } t | d o t | } | i | i n t | d o) t | i t j o t | i } n g } | i | i | i | | i | | i | d
\ } } t | d o. | i o$ | i! | d d d
| g d Sn t | d o t | i t j o d } xn | i D]c \ } }
} }
t | | i' | o8 d
} t( |
o |
qht d |
| f qqW| o d Sqn | i) | } x0 t+ | i, D] \ } } d | f | | <qW| S( s Parse the command-line options for a single command.
'parser' must be a FancyGetopt instance; 'args' must be the list
of arguments, starting with the current command (whose options
we are about to parse). Returns a new version of 'args' with
the next command at the front of the list; will be the empty
list if there are no more commands on the command line. Returns
None if the user asked for help on this command.
( s Commandi s invalid command name '%s's& command class %s must subclass Commandt user_optionss command class %s must provide s+ 'user_options' attribute (a list of tuples)R t help_optionsi R R RU NsY invalid help function %r for help option '%s': must be a callable object (function, etc.)s command line(/ t
distutils.cmdt CommandR R? t
command_ret matcht
SystemExitR RU Rn t get_command_classt cmd_classt DistutilsModuleErrorRF R t
issubclasst DistutilsClassErrorRM t typeR t ListTypeR t copyt updateR t fix_help_optionsR{ t set_option_tableR R R t optsR R t help_option_foundt help_optiont shortt desct funct
get_attr_namet callableRA RB t varsR> R t value( R R{ R R R R RF R R R R R R R R R? RB R ( ( R R sV
& &
&
c C s | i i } | d j oE t | t j o. t i | d } t t i
| | i _ q^ n | i i } | d j oE t | t j o. t i | d } t t i
| | i _ q n d S( s Set final values for all the options on the Distribution
instance, analogous to the .finalize_options() method of Command
objects.
t ,N(
R R# R R) R t
StringTypeR\ R] t keywordlistt mapt stripR t platformlist( R R R R R ( ( R RO 6 s
c
C s[ d k l } d k l } | o? | o | i } n
| i } | i
| | i d Hn | o& | i
| i | i d d Hn x | i D] } t | t j o t | | o
| } n | i | } t | d o7 t | i t j o! | i
| i t | i n | i
| i | i d | i Hq W| | i GHd S( sb Show help for the setup script command-line in the form of
several lists of command-line options. 'parser' should be a
FancyGetopt instance; do not expect it to be returned in the
same state, as its option table will be reset to make it
generate the correct help text.
If 'global_options' is true, lists the global options:
--verbose, --dry-run, etc. If 'display_options' is true, lists
the "display-only" options: --name, --version, etc. Finally,
lists per-command help for every command name or command class
in 'commands'.
( s gen_usage( s Commands Global options:s* Information display options (just display s! information, ignore any commands)R s Options for '%s' command:N( t distutils.coret gen_usageR R R R R R R R{ R t
print_helpRU R? R t ClassTypeR t klassR RM R R R R Rt R+ (
R R{ R R RU R R R? R R ( ( R R H s4
#
&!c C s d k l } | i o! | i H| | i GHd Sn d } h } x | i D] } d | | d <qN Wx | D] \ } } | o | i
| o~ t | } t | i d | } | d d g j o t i | d GHn( | d j o t i | d GHn | GHd } qm qm W| S( s If there were any non-global "display-only" options
(--help-commands or the metadata display options) on the command
line, display the requested info and return true; else return
false.
( s gen_usagei i R R R R R s
N( R R R t
help_commandst print_commandsR+ t any_display_optionst is_display_optionR t optionR RC RD R= R R' R# R R\ Rk ( R R R RC R R RD R R ( ( R R s0
c C s | d GHxu | D]m } | i i | } | p | i | } n y
| i } Wn t j
o
d } n Xd | | | f GHq Wd S( sZ Print a subset of the list of all commands -- used by
'print_commands()'.
t :s (no description available)s
%-*s %sN( RX RU t cmdR R( R= R R R t AttributeErrort
max_length( R RU RX R R R R ( ( R t print_command_list s
c C s d k } | i i } h } x | D] } d | | <q" Wg } x8 | i i
D]' } | i | p | i | qL qL Wd } x5 | | D]) } t | | j o t | } q q W| i | d | | o H| i | d | n d S( sn Print out a help message listing all available commands with a
description of each. The list is divided into "standard commands"
(listed in distutils.command.__all__) and "extra commands"
(mentioned in self.cmdclass, but not a standard command). The
descriptions come from the command class attribute
'description'.
Ni i s Standard commandss Extra commands( t distutils.commandR` R? t __all__t std_commandst is_stdR t extra_commandsR R( RV R= Rn R R R ( R R` R R R R R ( ( R R s2 c C s d k } | i i } h } x | D] } d | | <q" Wg } x8 | i i
D]' } | i | p | i | qL qL Wg } xz | | D]n } | i i | } | p | i | } n y
| i } Wn t j
o
d } n X| i | | f q W| S( s> Get a list of (command, description) tuples.
The list is divided into "standard commands" (listed in
distutils.command.__all__) and "extra commands" (mentioned in
self.cmdclass, but not a standard command). The descriptions come
from the command class attribute 'description'.
Ni s (no description available)( R R` R? R R R R R R R( RV R= Rn t rvR R R R ( R R R R` R R R R R ( ( R R s0
c C s | i } t | t g p t i | p d d } x1 t t | D] } t i
| | | | <qK Wt d | } d | j o | i
d d n | | _ n | S( s9 Return a list of packages from which commands are loaded.RR R s distutils.commandi N( R R* t pkgst
isinstanceR R\ R] t rangeR t iR t filterR) t insert( R R R ( ( R t get_command_packages s
c C s | i i | } | o | Sn x | i D] } d | | f } | } y t | t
i | } Wn t
j
o
q. n Xy t | | } Wn) t j
o t d | | | f n X| | i | <| Sq. Wt d | d S( so Return the class that implements the Distutils command named by
'command'. First we check the 'cmdclass' dictionary; if the
command is mentioned there, we fetch the class object from the
dictionary and return it. Otherwise we load the command module
("distutils.command." + command) and fetch the command class from
the module. The loaded class is also stored in 'cmdclass'
to speed future calls to 'get_command_class()'.
Raises DistutilsModuleError if the expected module could not be
found, or if that module does not define the expected class.
s %s.%ss3 invalid command '%s' (no class '%s' in module '%s')s invalid command '%s'N( R R( R= R? R R t pkgnamet module_namet
klass_namet
__import__RI Rh t modulet ImportErrorR' R R ( R R? R R R R R ( ( R R s(
c C s | i i | } | o | ox t o
d | GHn | i | } | | } | i | <d | i | <| i
i | } | o | i | | q n | S( s Return the command object for 'command'. Normally this object
is cached on a previous call to 'get_command_obj()'; if no command
object for 'command' is in the cache, then we either create and
return it (if 'create' is true) or return None.
s< Distribution.get_command_obj(): creating '%s' command objecti N(
R R: R= R? t cmd_objt createRz R R R; R- R t _set_command_options( R R? R R R R ( ( R t get_command_obj< s
c C s | i } | d j o | i | } n t o
d | GHn xm| i D]_\ } \ } } t o d | | | f GHn y t t
| i }
Wn t j
o
g }
n Xy
| i } Wn t j
o
h } n Xy t | t j } | i | o& | o t | | | t | ni | |
j o! | o t | | t | n; t | | o t | | | n t d | | | f WqM t j
o } t | qM XqM Wd S( sy Set the options for 'command_obj' from 'option_dict'. Basically
this means copying elements of a dictionary ('option_dict') to
attributes of an instance ('command').
'command_obj' must be a Command instance. If 'option_dict' is not
supplied, uses the standard option dictionary for this command
(from 'self.command_options').
s# setting options for '%s' command:s %s = %s (from %s)s1 error in %s: command '%s' has no such option '%s'N( R: t get_command_namet command_namet option_dictR) R RA Rz R> R t sourceR R R t boolean_optionst bool_optsR R t neg_optR R t is_stringRE R! R RM R R RF ( R R: R R R R RF R R R R ( ( R R W s:
i c C s d k l } t | | p | } | i | } n
| i } | i p | Sn | i d | _ d | i
| <| i | | o+ x( | i
D] } | i | | q Wn | S( s Reinitializes a command to the state it was in when first
returned by 'get_command_obj()': ie., initialized but not yet
finalized. This provides the opportunity to sneak option
values in programmatically, overriding or supplementing
user-supplied values from the config files and command line.
You'll have to re-finalize the command object (by calling
'finalize_options()' or 'ensure_finalized()') before using it for
real.
'command' should be a command name (string) or command object. If
'reinit_subcommands' is true, also reinitializes the command's
sub-commands, as declared by the 'sub_commands' class attribute (if
it has one). See the "install" command for an example. Only
reinitializes the sub-commands that actually matter, ie. those
whose test predicates return true.
Returns the reinitialized command object.
( s Commandi N( R R R R? R R R R t finalizedt initialize_optionsR; R t reinit_subcommandst get_sub_commandst subt reinitialize_command( R R? R R R R ( ( R R s"
c C s t i | d S( N( R t debugRF ( R RF t level( ( R t announce s c C s% x | i D] } | i | q
Wd S( s Run each command that was seen on the setup script command line.
Uses the list of commands found and cache of command objects
created by 'get_command_obj()'.
N( R RU R t run_command( R R ( ( R t run_commands s
c C s_ | i i | o d Sn t i d | | i | } | i | i d | i | <d S( s Do whatever it takes to run a command (including nothing at all,
if the command has already been run). Specifically: if we have
already created and run the command named by 'command', return
silently without doing anything. If the command named by 'command'
doesn't even have a command object yet, create one. Then invoke
'run()' on that command object (or an existing one).
Ns
running %si (
R R; R= R? R t infoR R t ensure_finalizedt run( R R? R ( ( R R s
c C s$ t | i p | i p g d j S( Ni ( R R R. R1 ( R ( ( R t has_pure_modules s c C s | i o t | i d j S( Ni ( R R4 R ( R ( ( R t has_ext_modules s c C s | i o t | i d j S( Ni ( R R2 R ( R ( ( R t has_c_libraries s c C s | i p
| i S( N( R R R ( R ( ( R t has_modules s c C s | i o t | i d j S( Ni ( R R3 R ( R ( ( R t has_headers s c C s | i o t | i d j S( Ni ( R R8 R ( R ( ( R t has_scripts s c C s | i o t | i d j S( Ni ( R R9 R ( R ( ( R t has_data_files s c C s& | i o | i o | i S( N( R R R R ( R ( ( R t is_pure s ( s verboseR s run verbosely (default)i ( s quietR s! run quietly (turns verbosity off)( s dry-runR s don't actually do anything( s helpR s show detailed help message( s versionR s print package version(' Rt t
__module__t __doc__R R) R R R R RP RA R_ Rs R R R R RO R R R R R R R R R R R R R R R R R R R R R ( ( ( R R ! sH &
- 0 K b 9 ) $ #
) ( * R" c B s t Z d Z d% Z d Z d Z d Z d Z d Z d Z d Z
d Z d Z d Z
d Z d Z d Z e Z d Z d Z d! Z d" Z d# Z d$ Z RS(& s] Dummy class to hold the distribution meta-data: name, version,
author, and so forth.
R R
R
t author_emailR t maintainer_emailR R R t long_descriptionR R R R t
contact_emailR t download_urlc C s d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _
d | _ d | _ d | _
d | _ d | _ d S( N( R) R R R
R
R
R R R R R R R R R R ( R ( ( R RP s c C s t t i i | d d } | i d | i d | i | i d | i | i d | i
| i d | i | i d | i | i d | i
| i d
| i | i o | i d | i n t | i } | i d | t i | i d
} | o | i d | n x% | i D] } | i d | qRWx% | i D] } | i d | qzW| i d S( s7 Write the PKG-INFO file into the release tree.
s PKG-INFOt ws Metadata-Version: 1.0
s Name: %s
s Version: %s
s Summary: %s
s Home-page: %s
s Author: %s
s Author-email: %s
s License: %s
s Download-URL: %s
s Description: %s
R s
Keywords: %s
s
Platform: %s
s Classifier: %s
N( t openRe Rf Rk t base_dirt pkg_infoRK R t get_namet get_versiont get_descriptiont get_urlt get_contactt get_contact_emailt get_licenseR t
rfc822_escapet get_long_descriptiont long_descR\ t get_keywordsR t
get_platformsR t get_classifierst
classifiert close( R R R R R R R ( ( R t write_pkg_info s0
c C s | i p d S( Nt UNKNOWN( R R ( R ( ( R R 0 s c C s | i p d S( Ns 0.0.0( R R
( R ( ( R R 3 s c C s d | i | i f S( Ns %s-%s( R R R ( R ( ( R t get_fullname6 s c C s | i p d S( NR# ( R R
( R ( ( R t
get_author9 s c C s | i p d S( NR# ( R R
( R ( ( R t get_author_email< s c C s | i p d S( NR# ( R R ( R ( ( R t get_maintainer? s c C s | i p d S( NR# ( R R ( R ( ( R t get_maintainer_emailB s c C s | i p | i p d S( NR# ( R R R
( R ( ( R R E s c C s | i p | i p d S( NR# ( R R R
( R ( ( R R J s c C s | i p d S( NR# ( R R ( R ( ( R R O s c C s | i p d S( NR# ( R R ( R ( ( R R R s c C s | i p d S( NR# ( R R ( R ( ( R R V s c C s | i p d S( NR# ( R R ( R ( ( R R Y s c C s | i p g S( N( R R ( R ( ( R R \ s c C s | i p d g S( NR# ( R R ( R ( ( R R _ s c C s | i p g S( N( R R ( R ( ( R R b s c C s | i p d S( NR# ( R R ( R ( ( R t get_download_urle s ( s names versions authors author_emails
maintainers maintainer_emails urls licenses descriptions long_descriptions keywordss platformss fullnames contactR
s licenses classifierss download_url( Rt R R R$ RP R" R R R$ R% R& R' R( R R R R t get_licenceR R R R R R) ( ( ( R R" s, $ c C s/ g } x" | D] } | i | d d ! q
W| S( s Convert a 4-tuple 'help_options' list as found in various command
classes to the 3-tuple form required by FancyGetopt.
i i N( t new_optionsR t
help_tupleRn ( R R, R+ ( ( R R k s t __main__t ok( R t __revision__RI Re R\ t ret typesR RG R R) t distutils.errorst distutils.fancy_getoptR R t distutils.utilRd R R R` R t distutils.debugRz t compileR R R" R Rt t dist( Rd R7 R R R/ R R" R R0 R\ RG RI Rz R R R R Re R ( ( R t ? s. $
{