U
|
G=®d=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 deZdS )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:)Údistutils.fancy_getoptr Zdistutils.archive_utilr ÚkeysÚappendÚsortÚ
|
print_help)r r ÚformatsÚformat© r úZD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\setuptools/_distutils/command/sdist.pyÚ show_formats s
|
ÿÿr c @ s" e Zd ZdZdd Zdddddd d
|
d d d ddddgZddddddgZdddefgZdddZ d efgZ
|
d Z d d Z d d! Z d"d# Zd$d% Zd&d' Zd(d) Zed*d+ Zd,d- Zd.d/ Zd0d1 Zd2d3 Zd4d5 Zd6d7 Zd8d9 Zd:d; Zd<d= Z d>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])ú use-defaultsNzRinclude the default file set in the manifest [default; disable with --no-defaults])ú no-defaultsNz"don't include the default file set)ÚpruneNzspecifically exclude files/directories that should not be distributed (build tree, RCS/CVS dirs, etc.) [default; disable with --no-prune])úno-pruneNz$don't automatically exclude anything)ú manifest-onlyÚozEjust regenerate the manifest and then stop (implies --force-manifest))úforce-manifestÚfzkforcibly regenerate the manifest and carry on as usual. Deprecated: now the manifest is always regenerated.)r Nz6formats for source distribution (comma-separated list))ú 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])úmetadata-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]r# r% r' r) r+ r. z help-formatsNz#list available distribution formats)r$ r& Ú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 Úgztar) ÚtemplateÚmanifestÚ use_defaultsr% Ú manifest_onlyZforce_manifestr Ú keep_tempÚdist_dirÚ archive_filesr ÚownerÚgroupr 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'Údist)r5 r4 Úensure_string_listr Úcheck_archive_formatsr r r9 )r Z
|
bad_formatr r r Úfinalize_options| s
|
|
|
ÿ
|
zsdist.finalize_optionsc C s> t | _| ¡ D ]}| |¡ q| ¡ | jr2d S | ¡ d S ©N)r ÚfilelistÚget_sub_commandsÚ run_commandÚ get_file_listr7 Úmake_distribution)r Úcmd_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 insteadr1 N)r ÚPendingDeprecationWarningÚ distributionÚget_command_objÚensure_finalizedrI )r r1 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Úisfiler4 Ú_manifest_is_not_generatedÚ read_manifestrC r Zremove_duplicatesr Úfindallr6 Ú add_defaultsÚ read_templater% Úprune_file_listÚwrite_manifest)r Ztemplate_existsr r r rF ª 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 rU Ò 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)rO rP ÚexistsÚabspathÚsplitÚlistdir)Úfspathra Ú directoryÚfilenamer r r Ú_cs_path_existsè s
|
|
zsdist._cs_path_existsc C s | j | jjg}|D ]~}t|trj|}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)
|
ÚREADMESrK Ú script_nameÚ
|
isinstanceÚtuplerg rC r r Újoin)r Z standardsÚfnZaltsZgot_itr r r rY ù s"
|
|
ÿ
|
z sdist._add_defaults_standardsc C s4 ddg}|D ]"}t tjjt|}| j |¡ q d S )Nz test/test*.pyz setup.cfg)ÚfilterrO rP rQ r rC Úextend)r ÚoptionalÚpatternÚfilesr r r rZ 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_commandrK Úhas_pure_modulesrC ro Úget_source_filesÚ
|
data_filesr rO rP rl )r rs ÚpkgÚsrc_dirÚ build_dirÚ filenamesrf r r r r[ s
|
|
zsdist._add_defaults_pythonc C sz | j ¡ rv| j jD ]b}t|trBt|}tj |¡rt| j
|
|¡ q|\}}|D ]$}t|}tj |¡rN| j
|
|¡ qNqd S rB ) rK Úhas_data_filesrw rj Ústrr rO rP rQ rC r )r ÚitemÚdirnamer{ r* r r r r\ $ s
|
|
z sdist._add_defaults_data_filesc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ build_ext)rK Úhas_ext_modulesrt rC ro rv )r r r r r r] 5 s
|
|
zsdist._add_defaults_extc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ
|
build_clib)rK Úhas_c_librariesrt rC ro rv )r r r r r r^ : s
|
|
zsdist._add_defaults_c_libsc C s( | j ¡ r$| d¡}| j | ¡ ¡ d S )NÚ build_scripts)rK Ú has_scriptsrt rC ro rv )r r r r r r_ ? s
|
|
zsdist._add_defaults_scriptsc
|
C s t d| j¡ t| jddddddd}zh| ¡ }|dkr:qz| j |¡ W q( tt fk
|
r } z |
|
d|j |j |f ¡ W 5 d}~X Y q(X q(W 5 | ¡ X 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'r2 )Ústrip_commentsÚ skip_blanksÚ
|
join_linesÚ lstrip_wsÚ rstrip_wsZ collapse_joinNz%s, line %d: %s) r
|
Úinfor4 r ÚcloseÚreadlinerC Úprocess_template_liner Ú
|
ValueErrorr rf Ú current_line)r r4 ÚlineÚmsgr r r rV D s&
|
þ
|
þ zsdist.read_templatec C s | d¡}| j ¡ }| jjd|jd | jjd|d tjdkrFd}nd}ddd d
|
d d d g}d|d |¡|f }| jj|dd 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)ÚprefixÚwin32z/|\\ú/ZRCSZCVSz\.svnz\.hgz\.gitz\.bzrZ_darcsz(^|%s)(%s)(%s).*ú|r2 )Zis_regex) rt rK Ú get_fullnamerC Zexclude_patternÚ
|
build_baseÚsysÚplatformrl )r r Úbase_dirÚsepsZvcs_dirsZvcs_ptrnr r r rW 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')
|
rR r
|
r r5 rC rr ÚinsertÚexecuter Ú
|
write_file)r Úcontentr r r rX y s ÿ ÿzsdist.write_manifestc C s< t j | j¡sdS t| j}z | ¡ }W 5 | ¡ X |dkS )NFz+# file GENERATED by distutils, do NOT edit
|
)rO rP rQ r5 Úopenr r )r ÚfpÚ
|
first_liner r r rR s
|
|
z sdist._manifest_is_not_generatedc C sV t d| j¡ t| j4}|D ](}| ¡ }| d¡s |s:q | j |¡ q W 5 Q R X 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
|
r r5 r¢ ÚstripÚ
|
startswithrC r )r r5 r r r r rS s zsdist.read_manifestc C s® | |¡ tj||| jd ttdr4d}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ÚlinkÚhardzmaking hard links in %s...Nzcopying files to %s...z)no files to distribute -- empty manifest?z#'%s' not a regular file -- skipping)rª )Úmkpathr Ú create_treer© ÚhasattrrO r
|
r r rP rQ rl Ú copy_filerK ÚmetadataÚwrite_pkg_info)r r rr rª r Ú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¡¡¡ | 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()'.
|
Útar)r r; r< r Ú r¨ N)rK r rO rP rl r9 r´ rC rr r r ÚpopÚindexÚ make_archiver; r< Ú
|
dist_filesr: r8 r Ú remove_treer© )r r Ú base_namer: Úfmtr² r r r rG Ì 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__Ú descriptionr Ú user_optionsÚboolean_optionsr Ú help_optionsÚ negative_optÚ sub_commandsrh r= rA rI rN rF rU Ú staticmethodrg rY rZ r[ r\ r] r^ r_ rV rW rX rR rS r´ rG r¾ r r r r r $ sp Ý' þ ÿÿÿ
|
(
|
* r )Ú__doc__rO r r Úwarningsr Údistutils.corer Ú distutilsr r r Údistutils.text_filer Údistutils.filelistr r
|
Údistutils.utilr Údistutils.errorsr r r r r r r r Ú<module> s
|
