wd? fd
Zd=dZ d@d Z
d Z dAd"Z dBd%Z
d& ZdCdD fd)
ZdEd+ZdFd-ZdFd.Zd=d/Zd=d0ZdGd5Zd=d6Zd7 Zd8 ZdHd9Zd: ZedId< Z xZ S )Jbuild_pyaX Enhanced 'build_py' command that includes data files with packages
The data files are specified via a 'package_data' argument to 'setup()'.
See 'setuptools.dist.Distribution' for more details.
Also, this version of the 'build_py' command allows you to specify both
'py_modules' and 'packages' in the same setup operation.
r distributionFbool
editable_modeNzStrPath | Noneexisting_egg_info_dirr r c t j | | j j | _ | j j pi | _ d| j v r
| j d= d S d S )N
data_files)origr finalize_optionsr package_dataexclude_package_data__dict__selfs r r' zbuild_py.finalize_options. s^
&&t,,, - :$($5$J$Pb! 4= ( (
l+++ ) (r T infiler outfiler
preserve_modepreserve_timeslink
str | Nonelevelobjecttuple[StrPathT | str, bool]c |r\t t | }t t | }t |||||| S r )strr resolvesuper copy_file)r, r. r/ r0 r1 r2 r4 __class__s r r; zbuild_py.copy_file5 st 3f --//00F$w--//1122Gww G]ND%
r c 0 | j s| j r| j rdS | j r| | j r(| | | t j | d dS )z?Build modules, packages, and copy data files to build directoryNF)include_bytecode)
py_modulespackagesr"
build_modulesbuild_packagesbuild_package_data byte_compiler& r get_outputsr+ s r runz build_py.runF s 4= T5G F ? ! = & ! ! ! # # % % %
$-33D53QQRRRRRr attrr8 r c |dk r | | _ | j S t j | | S )zlazily compute data filesr% )_get_data_filesr% r& r __getattr__)r, rG s r rJ zbuild_py.__getattr__W s@ < " 2 2 4 4DO? "}((t444r c | | t t | j | j pd S )z?Generate list of '(package,src_dir,build_dir,filenames)' tuples )analyze_manifestlistmap_get_pkg_data_filesr@ r+ s r rI zbuild_py._get_data_files^ s6 C0$-2E2FFGGGr %list[tuple[str, str, str, list[str]]]c | j di t t | j | j pd S )z
Generate list of ``(package,src_dir,build_dir,filenames)`` tuples,
but without triggering any attempt to analyze or build the manifest.
manifest_filesrL )r*
setdefaultrN rO rP r@ r+ s r get_data_files_without_manifestz(build_py.get_data_files_without_manifestc s?
!12666C0$-2E2FFGGGr package tuple[str, str, str, list[str]]c | | t j j | j g| d z }fd| | D }|||fS )N.c P g | ]"}t j | #S rL )r pathrelpath).0filesrc_dirs r
z0build_py._get_pkg_data_files..u s9
GOOD' * *
r )get_package_dirr r[ join build_libsplitfind_data_files)r, rV build_dir filenamesr_ s @r rP z build_py._get_pkg_data_filesm s &&w// GLDN#3gmmC6H6H#HJ
,,Wg>>
I55r c | | j ||t }t t t
d | }t j | }t t j j | }t
j | j
|g | }| ||| S )z6Return filenames for package's data files in 'src_dir')extra_patternsT) recursive)_get_platform_patternsr( _IMPLICIT_DATA_FILESrO r r itertoolschain
from_iterablefilterr r[ isfilerS getexclude_data_files)r, rV r_ patternsglobs_expanded
globs_matches
glob_filesfiless r re zbuild_py.find_data_files{ s .. / /
WTT : : :HEE!55nEE
BGNM::
# #GR 0 0
&&w???r r> list[str]c | j r3t | S t | S )1See :class:`setuptools.commands.build.SubCommand`)r" rN get_output_mappingkeysr: rE )r, r> r< s r rE zbuild_py.get_outputs sM ://11668899 9ww""#3444r dict[str, str]c t j | | }t t |t
j d S )r{ r )key)rm rn _get_package_data_output_mapping_get_module_mappingdictsortedoperator
itemgetter)r, mappings r r| zbuild_py.get_output_mapping sY / 1 1 3 3 $ $ & &
F7(;A(>(>???@@@r Iterator[tuple[str, str]]c # K | D ]=\ }}}| d }| | j || }||fV >dS )z5Iterate over all modules producing (dest, src) pairs.rY N)find_all_modulesrd get_module_outfilerc )r, rV module module_filefilenames r r z build_py._get_module_mapping sp ,0,A,A,C,C * * (GV[ mmC((G..t~wOOH[) ) ) ) ) * *r c # K | j D ]R\ }}}}|D ]H}t j || }t j || }||fV ISdS )z6Iterate over package data producing (dest, src) pairs.N)r% r r[ rb )r, rV r_ rf rg r r srcfiles r r z)build_py._get_package_data_output_mapping s| 6:o ( ( 2GWi %
(
( i:: ',,w99 w'''''
( ( (r c | D ]_\ }}| t j | | || \ }}t
| `dS )z$Copy data files into build directoryN)r mkpathr r[ dirnamer; r )r, r r _outf_copieds r rC zbuild_py.build_package_data ss # D D F F " "OFG KK// 0 0 0 !^^GV < . s- BBBQBRW%%a((BBBr c 3 K | ]}|vV d S r rL )r] r norm_paths r z/build_py._filter_build_files.. s( -T-TQay.@-T-T-T-T-T-Tr N) r rc
build_temp
build_baser r[ r isabsall)r, rx r r
build_dirs norm_dirsr^ r s @r r z build_py._filter_build_files s **733 0@%BRS
BB*BBB D((..I7==&&
#-T-T-T-T)-T-T-T*T*T
r c d S r rL r+ s r get_data_fileszbuild_py.get_data_files s r c | j | S # t $ r Y nw xY wt j | || }|| j |< |r | j j s|S | j j D ]"}||k s| |dz r n#|S t |d 5 }| }ddd n # 1 swxY w Y d|vr#t j d| d |S )z8Check namespace packages' __init__ for declare_namespacerY rbNs declare_namespacezNamespace package problem: z is a namespace package, but its
__init__.py does not call declare_namespace()! Please fix it.
(See the setuptools manual under "Namespace Packages" for details.)
")
packages_checkedKeyErrorr& r
check_packager namespace_packages
startswithopenread distutilserrorsDistutilsError)r, rV package_dirinit_pypkgr contentss r r zbuild_py.check_package sl (1 1 D ---dG[II)0 g& d / B N$7 Cg~~ #
!>!>~ N
'4
AvvxxH x / /"118g 8 8 8
s
B<<C C c n i | _ t j | d| _ d | _ d S )NF)r r& r initialize_optionsr" r# r+ s r r zbuild_py.initialize_options s6 "
((... "%)"""r c t j | | }| j j *t
j | j j | S |S r )r& r ra r src_rootr r[ rb )r, rV ress r ra zbuild_py.get_package_dir sF m++D':: % 17<< 1 :C@@ @
r c ( t | | j || }fd|D }t j | }t
| fdD }t t | S )z6Filter filenames for package's data files in 'src_dir'c 3 B K | ]}t j | V d S r )fnmatchrp )r] patternrx s r r z.build_py.exclude_data_files..$ s/ OO7ug66OOOOOOr c 3 $ K | ]
}|v|V d S r rL )r] fnbads r r z.build_py.exclude_data_files..( s' 77"3 2 77r )rN rk r) rm rn ro setr
) r, rV r_ rx rt match_groupsmatcheskeepersr s ` @r rs zbuild_py.exclude_data_files s U .. %
POOOhOOO /// =='ll7777777OG,,---r rL c t j || dg | |g }fd|D S )z
yield platform-specific path patterns (suitable for glob
or fn_match) from a glob-based spec (such as
self.package_data or self.exclude_package_data)
matching package in src_dir.
c 3 r K | ]1}t j t | V 2d S r )r r[ rb r )r] r r_ s r r z2build_py._get_platform_patterns..9 sQ
GLL,w"7"7 8 8
r )rm rn rr )specrV r_ ri raw_patternss ` r rk z build_py._get_platform_patterns, sh ! HHR HHWb ! !
(
r r r )TTNr- )r. r r/ r
r0 r! r1 r! r2 r3 r4 r5 r r6 )rG r8 r r )r rQ )rV r8 r rW )T)r> r! r ry )r r~ )r r )rx r r r r r )rV r8 r r8 )rL ) __name__
__module__ __qualname____doc____annotations__r" r# r' r; rF rJ rI rU rP re rE r| r r rC rM r r r r ra rs staticmethodrk
__classcell__)r< s @r r r s6 M ,00000, , , , # #
"S S S S"5 5 5 5H H H
H H H H 6 6 6 6 @ @ @$5 5 5 5 5 5 5 A A A A* * * *( ( ( (" " " "'M 'M 'M 'MR *
<* * * . . .
\
r r c t j | s| S ddlm} t j d | z } || )Nr )DistutilsSetupErrorz
Error: setup script specifies an absolute path:
%s
setup() arguments must *always* be /-separated paths relative to the
setup.py directory, *never* absolute paths.
)r r[ r distutils.errorsr textwrapdedentlstrip)r[ r msgs r r r @ sp
7== 444444
&((
c
"
""r c H e Zd ZdZ G d de Zd dZd Zd Zd Z d
S ) r z>Inform users that package or module is included as 'data file'c e Zd ZdZdZdS )!_IncludePackageDataAbuse._WarningzU
Package {importable!r} is absent from the `packages` configuration.
a|
############################
# Package would be ignored #
############################
Python recognizes {importable!r} as an importable package[^1],
but it is absent from setuptools' `packages` configuration.
This leads to an ambiguous overall configuration. If you want to distribute this
package, please make sure that {importable!r} is explicitly added
to the `packages` configuration field.
Alternatively, you can also rely on setuptools' discovery methods
(for example by using `find_namespace_packages(...)`/`find_namespace:`
instead of `find_packages(...)`/`find:`).
You can read more about "package discovery" on setuptools documentation page:
- https://setuptools.pypa.io/en/latest/userguide/package_discovery.html
If you don't want {importable!r} to be distributed and are
already explicitly excluding {importable!r} via
`find_namespace_packages(...)/find_namespace` or `find_packages(...)/find`,
you can try to use `exclude_package_data`, or `include-package-data=False` in
combination with a more fine grained `package-data` configuration.
You can read more about "package data files" on setuptools documentation page:
- https://setuptools.pypa.io/en/latest/userguide/datafiles.html
[^1]: For Python, any directory (with suitable naming) can be imported,
even if it does not contain any `.py` files.
On the other hand, currently there is no concept of package data
directory, all directories are treated like packages.
N)r r r _SUMMARY_DETAILSrL r r _Warningr X s " r r r r c B t t | _ d S r )r r8 _already_warnedr+ s r __init__z!_IncludePackageDataAbuse.__init__ s "3xzz r c | d o)|d t d S )Nz.py)endswithlen isidentifier)r, r^ s r r z"_IncludePackageDataAbuse.is_module s6 }}U##J]E
{](;(H(H(J(JJr c t | j }t t j t
j |j }|rd |g| S d S )NrY ) r parentrN rm takewhiler8 r partsrb )r, r r^ r r s r r z._IncludePackageDataAbuse.importable_subpackage sV 4jj Y()939EEFF .88V ,e ,-- -tr c || j vr7| j | | j | d S d S )N)r )r r emitadd)r, r s r r z _IncludePackageDataAbuse.warn sN T 1 1 1 M * 5 5 5 $ $Z 0 0 0 0 0 2 1r Nr )
r r r r r r r r r r rL r r r r U s HH' ' ' ' ' / ' ' ' V* * * *K K K 1 1 1 1 1r r r )'
__future__r r rm r r r r collections.abcr r functoolsr r pathlibr typingr more_itertoolsr
_pathr r
distr warningsr distutils.command.build_pycommandr r& r r distutils.utilr rl r r r rL r r r s " " " " " " . . . . . . . . * * * * * * % % % % % % % % 3 3 3 3 3 3 ) ) ) ) ) ) ) ) ) ' ' ' ' ' ', > > > >]
]
]
]
]
t} ]
]
]
@ # # #*>1 >1 >1 >1 >1 >1 >1 >1 >1 >1r