B
Ìtè#Ñ<9ã @ 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 sd ddl m} ddlm} g }x,| ¡ D ] }| d| d|| d f¡ q&W | ¡ | |ƒ d¡ dS )zoPrint all possible values for the 'formats' option (used by
the "--help-formats" command-line option).
r )Ú FancyGetopt)ÚARCHIVE_FORMATSzformats=Né z.List of available source distribution formats:)Zdistutils.fancy_getoptr Zdistutils.archive_utilr ÚkeysÚappendÚsortZ
print_help)r r ÚformatsÚformat© r úd?„ Z d@dA„ Z dBdC„ Z dDdE„ Z dFdG„ Z!dHdI„ Z"dS )JÚsdistz6create a source distribution (tarball, zip file, etc.)c C s | j S )zYCallable used for the check sub-command.
Placed here so user_options can view it)Úmetadata_check)Úselfr r r Úchecking_metadata( s zsdist.checking_metadata)z template=Útz5name of manifest template file [default: MANIFEST.in])z manifest=Úmz)name of manifest file [default: MANIFEST])z use-defaultsNzRinclude the default file set in the manifest [default; disable with --no-defaults])z no-defaultsNz"don't include the default file set)ÚpruneNz‰specifically exclude files/directories that should not be distributed (build tree, RCS/CVS dirs, etc.) [default; disable with --no-prune])zno-pruneNz$don't automatically exclude anything)z
manifest-onlyÚozEjust regenerate the manifest and then stop (implies --force-manifest))zforce-manifestÚfzkforcibly regenerate the manifest and carry on as usual. Deprecated: now the manifest is always regenerated.)zformats=Nz6formats for source distribution (comma-separated list))z keep-tempÚkz@keep the distribution tree around after creating archive file(s))z dist-dir=ÚdzFdirectory to put the source distribution archive(s) in [default: dist])zmetadata-checkNz[Ensure that all required elements of meta-data are supplied. Warn if any missing. [default])zowner=Úuz@Owner name used when creating a tar file [default: current user])zgroup=ÚgzAGroup name used when creating a tar file [default: current group]z use-defaultsr z
manifest-onlyzforce-manifestz keep-tempzmetadata-checkz help-formatsNz#list available distribution formats)z no-defaultszno-pruneÚcheck)ZREADMEz
README.txtz
README.rstc C sT d | _ d | _d| _d| _d| _d| _dg| _d| _d | _d | _ d| _
d | _ d | _ d S )Né r Zgztar)
ÚtemplateÚmanifestÚ use_defaultsr Ú
manifest_onlyZforce_manifestr Ú keep_tempÚdist_dirÚ
archive_filesr ÚownerÚgroup)r r r r Úinitialize_optionse s zsdist.initialize_optionsc C sZ | j d krd| _ | jd kr d| _| d¡ t | j¡}|rFtd| ƒ‚| jd krVd| _d S )NZMANIFESTz MANIFEST.inr zunknown archive format '%s'Zdist)r) r( Zensure_string_listr Zcheck_archive_formatsr r
r- )r Z
bad_formatr r r Úfinalize_options| s
zsdist.finalize_optionsc C sB t ƒ | _x| ¡ D ]}| |¡ qW | ¡ | jr6d S | ¡ d S )N)r ÚfilelistZget_sub_commandsZ run_commandÚ
get_file_listr+ Ú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_finalizedr6 )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Úisfiler( Ú_manifest_is_not_generatedÚ
read_manifestr3 r Zremove_duplicatesr Úfindallr* Ú add_defaultsÚ
read_templater Úprune_file_listÚwrite_manifest)r Ztemplate_existsr r r r4 ª 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_scripts)r r r r r@ Ò s zsdist.add_defaultsc C s: t j | ¡sdS t j | ¡}t j |¡\}}|t |¡kS )z±
Case-sensitive path existence check
>>> sdist._cs_path_exists(__file__)
True
>>> sdist._cs_path_exists(__file__.upper())
False
F)r: r; ÚexistsÚabspathÚsplitÚlistdir)ÚfspathrL Z directoryÚfilenamer r r Ú_cs_path_existsè s
zsdist._cs_path_existsc C sœ | j | jjg}xˆ|D ]€}t|tƒrn|}d}x(|D ] }| |¡r0d}| j |¡ P q0W |s”| dd |¡ ¡ q| |¡r†| j |¡ q| d| ¡ qW d S )NFTz,standard file not found: should have one of z, z standard file '%s' not found)
ÚREADMESr8 Z script_nameÚ
isinstanceÚtuplerQ r3 r r Újoin)r Z standardsÚfnZaltsZgot_itr r r rD ù s
z sdist._add_defaults_standardsc C s8 ddg}x*|D ]"}t tjjt|ƒƒ}| j |¡ qW d S )Nz
test/test*.pyz setup.cfg)Úfilterr: r; r< r r3 Úextend)r ZoptionalÚpatternÚfilesr r r rE s
z sdist._add_defaults_optionalc C sd | d¡}| j ¡ r$| j | ¡ ¡ x:|jD ]0\}}}}x"|D ]}| j tj
||¡¡ q>W q,W d S )NÚbuild_py) Úget_finalized_commandr8 Zhas_pure_modulesr3 rX Úget_source_filesÚ
data_filesr r: r; rU )r r[ ZpkgZsrc_dirZ build_dirÚ filenamesrP r r r rF s
zsdist._add_defaults_pythonc C s‚ | j ¡ r~xr| j jD ]f}t|tƒrDt|ƒ}tj |¡rz| j
|¡ q|\}}x,|D ]$}t|ƒ}tj |¡rR| j
|¡ qRW qW d S )N) r8 Zhas_data_filesr^ rS Ústrr r: r; r< r3 r )r ÚitemÚdirnamer_ r! r r r rG $ s
z sdist._add_defaults_data_filesc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ build_ext)r8 Zhas_ext_modulesr\ r3 rX r] )r rc r r r rH 5 s
zsdist._add_defaults_extc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ
build_clib)r8 Zhas_c_librariesr\ r3 rX r] )r rd r r r rI : s
zsdist._add_defaults_c_libsc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ
build_scripts)r8 Z has_scriptsr\ r3 rX r] )r re r r r rJ ? s
zsdist._add_defaults_scriptsc
C s¢ t d| j¡ t| jddddddd}zlxf| ¡ }|dkr ” s
zsdist.read_manifestc C s² | |¡ tj||| jd ttdƒr4d}d| }n d}d| }|sPt d¡ n
t |¡ xD|D ]<}tj
|¡s~t d|¡ q`tj ||¡}| j |||d q`W | 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_treerz Úhasattrr: r
r rf r; r< rU Z copy_filer8 ZmetadataZwrite_pkg_info)r rs rZ r{ rk ÚfileÚdestr r r Úmake_release_tree£ s
zsdist.make_release_treec C sº | j ¡ }tj | j|¡}| || jj¡ g }d| j krT| j
| j | j d¡¡¡ xD| j D ]:}| j
|||| j| jd}|
|¡ | j j
dd|f¡ q\W || _| 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)rs r/ r0 r Ú )rz N)r8 rp r: r; rU r- r r3 rZ r r ÚpopÚindexZ make_archiver/ r0 Z
dist_filesr. r, r Z remove_treerz )r rs Z base_namer. Zfmtr} r r r r5 Í 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.
)r. )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_commandsrR r1 r2 r6 r9 r4 r@ Ú staticmethodrQ rD rE rF rG rH rI rJ rA rB rC r= r> r r5 rƒ r r r r r $ s^
( * r )Ú__doc__r: rq 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