i fz @ s d Z d d l Z d d l Z d d l Z d d l m Z y d d l Z Wn e k
rd d Z Yn Xd d l Td d l m
Z
m Z d d l m
Z
m Z m Z d d l m Z d d l m Z e j d Z Gd
d d Z Gd d
d
Z d d Z d S)z}distutils.dist
Provides the Distribution class, which represents the module distribution
being built/installed/distributed.
N)message_from_file)*) FancyGetopttranslate_longopt)
check_environ strtobool
rfc822_escape)log)DEBUGz^[a-zA-Z]([a-zA-Z0-9_]*)$c @ s% e Z d Z d Z d~ d d d d g Z d Z d d d d d d d d d d d d d d d d d d d d d g Z d> d? e D Z i d d 6Z d d@ dA Z dB dC Z
d d dD dE dF Z dG dH Z d dI dJ Z
dK dL Z dM dN Z dO dP Z dQ dR Z d d g dS dT Z dU dV Z dW dX Z dY dZ Z d[ d\ Z d] d^ Z d_ d` Z d da db Z d dc dd Z de df dg Z e j dh di Z dj dk Z dl dm Z dn do Z! dp dq Z" dr ds Z# dt du Z$ dv dw Z% dx dy Z& dz d{ Z' d| d} Z( d S) Distributiona 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.
verbosevrun verbosely (default) quietq!run quietly (turns verbosity off)dry-runndon't actually do anythinghelphshow detailed help message no-user-cfgN-ignore pydistutils.cfg in your home directoryzCommon commands: (see '--help-commands' for more)
setup.py build will build the package underneath 'build/'
setup.py install will install the package
help-commandslist all available commandsnameprint package nameversionVprint package versionfullname print -authorprint the author's name author-email print the author's email address
maintainerprint the maintainer's namemaintainer-email$print the maintainer's email addresscontact7print the maintainer's name if known, else the author's
contact-email@print the maintainer's email address if known, else the author'surl print the URL for this packagelicense print the license of the packagelicencealias for --license description print the package descriptionlong-description"print the long package description platformsprint the list of platforms classifiers print the list of classifierskeywordsprint the list of keywordsprovides+print the list of packages/modules providedrequires+print the list of packages/modules required obsoletes0print the list of packages/modules made obsoletec C s g | ] } t | d q S)r )r ).0x rH 3/opt/alt/python34/lib64/python3.4/distutils/dist.py
q s zDistribution.c C si d | _ d | _ d | _ x! | j D] } t | | d q% Wt | _ x: | j j D], } d | } t | | t | j | qX Wi | _ d | _
d | _ d | _ i | _
g | _ d | _ i | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ i | _ i | _ | r | j d } | d k r| d =xY | j D]H \ } } | j | } x* | j D] \ } }
d |
f | | r: Nc S s g | ] } | j q SrH )strip)rF ZelmrH rH rI rJ _ s z1Distribution.finalize_options..,)zkeywordsz platforms)rV rT r strr rR )rr rs r rH rH rI rq U s
z Distribution.finalize_optionsc
C sv d d l m } d d l m } | rr | r; | j } n | j } | j | | j | j d t d n | r | j | j
| j d d t d n x | j D] } t | t
r t | | r | } n | j | } t | d r-t | j t r-| j | j t | j n | j | j | j d | j t d q Wt | | j d
S) ab 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'.
r ) gen_usage)r z
Global options:rL z*Information display options (just display z!information, ignore any commands)r zOptions for '%s' command:N)distutils.corer r r r r r Z
print_help common_usageprintr r r typer r rm r r r r r rY )
rr r r r r r r rM ru klassrH rH rI r b s6
zDistribution._show_helpc C s d d l m } | j rD | j t d t | | j d Sd } i } x | j D] } d | | d r: r r< r@ rB rD rN )zkeywordsz platforms)z classifierszprovideszrequiresz obsoletes) r r Z
help_commandsprint_commandsr rY r re r rV rT r ) rr r r Zany_display_optionsZis_display_optionoptionrw rx r rH rH rI r s,
z#Distribution.handle_display_optionsc C s t | d xw | D]o } | j j | } | sE | j | } n y
| j } Wn t k
rl d } Yn Xt d | | | f q Wd S)zZPrint a subset of the list of all commands -- used by
'print_commands()'.
:z(no description available)z
%-*s %sN)r rW re r r6 AttributeError)rr r r
max_lengthcmdr r6 rH rH rI print_command_list s
z Distribution.print_command_listc C s d d l } | j j } i } x | D] } d | | 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'.
r Nr z(no description available))
r ru r rW r re r r r6 r ) rr r r r r r rvr r6 rH rH rI get_command_list s(
z Distribution.get_command_listc C sx | j } t | t st | d k r- d } n d d | j d D } d | k rh | j d d n | | _ n | S)z9Return a list of packages from which commands are loaded.NrL c S s( g | ] } | d k r | j q S)rL )r )rF ZpkgrH rH rI rJ s z5Distribution.get_command_packages..r zdistutils.commandr )rX r r r insert)rr ZpkgsrH rH rI get_command_packages s z!Distribution.get_command_packagesc C s | j j | } | r | Sx | j D] } d | | f } | } y t | t j | } Wn t k
rw w) Yn Xy t | | } Wn+ t k
r t d | | | f Yn X| | j | <| SWt d | d S)ao 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.
z%s.%sz3invalid command '%s' (no class '%s' in module '%s')zinvalid command '%s'N)
rW re r
__import__rj r ImportErrorrV r r )rr ru r ZpkgnameZ module_nameZ
klass_namemodulerH rH rI r s(
z Distribution.get_command_classc C s | j j | } | r | r t r9 | j d | n | j | } | | } | j | .z1error in %s: command '%s' has no such option '%s')get_command_namerg r
r rf Zboolean_optionsr r r r rR r rm r r ) rr rc Z option_dict command_namer sourcer Z bool_optsZneg_optZ is_stringry rH rH rI r ] s>
z!Distribution._set_command_optionsr c C s d d l m } t | | s7 | } | j | } n | j } | j sP | S| j d | _ d | j | <| j | | r x' | j D] } | j
| | q Wn | S)a 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.
r )r ) r r r r r Z finalizedZinitialize_optionsrd r Zget_sub_commandsreinitialize_command)rr ru Zreinit_subcommandsr r subrH rH rI r s
z!Distribution.reinitialize_commandc C s t j | | d S)N)r )rr ry levelrH rH rI r s zDistribution.announcec C s% x | j D] } | j | q
Wd S)zRun 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 run_command)rr r rH rH rI run_commands s zDistribution.run_commandsc C sZ | j j | r d St j d | | j | } | j | j d | j | Z d? d@ Z dA dB Z dC dD Z dE dF Z dG dH Z dI dJ Z dK dL Z dM dN Z! d S)PrS z]Dummy class to hold the distribution meta-data: name, version,
author, and so forth.
r r r$ author_emailr( maintainer_emailr0 r2 r6 long_descriptionr> r: r" r,
contact_emailr< download_urlr@ rB rD Nc C s | d k r" | j t | n d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _
d | _ d | _ d | _
d | _ d | _ d | _ d | _ d | _ d S)N)
read_pkg_fileopenr r r$ r r( r r0 r2 r6 r r> r: r< r r@ rB rD )rr r rH rH rI r| s& z DistributionMetadata.__init__c s t | f d d } f d d } d } | d | _ | d | _ | d | _ | d | _ d
| _ | d | _ d
| _ | d | _ | d
| _ d k r | d | _
n d
| _
| d | _ | d | _ d k r!| d j d | _
n | d | _ | d | _ | d k r{| d | _ | d | _ | d | _ n d
| _ d
| _ d
| _ d
S)z-Reads the metadata values from a file object.c s | } | d k r d S| S)NUNKNOWNrH )r r )ry rH rI _read_field s
z7DistributionMetadata.read_pkg_file.._read_fieldc s& j | d } | g k r" d S| S)N)Zget_all)r values)ry rH rI
_read_list% s z6DistributionMetadata.read_pkg_file.._read_listzmetadata-versionr r Zsummaryr$ Nz author-emailz home-pager2 z download-urlr6 r> r platformZ
classifierz1.1rB r@ rD )r r r r6 r$ r( r r r0 r2 r r r r> r: r< rB r@ rD )rr filer r Zmetadata_versionrH )ry rI r s:
z"DistributionMetadata.read_pkg_filec C s> t t j j | d d d d } | j | Wd QXd S)z7Write the PKG-INFO file into the release tree.
zPKG-INFOwencodingzUTF-8N)r
r r r write_pkg_file)rr Zbase_dirZpkg_inforH rH rI write_pkg_infoO s z#DistributionMetadata.write_pkg_infoc C s d } | j s3 | j s3 | j s3 | j s3 | j r< d } n | j d | | j d | j | j d | j | j d | j | j d | j | j d | j
| j d | j | j d
| j | j r| j d | j n t
| j } | j d | d
j | j } | r`| j d | n | j | d | j | j | d | j | j | d | j | j | d | j | j | d | j d S)z9Write the PKG-INFO format data to a file object.
z1.0z1.1zMetadata-Version: %s
z Name: %s
z Version: %s
z Summary: %s
zHome-page: %s
z Author: %s
zAuthor-email: %s
z License: %s
zDownload-URL: %s
zDescription: %s
r z
Keywords: %s
ZPlatformZ
ClassifierZRequiresZProvidesZ ObsoletesN)r@ rB rD r< r rl get_name get_versionget_descriptionget_url get_contactget_contact_email get_licenser get_long_descriptionr get_keywords _write_list
get_platformsget_classifiers get_requires get_provides
get_obsoletes)rr r r Z long_descr> rH rH rI r V s0 z#DistributionMetadata.write_pkg_filec C s, x% | D] } | j d | | f q Wd S)Nz%s: %s
)rl )rr r r r r rH rH rI r! x s
z DistributionMetadata._write_listc C s
| j p d S)Nr )r )rr rH rH rI r ~ s z DistributionMetadata.get_namec C s
| j p d S)Nz0.0.0)r )rr rH rH rI r s z DistributionMetadata.get_versionc C s d | j | j f S)Nz%s-%s)r r )rr rH rH rI get_fullname s z!DistributionMetadata.get_fullnamec C s
| j p d S)Nr )r$ )rr rH rH rI
get_author s z DistributionMetadata.get_authorc C s
| j p d S)Nr )r )rr rH rH rI get_author_email s z%DistributionMetadata.get_author_emailc C s
| j p d S)Nr )r( )rr rH rH rI get_maintainer s z#DistributionMetadata.get_maintainerc C s
| j p d S)Nr )r )rr rH rH rI get_maintainer_email s z)DistributionMetadata.get_maintainer_emailc C s | j p | j p d S)Nr )r( r$ )rr rH rH rI r s z DistributionMetadata.get_contactc C s | j p | j p d S)Nr )r r )rr rH rH rI r s z&DistributionMetadata.get_contact_emailc C s
| j p d S)Nr )r0 )rr rH rH rI r s z DistributionMetadata.get_urlc C s
| j p d S)Nr )r2 )rr rH rH rI r s z DistributionMetadata.get_licensec C s
| j p d S)Nr )r6 )rr rH rH rI r s z$DistributionMetadata.get_descriptionc C s
| j p d S)Nr )r )rr rH rH rI r s z)DistributionMetadata.get_long_descriptionc C s
| j p g S)N)r> )rr rH rH rI r s z!DistributionMetadata.get_keywordsc C s | j p d g S)Nr )r: )rr rH rH rI r" s z"DistributionMetadata.get_platformsc C s
| j p g S)N)r< )rr rH rH rI r# s z$DistributionMetadata.get_classifiersc C s
| j p d S)Nr )r )rr rH rH rI get_download_url s z%DistributionMetadata.get_download_urlc C s
| j p g S)N)rB )rr rH rH rI r$ s z!DistributionMetadata.get_requiresc C s: d d l } x | D] } | j j | q W| | _ d S)Nr )distutils.versionpredicateversionpredicateVersionPredicaterB )rr r r r
rH rH rI set_requires s
z!DistributionMetadata.set_requiresc C s
| j p g S)N)r@ )rr rH rH rI r% s z!DistributionMetadata.get_providesc C sM d d | D } x* | D]" } d d l } | j j | q W| | _ d S)Nc S s g | ] } | j q SrH )r )rF r
rH rH rI rJ s z5DistributionMetadata.set_provides..r )r- r. Zsplit_provisionr@ )rr r r
r rH rH rI set_provides s
z!DistributionMetadata.set_providesc C s
| j p g S)N)rD )rr rH rH rI r& s z"DistributionMetadata.get_obsoletesc C s: d d l } x | D] } | j j | q W| | _ d S)Nr )r- r. r/ rD )rr r r r
rH rH rI
set_obsoletes s
z"DistributionMetadata.set_obsoletes)znamezversionzauthorz author_emailz
maintainerzmaintainer_emailzurllicensez descriptionzlong_descriptionzkeywordsz platformszfullnamezcontactr
r3 z classifiersz download_urlzprovideszrequiresz obsoletes)"r r r r rU r| r r r r! r r r' r( r) r* r+ r r r r Z get_licencer r r r" r# r, r$ r0 r% r1 r& r2 rH rH rH rI rS sJ 4 " rS c C s2 g } x% | D] } | j | d d q
W| S)zConvert a 4-tuple 'help_options' list as found in various command
classes to the 3-tuple form required by FancyGetopt.
r )r )rM Z new_optionsZ
help_tuplerH rH rI r s
r )r rj r reZemailr rh r Zdistutils.errorsZdistutils.fancy_getoptr r Zdistutils.utilr r r r r Zdistutils.debugr
compiler r rS r rH rH rH rI s$ $