!A?h=J d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
ddlm Z dd l m
Z
dd
lmZ dd lmZ dd lmZ dd
lmZmZ d Z G d 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)DistutilsTemplateErrorDistutilsOptionErrorc ddl m} ddlm} g }| D ])}| d|z d|| d f *| | | d dS )zoPrint all possible values for the 'formats' option (used by
the "--help-formats" command-line option).
r ) FancyGetopt)ARCHIVE_FORMATSformats=N z.List of available source distribution formats:)distutils.fancy_getoptr distutils.archive_utilr keysappendsort
print_help)r r formatsformats D/opt/alt/python-internal/lib64/python3.11/distutils/command/sdist.py show_formatsr s 322222666666G!&&(( 5 5
V+T'/24 5 5 5 5 LLNNNK##8: : : : : c e Zd ZdZd Zg dZg dZdddefgZdd d
Z d efgZ
d Z d
Z d Z
d Zd Zd Zd Zed Zd Zd Zd Zd Zd Zd Zd Zd Zd Z d Z d Z d Z d Z d! Z!d" Z"dS )#sdistz6create a source distribution (tarball, zip file, etc.)c | j S )zYCallable used for the check sub-command.
Placed here so user_options can view it)metadata_checkselfs r checking_metadatazsdist.checking_metadata( s
""r ))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-onlyozEjust regenerate the manifest and then stop (implies --force-manifest))force-manifestfzkforcibly regenerate the manifest and carry on as usual. Deprecated: now the manifest is always regenerated.)r Nz6formats for source distribution (comma-separated list)) keep-tempkz@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. r0 r3 z help-formatsNz#list available distribution formatsr( r* )r) r+ check)READMEz
README.txtz
README.rstc d | _ d | _ d| _ d| _ d| _ d| _ dg| _ d| _ d | _ d | _ d| _
d | _ d | _ d S )N r gztar)
templatemanifest use_defaultsr*
manifest_onlyforce_manifestr keep_tempdist_dir
archive_filesr" ownergroupr# s r initialize_optionszsdist.initialize_optionse sl
y
!
r c | j d| _ | j d| _ | d t j | j }|rt
d|z | j d| _ d S d S )NMANIFESTz MANIFEST.inr zunknown archive format '%s'dist)r< r; ensure_string_listr check_archive_formatsr r rA )r$
bad_formats r finalize_optionszsdist.finalize_options| s = &DM = )DM ***!7 EE
>&/*<> >
> = "DMMM ! r c t | _ | D ]}| | | | j rd S | d S N)r
filelistget_sub_commands run_command
get_file_listr> make_distribution)r$ cmd_names r runz sdist.run s !
--// ' 'H X & & & &
F
r c t dt | j d }| | dS )zDeprecated API.zadistutils.command.sdist.check_metadata is deprecated, use the check command insteadr6 N)r PendingDeprecationWarning distributionget_command_objensure_finalizedrU )r$ r6 s r check_metadatazsdist.check_metadata sX -.G I I I!11'::
r c t j | j }|s\| rH| | j | j dS |s | d| j z | j
| j r| |r|
| j r| | 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))ospathisfiler; _manifest_is_not_generated
read_manifestrO r remove_duplicatesr findallr= add_defaults
read_templater* prune_file_listwrite_manifest)r$ template_existss r rR zsdist.get_file_list sI '.. 77 4#B#B#D#D M M + + - - - F ' II 4
&
'
'
'
! : # " " "
''))) r c | | | | | | | 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# s r rd zsdist.add_defaults s
$$&&& ##%%% !!### %%''' !!### ""$$$$$r c t j | sdS t j | }t j | \ }}|t j | v S )z
Case-sensitive path existence check
>>> sdist._cs_path_exists(__file__)
True
>>> sdist._cs_path_exists(__file__.upper())
False
F)r] r^ existsabspathsplitlistdir)fspathrs directoryfilenames r _cs_path_existszsdist._cs_path_exists s_ w~~f%% 5'//&)) gmmG 4 4 82:i0000r c | j | j j g}|D ]}t |t rj|}d}|D ]5}| | r d}| j | n6|s+| dd | z | | r| j | | d|z d S )NFTz,standard file not found: should have one of z, z standard file '%s' not found)
READMESrX script_name
isinstancetuplery rO r r join)r$ standardsfnaltsgot_its r rj z sdist._add_defaults_standards s \4#4#@A C CB"e$$
C B++B// !%
,,R000
/II L "iioo . / / / ''++ CM((,,,,II <r ABBBB# C Cr c ddg}|D ]H}t t j j t | }| j | Id S )Nz
test/test*.pyz setup.cfg)filterr] r^ r_ r rO extend)r$ optionalpatternfiless r rk z sdist._add_defaults_optional sW #[1 ( (G27>4==99E M ' ' ' ' ( (r c R | d }| j r,| j | |j D ]D\ }}}}|D ]:}| j t j
|| ;Ed S )Nbuild_py) get_finalized_commandrX has_pure_modulesrO r get_source_files
data_filesr r] r^ r )r$ r pkgsrc_dir build_dir filenamesrx s r rl zsdist._add_defaults_python s --j99 - - / / > M !:!:!<!< = = = 3;2E F F .C)Y %
F
F
$$RW\\'8%D%DEEEE
F F Fr c | j r| j j D ]}t |t rIt | }t j | r| j
| `|\ }}|D ]J}t | }t j | r| j
| Kd S d S rN ) rX has_data_filesr r} strr r] r^ r_ rO r )r$ itemdirnamer r/ s r rm z sdist._add_defaults_data_files$ s + + - -
4 )4
4
4 dC(( 4'--Dw~~d++ 3
,,T222 *.&GY & 4 4 (OO 7>>!,, 4 M 0 0 3 3 34
4
4
4
4r c | j rC| d }| j | d S d S )N build_ext)rX has_ext_modulesr rO r r )r$ r s r rn zsdist._add_defaults_ext5 s^ , , . . ? 22;??I M !;!;!=!= > > > > > ? ?r c | j rC| d }| j | d S d S )N
build_clib)rX has_c_librariesr rO r r )r$ r s r ro zsdist._add_defaults_c_libs: sa , , . . @ 33LAAJ M !<!<!>!> ? ? ? ? ? @ @r c | j rC| d }| j | d S d S )N
build_scripts)rX has_scriptsr rO r r )r$ r s r rp zsdist._add_defaults_scripts? sa ( ( * * C 6 6 G GM M !?!?!A!A B B B B B C Cr c t j d| j t | j dddddd } | }|n` | j | nC# t t f$ r/}| d|j
|j |fz Y d}~nd}~ww xY ww | dS # | w xY w)zRead 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'r9 )strip_comments skip_blanks
join_lines lstrip_ws rstrip_ws
collapse_joinTNz%s, line %d: %s)
r infor; r readlinerO process_template_liner
ValueErrorr rx current_lineclose)r$ r; linemsgs r re zsdist.read_templateD s( 14=AAADM!'(A*+- - -
9 ((**<9M77==== /
; 9 9 9II /83D3;3H3638 8 9 9 9 9 9 9 9 99
9
NN HNN s5 C A+ *C +B+<%B&!C &B++C C c | d }| j }| j d|j | j d| t j dk rd}nd}g d}d|d d
| d |d }| j |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)prefixwin32z/|\\/)RCSCVSz\.svnz\.hgz\.gitz\.bzr_darcsz(^|z)(|z).*r9 )is_regex) r rX get_fullnamerO exclude_pattern
build_basesysplatformr )r$ r base_dirsepsvcs_dirsvcs_ptrns r rf zsdist.prune_file_lista s **733$1133
%%d53C%DDD
%%d8%<<< <7 " "DDD *.$$0B0B0B0BDDDI
%%h%;;;;;r c | r t j d| j z dS | j j dd }| dd | t j | j |fd| j z dS )zWrite 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')
r` r r r< rO r insertexecuter
write_file)r$ contents r rg zsdist.write_manifesty s
* * , , H *,0M:
;
;
; F-%aaa(qFGGG Y)DM7+C1DMA C C C C Cr c t j | j sdS t | j } | }| n# | w xY w|dk S )NFz+# file GENERATED by distutils, do NOT edit
)r] r^ r_ r< openr r )r$ fp
first_lines r r` z sdist._manifest_is_not_generated sm w~~dm,, 5
$-
J HHJJJJBHHJJJJ KKKs A% %A;c , t j d| j t | j 5 }|D ]H}| }| d s|s.| j | I ddd dS # 1 swxY w Y dS )zRead 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 r< r strip
startswithrO r )r$ r< r s r ra zsdist.read_manifest s
-t}===
$-
+H
+
+zz||??3'' t
$$T****
+ + + + + + + + + + + + + + + + + + +s A B B
B
c ( | | t j ||| j t t
d rd}d|z }nd}d|z }|st
j d nt
j | |D ]o}t
j
| st
j d| 7t
j || }| ||| p| 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_runlinkhardzmaking 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 hasattrr] r r r r^ r_ r copy_filerX metadatawrite_pkg_info)r$ r r r r filedests r make_release_treezsdist.make_release_tree s
H XudlCCCC 2v 6D.9CCD*X5C H@ A A A A HSMMM 6 6D7>>$''
6>EEEEw||Hd33tT5555 "11(;;;;;r c | j }t j | j | }| || j j g }d| j v rJ| j
| j | j d | j D ]]}|
|||| j | j }|
| | j j
dd|f ^|| _ | j s t' j || j dS 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 rC rD r r N)rX r r] r^ r rA r rO r r r popindex make_archiverC rD
dist_filesrB r@ r remove_treer )r$ r base_namerB fmtr s r rS zsdist.make_distribution sE $1133GLL 99 x )<===
DL L 0 0 1C1CE1J1J K K L L L< E EC$$Yh+/:TZ % I ID & & & ( / /"d0C D D D D *~ A 4< @ @ @ @ @ @ A Ar c | j S )zzReturn the list of archive files created when the command
was run, or None if the command hasn't run yet.
)rB r# s r get_archive_fileszsdist.get_archive_files s
!!r )#__name__
__module__ __qualname__ descriptionr% user_optionsboolean_optionsr help_options negative_opt sub_commandsr{ rE rL rU r[ rR rd staticmethodry rj rk rl rm rn ro rp re rf rg r` ra r rS r r r r r $ s JK# # # %
%
%
LN6 6 6O
. >
L
$2 '* *L /01L4G .# # # ! ! !, & & & P% % %, 1 1 \1 C C C*( ( ( F F F 4 4 4"? ? ?
@ @ @
C C C
:< < <0
C
C
C
L
L
L + + + (< (< (<T A A A<" " " " "r r )__doc__r] r r warningsr distutils.corer distutilsr r r distutils.text_filer distutils.filelistr
r distutils.utilr distutils.errorsr
r r r r r r <module>r s> L L
" " " " " " " " " " " " ( ( ( ( ( ( ' ' ' ' ' ' ' ' ' ' ' ' I I I I I I I I : : : J" J" J" J" J"G J" J" J" J" J"r