U e5d@sdZddlZddlZddlZddlmZz ddlZWnek rLdZYnXddlTddl m Z m Z ddl m Z mZmZddlmZddlmZed Zd d ZGd d d ZGdddZddZdS)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_escapelog)DEBUGz^[a-zA-Z]([a-zA-Z0-9_]*)$cCsLt|tr nd?Zd@dAZdBdCZdddDdEZdedFdGZdfdIdJZejfdKdLZdMdNZdOdPZ dQdRZ!dSdTZ"dUdVZ#dWdXZ$dYdZZ%d[d\Z&d]d^Z'd_d`Z(d!S)g DistributionaThe 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. )verbosevzrun verbosely (default))quietqz!run quietly (turns verbosity off))zdry-runnzdon't actually do anything)helphzshow detailed help message)z no-user-cfgNz-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 )z help-commandsNzlist all available commands)nameNzprint package name)versionVzprint package version)fullnameNzprint -)authorNzprint the author's name) author-emailNz print the author's email address) maintainerNzprint the maintainer's name)zmaintainer-emailNz$print the maintainer's email address)contactNz7print the maintainer's name if known, else the author's)z contact-emailNz@print the maintainer's email address if known, else the author's)urlNzprint the URL for this package)licenseNz print the license of the package)licenceNzalias for --license) descriptionNzprint the package description)zlong-descriptionNz"print the long package description) platformsNzprint the list of platforms) classifiersNzprint the list of classifiers)keywordsNzprint the list of keywords)providesNz+print the list of packages/modules provided)requiresNz+print the list of packages/modules required) obsoletesNz0print the list of packages/modules made obsoletecCsg|]}t|dqS)rr).0xrrr szDistribution.rrNcCs\d|_d|_d|_|jD]}t||dqt|_|jjD] }d|}t||t|j|q:i|_ d|_ d|_ d|_ i|_ g|_d|_i|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_i|_i|_|r|d}|dk r8|d=|D]4\}}| |}|D]\} } d| f|| <qqd|kr~|d|d <|d=d } t!dk rnt!"| nt#j$%| d |D]\} } t&|jd | rt|jd | | nNt&|j| rt|j| | n0t&|| rt|| | nd t'| } t!"| qd|_(|j dk rP|j D].} | )ds6qP| dkr d|_(qPq |*dS)a0Construct 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()'. rrget_Noptionsz setup scriptr+r*z:'licence' distribution option is deprecated; use 'license' Zset_zUnknown distribution option: %sT-z --no-user-cfgF)+rdry_runrdisplay_option_namessetattrDistributionMetadatametadata_METHOD_BASENAMESgetattrcmdclasscommand_packages script_name script_argscommand_optionsZ dist_filespackagesZ package_dataZ package_dir py_modules librariesheaders ext_modulesZ ext_packageZ include_dirsZ extra_pathscripts data_filesZpassword command_objhave_rungetitemsget_option_dictwarningswarnsysstderrwritehasattrrepr want_user_cfg startswithfinalize_options)selfattrsattrbasenameZ method_namer9commandZ cmd_optionsopt_dictoptvalrkeyargrrr__init__s~                   zDistribution.__init__cCs&|j|}|dkr"i}|j|<|S)zGet 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)rGrQ)r^rbdictrrrrS&s zDistribution.get_option_dictr8c Csddlm}|dkr"t|j}|dk r@||||d}|sV||ddS|D]h}|j|}|dkr||d|qZ||d|||}|dD]}||d|qqZdS)Nr)pformatz zno commands known yetzno option dict for '%s' commandzoption dict for '%s' command:r:)ZpprintrjsortedrGkeysannouncerQsplit) r^headercommandsindentrjZcmd_namercoutlinerrrdump_option_dicts1s*  zDistribution.dump_option_dictscCsg}ttjtjdj}tj|d}tj|rB| |tj dkrRd}nd}|j rtjtj d|}tj|r| |d}tj|r| |t r|dd ||S) aFind 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. The file in the user's home directory can be disabled with the --no-user-cfg option. distutilsz distutils.cfgposixz.pydistutils.cfgzpydistutils.cfg~z setup.cfgzusing config files: %sz, )rospathdirnamerVmodules__file__joinisfileappendr!r[ expanduserr rm)r^filesZsys_dirZsys_fileZ user_filenameZ user_fileZ local_filerrrfind_config_filesMs&       zDistribution.find_config_filesc Csddlm}tjtjkr8ddddddd d d d d ddg }ng}t|}|dkrT|}trb|d|}|D]}tr|d|| || D]V}| |}| |}|D]8} | dkr| |kr| || } | dd} || f|| <qq|qld|jkr|jdD]\} \} } |j | } zF| rDt|| t|  n(| dkr`t|| t| n t|| | Wn,tk r} z t| W5d} ~ XYnXqdS)Nr) ConfigParserz install-basezinstall-platbasez install-libzinstall-platlibzinstall-purelibzinstall-headerszinstall-scriptsz install-dataprefixz exec-prefixhomeuserrootz"Distribution.parse_config_files():z reading %srr;_global)rr<)Z configparserrrVr base_prefix frozensetrr rmreadZsectionsr9rSrQreplacerhrGrR negative_optr>r ValueErrorDistutilsOptionError)r^ filenamesrZignore_optionsparserfilenameZsectionr9rcrdresrcaliasrrrrparse_config_files}s^             zDistribution.parse_config_filescCs|}g|_t||j}||j|ddi|j|j|d}| }t |j | |rhdS|r|||}|dkrhdSqh|jr|j|t|jdk|jddS|jstddS) aParse 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). r+r*)argsobjectNrdisplay_optionsrpzno commands suppliedT)_get_toplevel_optionsrprrset_negative_aliasesrZ set_aliasesgetoptrFZget_option_orderr Z set_verbosityrhandle_display_options_parse_command_optsr _show_helplenDistutilsArgError)r^Ztoplevel_optionsrr option_orderrrrparse_command_lines.      zDistribution.parse_command_linecCs |jdgS)zReturn 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. )zcommand-packages=Nz0list of packages that provide distutils commands)global_optionsr^rrrrsz"Distribution._get_toplevel_optionsc Csddlm}|d}t|s*td||j|z||}Wn*tk rn}z t |W5d}~XYnXt ||st d|t |drt |jtsd}t |||j}t |dr|}||jt |d rt |jtrt|j}ng}||j|j|||||d d\}} t | d rV| jrV|j|d|gd dSt |d rt |jtrd} |jD]F\} } } }t | || rzd } t|r|nt d || fqz| rdS||}t| D]\}}d|f||<q|S)aParse 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. rCommandzinvalid command name '%s'Nz&command class %s must subclass Command user_optionszIcommand class %s must provide 'user_options' attribute (a list of tuples)r help_optionsrrrzYinvalid help function %r for help option '%s': must be a callable object (function, etc.)z command line) distutils.cmdr command_rematch SystemExitrprget_command_classDistutilsModuleErrorr issubclassZDistutilsClassErrorrYr rrrcopyupdaterfix_help_optionsset_option_tablerrrrrZ get_attr_namecallablerSvarsrR)r^rrrrbZ cmd_classrrrZoptsZhelp_option_foundZ help_optionZshortZdescfuncrcr!rrrrrsr                  z Distribution._parse_command_optscCsPdD]F}t|j|}|dkrqt|trdd|dD}t|j||qdS)zSet final values for all the options on the Distribution instance, analogous to the .finalize_options() method of Command objects. r/r-NcSsg|] }|qSrstrip)r4Zelmrrrr6jsz1Distribution.finalize_options..,)rBr@r rrnr>)r^r`rrrrr]`s  zDistribution.finalize_optionsrc Csddlm}ddlm}|rR|r*|}n|j}||||jdt d|rt||j |dt d|j D]z}t |t rt||r|} n ||} t| drt | jtr|| jt| jn || j|d| jt dqzt ||jd S) abShow 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_usagerz Global options:r8zKInformation display options (just display information, ignore any commands)rzOptions for '%s' command:N)distutils.corerrrrrrZ print_help common_usageprintrrpr rrrrYrrrrrrE) r^rrrrprrr9rbklassrrrrms:           zDistribution._show_helpc Csddlm}|jr4|tdt||jdSd}i}|jD]}d||d<qB|D]l\}}|rX||rXt|}t |j d|}|dkrtd |n |dkrtd |nt|d}qX|S) zIf 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. rrr8rr7rr)r.r0r1r2r:) rrZ help_commandsprint_commandsrrErrQrrBr@r}) r^rrZany_display_optionsZis_display_optionoptionrdrerrrrrs*   z#Distribution.handle_display_optionsc Csjt|d|D]T}|j|}|s.||}z |j}Wntk rPd}YnXtd|||fqdS)zZPrint a subset of the list of all commands -- used by 'print_commands()'. :(no description available)z %-*s %sN)rrCrQrr,AttributeError)r^rpro max_lengthcmdrr,rrrprint_command_lists     zDistribution.print_command_listcCsddl}|jj}i}|D] }d||<qg}|jD]}||s4||q4d}||D]}t||krZt|}qZ||d||rt ||d|dS)anPrint 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'. rNrzStandard commandszExtra commands) distutils.commandrb__all__rCrlrQrrrr)r^ru std_commandsis_stdrextra_commandsrrrrrs.      zDistribution.print_commandsc Csddl}|jj}i}|D] }d||<qg}|jD]}||s4||q4g}||D]P}|j|}|sx||}z |j}Wnt k rd}YnX|||fqZ|S)a>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'. rNrr) rrbrrCrlrQrrr,r) r^rurrrrrvrr,rrrget_command_lists(         zDistribution.get_command_listcCsN|j}t|tsJ|dkrd}dd|dD}d|krD|dd||_|S)z9Return a list of packages from which commands are loaded.Nr8cSsg|]}|dkr|qS)r8r)r4Zpkgrrrr6!sz5Distribution.get_command_packages..rzdistutils.commandr)rDr rrninsert)r^Zpkgsrrrget_command_packagess  z!Distribution.get_command_packagesc Cs|j|}|r|S|D]}d||f}|}zt|tj|}Wntk r^YqYnXzt||}Wn&tk rt d|||fYnX||j|<|St d|dS)aoReturn 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) rCrQr __import__rVr{ ImportErrorrBrr)r^rbrZpkgnameZ module_nameZ klass_namemodulerrrr's,      zDistribution.get_command_classcCsl|j|}|sh|rhtr&|d|||}||}|j|<d|j|<|j|}|rh||||S)aReturn 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. z.z1error in %s: command '%s' has no such option '%s')get_command_namerSr rmrRZboolean_optionsrrr rr>rrYrr) r^rOZ option_dict command_namersourcerZ bool_optsZneg_optZ is_stringrrrrrhsF           z!Distribution._set_command_optionsrcCs|ddlm}t||s&|}||}n|}|js8|S|d|_d|j|<|||rx| D]}| ||qf|S)aReinitializes 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. rr) rrr rrZ finalizedZinitialize_optionsrPrZget_sub_commandsreinitialize_command)r^rbZreinit_subcommandsrrsubrrrrs      z!Distribution.reinitialize_commandcCst||dSNr )r^rlevelrrrrmszDistribution.announcecCs|jD]}||qdS)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)rp run_command)r^rrrr run_commandss zDistribution.run_commandscCsD|j|rdStd|||}||d|j|<dS)aDo 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). Nz running %sr)rPrQr inforZensure_finalizedrun)r^rbrrrrrs   zDistribution.run_commandcCst|jp|jpgdkSNr)rrHrIrrrrhas_pure_modulesszDistribution.has_pure_modulescCs|jot|jdkSr)rLrrrrrhas_ext_modulesszDistribution.has_ext_modulescCs|jot|jdkSr)rJrrrrrhas_c_librariesszDistribution.has_c_librariescCs|p|Sr)rrrrrr has_modulesszDistribution.has_modulescCs|jot|jdkSr)rKrrrrr has_headersszDistribution.has_headerscCs|jot|jdkSr)rMrrrrr has_scriptsszDistribution.has_scriptscCs|jot|jdkSr)rNrrrrrhas_data_filesszDistribution.has_data_filescCs|o| o| Sr)rrrrrrris_pures zDistribution.is_pure)N)NNr8)N)r)N)r))r __module__ __qualname____doc__rrrr=rrhrSrtrrrrrr]rrrrrrrrrrr INFOrmrrrrrrrrrrrrrrr,s  ,  0 :C [  2(!" &  , ) rc@seZdZdZdZdBddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZddZddZd d!Zd"d#ZeZd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Zd4d5Zd6d7Zd8d9Z d:d;Z!dd?Z#d@dAZ$dS)Cr?z]Dummy class to hold the distribution meta-data: name, version, author, and so forth. )r!r"r% author_emailr'maintainer_emailr)r*r,long_descriptionr/r-r$r(Z contact_emailr. download_urlr0r1r2NcCs|dk r|t|nfd|_d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ d|_ d|_ d|_d|_d|_d|_d|_dSr) read_pkg_fileopenr!r"r%rr'rr)r*r,rr/r-r.rr0r1r2)r^ryrrrrh s&zDistributionMetadata.__init__cst|fdd}fdd}d}|d|_|d|_|d|_|d |_d |_|d |_d |_|d |_|d |_ dkr|d|_ nd |_ |d|_ |d|_dkr|d d|_ |d|_|d|_|dkr|d|_|d|_|d|_nd |_d |_d |_d S)z-Reads the metadata values from a file object.cs|}|dkrdS|SNZUNKNOWNr)r!rrrr _read_field(sz7DistributionMetadata.read_pkg_file.._read_fieldcs|d}|gkrdS|Sr)Zget_all)r!valuesrrr _read_list.s z6DistributionMetadata.read_pkg_file.._read_listzmetadata-versionr!r"Zsummaryr%Nr&z home-pager*z download-urlr,r/rplatformZ classifier1.1r1r0r2)rr!r"r,r%r'rrr)r*rrrnr/r-r.r1r0r2)r^filerrZmetadata_versionrrrr$s:                 z"DistributionMetadata.read_pkg_filec Cs2ttj|dddd}||W5QRXdS)z7Write the PKG-INFO file into the release tree. zPKG-INFOwzUTF-8)encodingN)rrxryr}write_pkg_file)r^Zbase_dirZpkg_inforrrwrite_pkg_infoXs z#DistributionMetadata.write_pkg_infocCsbd}|js"|js"|js"|js"|jr&d}|d||d||d||d||d| |d| |d | |d | |jr|d |jt |}|d |d |}|r|d|||d|||d|||d|||d|||d|dS)z9Write the PKG-INFO format data to a file object. z1.0rzMetadata-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 rz Keywords: %s ZPlatformZ ClassifierZRequiresZProvidesZ ObsoletesN)r0r1r2r.rrXget_name get_versionget_descriptionget_url get_contactget_contact_email get_licenserget_long_descriptionr} get_keywords _write_list get_platformsget_classifiers get_requires get_provides get_obsoletes)r^rr"Z long_descr/rrrr_s6 z#DistributionMetadata.write_pkg_filecCs |D]}|d||fqdS)Nz%s: %s )rX)r^rr!rrrrrrsz DistributionMetadata._write_listcCs |jpdSr)r!rrrrrszDistributionMetadata.get_namecCs |jpdS)Nz0.0.0)r"rrrrrsz DistributionMetadata.get_versioncCsd||fS)Nz%s-%s)rrrrrr get_fullnamesz!DistributionMetadata.get_fullnamecCs |jpdSr)r%rrrr get_authorszDistributionMetadata.get_authorcCs |jpdSr)rrrrrget_author_emailsz%DistributionMetadata.get_author_emailcCs |jpdSr)r'rrrrget_maintainersz#DistributionMetadata.get_maintainercCs |jpdSr)rrrrrget_maintainer_emailsz)DistributionMetadata.get_maintainer_emailcCs|jp|jpdSr)r'r%rrrrr sz DistributionMetadata.get_contactcCs|jp|jpdSr)rrrrrrr sz&DistributionMetadata.get_contact_emailcCs |jpdSr)r)rrrrrszDistributionMetadata.get_urlcCs |jpdSr)r*rrrrr sz DistributionMetadata.get_licensecCs |jpdSr)r,rrrrrsz$DistributionMetadata.get_descriptioncCs |jpdSr)rrrrrr sz)DistributionMetadata.get_long_descriptioncCs |jpgSr)r/rrrrr sz!DistributionMetadata.get_keywordscCst|d|_dS)Nr/)rr/r^rrrr set_keywordssz!DistributionMetadata.set_keywordscCs |jp dgSr)r-rrrrrsz"DistributionMetadata.get_platformscCst|d|_dS)Nr-)rr-rrrr set_platformssz"DistributionMetadata.set_platformscCs |jpgSr)r.rrrrrsz$DistributionMetadata.get_classifierscCst|d|_dS)Nr.)rr.rrrrset_classifierssz$DistributionMetadata.set_classifierscCs |jpdSr)rrrrrget_download_urlsz%DistributionMetadata.get_download_urlcCs |jpgSr)r1rrrrrsz!DistributionMetadata.get_requirescCs,ddl}|D]}|j|q t||_dSr)distutils.versionpredicateversionpredicateVersionPredicaterr1r^rrurrrr set_requiressz!DistributionMetadata.set_requirescCs |jpgSr)r0rrrrrsz!DistributionMetadata.get_providescCs6dd|D}|D]}ddl}|j|q||_dS)NcSsg|] }|qSrr)r4rrrrr6sz5DistributionMetadata.set_provides..r)rrZsplit_provisionr0)r^rrrurrr set_providess z!DistributionMetadata.set_providescCs |jpgSr)r2rrrrrsz"DistributionMetadata.get_obsoletescCs,ddl}|D]}|j|q t||_dSr)rrr rr2r!rrr set_obsoletessz"DistributionMetadata.set_obsoletes)N)%rrrrrArhrrrrrrrrrrrr r rr Z get_licencerr r rrrrrrrr"rr#rr$rrrrr?sD 4"r?cCs$g}|D]}||ddq|S)zConvert a 4-tuple 'help_options' list as found in various command classes to the 3-tuple form required by FancyGetopt. r)r)r9Z new_optionsZ help_tuplerrrrsr)rrVrxreZemailrrTrZdistutils.errorsZdistutils.fancy_getoptrrZdistutils.utilrrrrur Zdistutils.debugr compilerrrr?rrrrrs4      Zc