2bi6 S r SSKrSSKrSSKrSSKrSSKJrJrJrJ r J
r
J r J r SSK
JrJr SSKJr SSKJr SSKJr SSKJrJr \R2 r\
" S \5 r\( a S
OS r S r \" S
SSSSS9r \ R> \ R@ \ RB \ RD \ RF 4r$\ R@ \ R> \ RB 4r%\" \&5 r'S\S\4S jr(S\S\ \ 4S jr)S\\\ \ 4 4S jr* " S S5 r+g)a Configuration management setup
Some terminology:
- name
As written in config files.
- value
Value associated with a name
- key
Name combined with it's section (section.name)
- variant
A single word describing where the configuration key-value pair came from
N)AnyDictIterableListNewTypeOptionalTuple)ConfigurationError!ConfigurationFileCouldNotBeLoaded)appdirs)WINDOWS) getLogger)
ensure_direnumKindzpip.inizpip.conf)versionhelpuserglobalsiteenvzenv-var)USERGLOBALSITEENVENV_VARnamereturnc | U R 5 R SS5 n U R S5 ( a U SS n U $ )zAMake a name consistent regardless of source (environment or file)_-z-- N)lowerreplace
startswith)r s ڍ/builddir/build/BUILDROOT/alt-python313-pip-23.3.1-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/pip/_internal/configuration.py_normalize_namer' 2 s9 ::< S )D t ABx K c j SU ; a SR U 5 n[ U5 eU R SS5 $ )N.zbKey does not contain dot separated section and key. Perhaps you wanted to use 'global.{}' instead? )formatr
split)r
error_messages r& _disassemble_keyr/ : s:
$
=
&, ! // ::c1 r( c v [ R " S5 V s/ s H' n [ R R U [
5 PM) nn [ R R [ R [
5 n[ R R [ R R S5 [ ( a SOS[
5 n[ R R [ R " S5 [
5 n[ R U[ R U/[ R X4/0$ s sn f )Npip~z.pip)r site_config_dirsospathjoinCONFIG_BASENAMEsysprefix
expanduserr
user_config_dirkindsr r r )r5 global_config_filessite_config_filelegacy_config_filenew_config_files r& get_configuration_filesrA D s 8?8P8PQV8W8W T?+8W ww||CJJ@
3 f
ggll7#:#:5#A?SO
)
%&
'9 s .D6c ^ \ rS rSrSrS$S\S\\ SS4U 4S jjjrS%S jr S\\
4S jr S\ \
\
\4 4S
jrS \
S\4S jrS \
S
\SS4S jrS \
SS4S jrS%S jrS%S jr\S\\
\4 4S j5 rS%S jrS\S\
S\4S jrS\
S\4S jrS%S jr S\
S\ \
\
\4 S\\
\4 4S jr S\ \
\
\
4 4S jr S\ \
\\ \
4 4S jr S\S\\
\4 4S jr!S\
\
\4 4S jr"S\
S \SS4S! jr#S\
4S" jr$S#r%U =r&$ )&
ConfigurationW a Handles management of configuration.
Provides an interface to accessing and managing configuration files.
This class converts provides an API that takes "section.key-name" style
keys and stores the value associated with it as "key-name" under the
section "section".
This allows for a clean interface wherein the both the section and the
key-name are preserved in an easy to manage form in the configuration files
and the data stored is also nice.
Nisolated load_onlyr c
\ > [ TU ] 5 UbE U[ ; a; [ SR SR [
[ [ 5 5 5 5 eXl X l [ Vs0 s H o3/ _M snU l [ Vs0 s H o30 _M snU l / U l
g s snf s snf )Nz5Got invalid value for load_only - should be one of {}z, )super__init__VALID_LOAD_ONLYr
r, r6 mapreprrE rF OVERRIDE_ORDER_parsers_config_modified_parsers)selfrE rF variant __class__s r& rI Configuration.__init__e s
Yo%E$GNNIIc$ 89
!
" (6H
'5GRK~H
(64
'5GRK~4
EG
H
4
s , B$ B)c h U R 5 U R ( d U R 5 gg)z>2 2$~hZ%@A A 224
,S 1MG""7++0D0DW0S0S )J
<<((%%g. " "5 1 LL ( -r( c U R 5 U R Hj u p[ R SU5 [ [
R R U5 5 [ US5 nUR U5 SSS5 Ml g! , ( d f M~ = f! [ a n[ SU SU 35 eSnAff = f)z!Save the current in-memory state.z
Writing to %swNz:An error occurred while writing to the configuration file z: ) rm rP loggerinfor r4 r5 dirnameopenwriteOSErrorr
)rQ rr rs ferrors r& saveConfiguration.save s ##% ! 3 3ME KK /
rwwu- .
%%LLO &% 4 &%
(P gRw(
s6 ! B -B ?B
B B B
B>(B99B>c t U R c [ S5 e[ R SU R 5 g )Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rF r
r~ debugrX s r& rm $Configuration._ensure_have_load_only s+ >> !$%NO O ;T^^Lr( c ` 0 n[ H! nUR U R U 5 M# U$ )z3A dictionary representing the loaded configuration.)rM updaterO )rQ retvalrR s r& ra Configuration._dictionary s/
%G MM$,,w/ 0 &
r( c [ U R 5 5 nU[ R SS [ R
/:X a [ R S5 gUR 5 Hr u p#U Hg nU R b' X R :w a [ R SXB5 M7 U R X$5 nU R U R XE45 Mi Mt g)z,Loads configuration from configuration filesr r+ zZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s))
dictiter_config_filesr< r r4 devnullr~ r rb rF
_load_filerN append)rQ config_filesrR filesrr rs s r& rV Configuration._load_config_files s D 2 2 45 "1Q 'BJJ< 7 LLA
* 0 0 2NG >>-'^^2KLL!CUT 8
g&--uo> 3r( rR rr c [ R SX5 U R U5 nUR 5 HA nUR U5 nU R
U R
U R XE5 5 MC U$ )Nz'For variant '%s', will try loading '%s')r~ verbose_construct_parsersectionsrb rO r _normalized_keys)rQ rR rr rs rt rb s r& r Configuration._load_file si @'Q''. (GLL)E LL ! ( ()>)>w)N O )
r( c @ [ R " 5 n[ R R U5 ( a( [
R " S5 n UR XS9 U$ U$ ! [ a [ SU S3US9e[ R a n[ US9eS nAff = f)NF)encodingzcontains invalid z characters)reasonrr )r ) configparserRawConfigParserr4 r5 existslocalegetpreferredencodingreadUnicodeDecodeErrorr Error)rQ rr rs locale_encodingr s r& r Configuration._construct_parser s --/
77>>% $ 9 9% @O
E E <
v
&
7 ..?{K %%
E7eDD
Es A$ $+B BB c U R [ R R U R SU R 5 5 5 g)z.Loads configuration from environment variablesz:env:N)rO r< r r r get_environ_varsrX s r& rW $Configuration._load_environment_vars* s6 U]]#** ! !'4+@+@+B C
r( rt rb c J 0 nU H u pEUS- [ U5 - nXSU' M U$ )zNormalizes items to construct a dictionary with normalized keys.
This routine is where the names become keys and are made the same
regardless of source - configuration files or environment.
r* )r' )rQ rt rb
normalizedr valrd s r& r Configuration._normalized_keys0 s7
IDC-/$"77C !sO r( c # # [ R R 5 HA u pUR S5 ( d M USS R 5 nU[
; d M< X24v MC g7f)z@Returns a generator with all environmental vars with prefix PIP_PIP_ N)r4 environrb r% r# ENV_NAMES_IGNORED)rQ rd r r s r& r Configuration.get_environ_vars> sN
((*HC~~f%%12w}} 00 )O +s 8A'A'
A'c # 0 # [ R R SS5 nUb [ R U/4v O[ R / 4v [ 5 n[ R U[ R 4v U R ( + =( a- U=( a [ R R U5 ( + nU( a% [ R U[ R 4v [ R U[ R 4v g7f)zoYields variant and configuration files associated with it.
This should be treated like items of a dictionary.
PIP_CONFIG_FILEN) r4 r getr< r rA r rE r5 r r r )rQ config_filer should_load_user_configs r& r Configuration.iter_config_filesG s jjnn%6= "))k]* *))R- .0 llL 666 '+mm"3 #
7BGGNN; 79
#**l5:: 66 6 jj,uzz222s DDc U R U $ )z#Get values present in a config file)rO )rQ rR s r& get_values_in_config"Configuration.get_values_in_confige s ||G$$r( c U R ( d eU R U R nU( d [ S5 eUS $ )Nz4Fatal Internal error [id=2]. Please report as a bug.)rF rN r
)rQ parserss r& r\ #Configuration._get_parser_to_modifyi s? ~~ ~--/$F
r{r( rs c ` X4nX0R ; a U R R U5 g g N)rP r )rQ rr rs file_parser_tuples r& rq Configuration._mark_as_modifiedw s0 "O $:$: : " " ) )*; < ;r( c P U R R SU R < S3$ )N())rS __name__ra rX s r& __repr__Configuration.__repr__| s' ..))*!D,<,<+?qAAr( )rO rP rN rE rF r )r N)'r
__module__ __qualname____firstlineno____doc__boolr r rI rY strr^ r r r rb ri ru rz r rm propertyr ra rV r r r rW r r r r r r\ rq r __static_attributes__
__classcell__)rS s @r& rC rC W s G G(4. GD G G** (3- (xc3h0 (
BS
BS
B.S . . .&.s .t .:0M
T#s(^ ?.$ s s *
#+E#s(O#<
c3h $(5c?"; $ 38E$S /,B#C 3<%D %T#s(^ % uS/-A'B =s =O = =
B# B Br( rC ),r r r r4 r8 typingr r r r r r r pip._internal.exceptionsr
r pip._internal.utilsr pip._internal.utils.compatr
pip._internal.utils.loggingr pip._internal.utils.miscr r r r r r7 r r< r r r r r rM rJ r r~ r' r/ rA rC r( r& r s
F F F ( . 1 5 ..vs &)J%
uzz5::uyy%--O**ellEJJ6 8 # # 3 49 dDIo!6 &fB fBr(