a
XC?h=J ã @ s¸ d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
ddlm Z dd l m
Z
dd
lmZ dd lmZ dd lmZ dd
lmZmZ dd„ ZG dd„ deƒZdS )zadistutils.command.sdist
Implements the Distutils 'sdist' command (create a source distribution).é N)Úglob)Úwarn)ÚCommand)Údir_util)Ú file_util)Ú archive_util)ÚTextFile)ÚFileList)Úlog)Ú convert_path)ÚDistutilsTemplateErrorÚDistutilsOptionErrorc C s` ddl m} ddlm} g }| ¡ D ] }| d| d|| d f¡ q$| ¡ | |ƒ d¡ dS )zoPrint all possible values for the 'formats' option (used by
the "--help-formats" command-line option).
r )Ú FancyGetopt)ÚARCHIVE_FORMATSúformats=Né z.List of available source distribution formats:)Zdistutils.fancy_getoptr Zdistutils.archive_utilr ÚkeysÚappendÚsortZ
print_help)r r ÚformatsÚformat© r ú t ƒ | _| ¡ D ]}| |¡ q| ¡ | jr2d S | ¡ d S ©N)r ÚfilelistZget_sub_commandsZ run_commandÚ
get_file_listr4 Úmake_distribution)r Zcmd_namer r r ÚrunŒ s z sdist.runc C s* t dtƒ | j d¡}| ¡ | ¡ dS )zDeprecated API.zadistutils.command.sdist.check_metadata is deprecated, use the check command insteadr/ N)r ÚPendingDeprecationWarningÚ distributionZget_command_objZensure_finalizedr@ )r r/ r r r Úcheck_metadata¢ s ÿ zsdist.check_metadatac C s t j | j¡}|s:| ¡ r:| ¡ | j ¡ | j ¡ dS |sN| d| j ¡ | j
¡ | j rf| ¡ |rr|
¡ | jr€| ¡ | j ¡ | j ¡ | ¡ dS )aC Figure out the list of files to include in the source
distribution, and put it in 'self.filelist'. This might involve
reading the manifest template (and writing the manifest), or just
reading the manifest, or just using the default file set -- it all
depends on the user's options.
Nz?manifest template '%s' does not exist (using default file list))ÚosÚpathÚisfiler1 Ú_manifest_is_not_generatedÚ
read_manifestr= r Zremove_duplicatesr Úfindallr3 Ú add_defaultsÚ
read_templater# Úprune_file_listÚwrite_manifest)r Ztemplate_existsr r r r> ª s(
þ
zsdist.get_file_listc C s< | ¡ | ¡ | ¡ | ¡ | ¡ | ¡ | ¡ dS )a9 Add all the default files to self.filelist:
- README or README.txt
- setup.py
- test/test*.py
- all pure Python modules mentioned in setup script
- all files pointed by package_data (build_py)
- all files defined in data_files.
- all files defined as scripts.
- all C sources listed as part of extensions or C libraries
in the setup script (doesn't catch C headers!)
Warns if (README or README.txt) or setup.py are missing; everything
else is optional.
N)Ú_add_defaults_standardsÚ_add_defaults_optionalÚ_add_defaults_pythonÚ_add_defaults_data_filesÚ_add_defaults_extÚ_add_defaults_c_libsÚ_add_defaults_scriptsr r r r rJ Ò s zsdist.add_defaultsc C s: t j | ¡sdS t j | ¡}t j |¡\}}|t |¡v S )z±
Case-sensitive path existence check
>>> sdist._cs_path_exists(__file__)
True
>>> sdist._cs_path_exists(__file__.upper())
False
F)rD rE ÚexistsÚabspathÚsplitÚlistdir)ÚfspathrV Z directoryÚfilenamer r r Ú_cs_path_existsè s
zsdist._cs_path_existsc C s– | j | jjg}|D ]~}t|tƒrj|}d}|D ]"}| |¡r,d}| j |¡ qPq,|s| dd |¡ ¡ q| |¡r‚| j |¡ q| d| ¡ qd S )NFTz,standard file not found: should have one of z, z standard file '%s' not found)
ÚREADMESrB Z script_nameÚ
isinstanceÚtupler[ r= r r Újoin)r Z standardsÚfnZaltsZgot_itr r r rN ù s"
ÿ
z sdist._add_defaults_standardsc C s4 ddg}|D ]"}t tjjt|ƒƒ}| j |¡ q d S )Nz
test/test*.pyz setup.cfg)ÚfilterrD rE rF r r= Úextend)r ZoptionalÚpatternÚfilesr r r rO s z sdist._add_defaults_optionalc C s\ | d¡}| j ¡ r$| j | ¡ ¡ |jD ],\}}}}|D ]}| j tj
||¡¡ q:q*d S )NÚbuild_py) Úget_finalized_commandrB Zhas_pure_modulesr= rb Úget_source_filesÚ
data_filesr rD rE r_ )r re ZpkgZsrc_dirZ build_dirÚ filenamesrZ r r r rP s
zsdist._add_defaults_pythonc C sz | j ¡ rv| j jD ]b}t|tƒrBt|ƒ}tj |¡rt| j
|¡ q|\}}|D ]$}t|ƒ}tj |¡rN| j
|¡ qNqd S r< ) rB Zhas_data_filesrh r] Ústrr rD rE rF r= r )r ÚitemÚdirnameri r( r r r rQ $ s
z sdist._add_defaults_data_filesc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ build_ext)rB Zhas_ext_modulesrf r= rb rg )r rm r r r rR 5 s
zsdist._add_defaults_extc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ
build_clib)rB Zhas_c_librariesrf r= rb rg )r rn r r r rS : s
zsdist._add_defaults_c_libsc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ
build_scripts)rB Z has_scriptsrf r= rb rg )r ro r r r rT ? s
zsdist._add_defaults_scriptsc
C s¨ t d| j¡ t| jddddddd}zr| ¡ }|du r:qŽz| j |¡ W q( ttfyŠ } z$| d|j
|j |f ¡ W Y d}~q(d}~0 0 q(W | ¡ n
| ¡ 0 dS )zÈRead and parse manifest template file named by self.template.
(usually "MANIFEST.in") The parsing and processing is done by
'self.filelist', which updates itself accordingly.
z reading manifest template '%s'r0 )Zstrip_commentsZ skip_blanksZ
join_linesZ lstrip_wsZ rstrip_wsZ
collapse_joinNz%s, line %d: %s)
r
Úinfor1 r Úreadliner= Zprocess_template_liner Ú
ValueErrorr rZ Z current_lineÚclose)r r1 ÚlineÚmsgr r r rK D s"
þ
þ"zsdist.read_templatec C sz | d¡}| j ¡ }| jjd|jd | jjd|d tjdkrFd}nd}g d¢}d|d |¡|f }| jj|d
d dS ) av Prune off branches that might slip into the file list as created
by 'read_template()', but really don't belong there:
* the build tree (typically "build")
* the release tree itself (only an issue if we ran "sdist"
previously with --keep-temp, or it aborted)
* any RCS, CVS, .svn, .hg, .git, .bzr, _darcs directories
ÚbuildN)ÚprefixZwin32z/|\\ú/)ZRCSZCVSz\.svnz\.hgz\.gitz\.bzrZ_darcsz(^|%s)(%s)(%s).*ú|r0 )Zis_regex) rf rB Ú get_fullnamer= Zexclude_patternZ
build_baseÚsysÚplatformr_ )r rv Úbase_dirZsepsZvcs_dirsZvcs_ptrnr r r rL a s
zsdist.prune_file_listc C sX | ¡ r t d| j ¡ dS | jjdd… }| dd¡ | tj | j|fd| j ¡ dS )z²Write the file list in 'self.filelist' (presumably as filled in
by 'add_defaults()' and 'read_template()') to the manifest file
named by 'self.manifest'.
z5not writing to manually maintained manifest file '%s'Nr z*# file GENERATED by distutils, do NOT editzwriting manifest file '%s')
rG r
rp r2 r= rd ÚinsertZexecuter Z
write_file)r Zcontentr r r rM y s ÿ ÿzsdist.write_manifestc C sD t j | j¡sdS t| jƒ}z| ¡ }W | ¡ n
| ¡ 0 |dkS )NFz+# file GENERATED by distutils, do NOT edit
)rD rE rF r2 Úopenrq rs )r ÚfpZ
first_liner r r rG ˆ s
z sdist._manifest_is_not_generatedc C sj t d| j¡ t| jƒ>}|D ](}| ¡ }| d¡s |s:q | j |¡ q W d ƒ n1 s\0 Y dS )zªRead the manifest file (named by 'self.manifest') and use it to
fill in 'self.filelist', the list of files to include in the source
distribution.
zreading manifest file '%s'ú#N)r
rp r2 r ÚstripÚ
startswithr= r )r r2 rt r r r rH ” s zsdist.read_manifestc C s® | |¡ tj||| jd ttdƒr4d}d| }n d}d| }|sPt d¡ n
t |¡ |D ]<}tj
|¡s|t d|¡ q^tj ||¡}| j |||d q^| j
j |¡ dS )
aÆ Create the directory tree that will become the source
distribution archive. All directories implied by the filenames in
'files' are created under 'base_dir', and then we hard link or copy
(if hard linking is unavailable) those files into place.
Essentially, this duplicates the developer's source tree, but in a
directory named after the distribution, containing only the files
to be distributed.
©Údry_runÚlinkZhardzmaking hard links in %s...Nzcopying files to %s...z)no files to distribute -- empty manifest?z#'%s' not a regular file -- skipping)r† )Zmkpathr Z create_treer… ÚhasattrrD r
r rp rE rF r_ Z copy_filerB ÚmetadataZwrite_pkg_info)r r} rd r† ru ÚfileÚdestr r r Úmake_release_tree¢ s
zsdist.make_release_treec C s¶ | j ¡ }tj | j|¡}| || jj¡ g }d| j v rT| j
| j | j d¡¡¡ | j D ]:}| j
|||| j| jd}|
|¡ | j j
dd|f¡ qZ|| _| js²tj|| jd dS )a¯ Create the source distribution(s). First, we create the release
tree with 'make_release_tree()'; then, we create all required
archive files (according to 'self.formats') from the release tree.
Finally, we clean up by blowing away the release tree (unless
'self.keep_temp' is true). The list of archive files created is
stored so it can be retrieved later by 'get_archive_files()'.
Ztar)r} r8 r9 r Ú r„ N)rB rz rD rE r_ r6 r‹ r= rd r r ÚpopÚindexZ make_archiver8 r9 Z
dist_filesr7 r5 r Z remove_treer… )r r} Z base_namer7 Zfmtr‰ r r r r? Ì s
ÿ
zsdist.make_distributionc C s | j S )zzReturn the list of archive files created when the command
was run, or None if the command hasn't run yet.
)r7 r r r r Úget_archive_filesê s zsdist.get_archive_files)#Ú__name__Ú
__module__Ú __qualname__Z descriptionr Z user_optionsZboolean_optionsr Z help_optionsZ negative_optZ sub_commandsr\ r: r; r@ rC r> rJ Ú staticmethodr[ rN rO rP rQ rR rS rT rK rL rM rG rH r‹ r? r r r r r r $ sH 'ÿÿÿ
(
* r )Ú__doc__rD r{ r Úwarningsr Zdistutils.corer Z distutilsr r r Zdistutils.text_filer Zdistutils.filelistr r
Zdistutils.utilr Zdistutils.errorsr r
r r r r r r Ú s