+ eim#csa0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI H t ^RIHt^RIHtHtHt^RIHt^RIHt]P0!]4t]P6!R4tRtR ]R &!R R ]P>4t !R R] R7t!!RR4t"!RR]"4t#RRlt$]RRl4t%!RR4t&R#)z Keyring implementation support ) annotationsN) ExceptionTrap)once) credentialserrorsutil) properties)metadatapriorityz.typing.Callable[[KeyringBackend], bool] | None_limitcs8a]tRt^tRtV3RltRtRtRtV;t #)KeyringBackendMetaz} Specialized subclass behavior. Keeps a registry of all (non-abstract) types. Wraps set_password to validate the username. c sh<\SV`WV4VP4VP4R#N)Zsuper__init__ _register"_validate_username_in_set_password)clsnameZbasesdict __class__s&&&&4/usr/lib/python3.14/site-packages/keyring/backend.pyr ZKeyringBackendMeta.__init__'s' d+  ..0c s\VR4'g\4VnVPpVP'gVP V4R#R#)_classesN)ZhasattrZsetrZ__abstractmethods__Zadd)rZclasses& rr ZKeyringBackendMeta._register,s>sJ''5CL,,&&& KK 'rc sjaVPo\P!S4V3Rl4pWnR#)z= Wrap ``set_password`` such to validate the passed username. cs@<VPV4S!WV.VO5/VB#r )_validate_username)selfZsystemusernameZargskwargsorigs&&&*,rwrapperZFKeyringBackendMeta._validate_username_in_set_password..wrapper9s(  # #H -h@@@ @rN) set_password functoolsZwraps)rrrs& @rrZ5KeyringBackendMeta._validate_username_in_set_password3s5   A  A#r) __name__ __module__ __qualname____firstlineno____doc__r r r__static_attributes__Z __classcell__)r@rr r s1  # #rr csv]tRt^AtRtRt]PRRl4t] !4Pt ]P] R44t ] RRl4t ]PRR l4tR R lt]P"R R l4tRRlt]P"RRl4tRRltRRltRRltRRltRtR#)KeyringBackendzUThe abstract base class of the keyring, every backend must implement this interface. c s&VP4R#r )set_properties_from_envr&rr ZKeyringBackend.__init__Fs $$&rcV^8dQhRR/#)returnZfloatrZformat"r __annotate__KeyringBackend.__annotate__Js""%"rc s\h)ae Each backend class must supply a priority, a number (float or integer) indicating the priority of the backend relative to all other backends. The priority need not be static -- it may (and should) vary based attributes of the environment in which is runs (platform, available packages, etc.). A higher number indicates a higher priority. The priority should raise a RuntimeError with a message indicating the underlying cause if the backend is not suitable for the current environment. As a rule of thumb, a priority between zero but less than one is suitable, but a priority of one or greater is recommended. )ZNotImplementedErrorr)r*rrZKeyringBackend.priorityIs "!rc sVPR#r )rrr*rviableZKeyringBackend.viable^s  rc V^8dQhRRRR/#)r,rztype[KeyringBackend]r-zfilter[type[KeyringBackend]]rr.r/rr0r1ds CC !C %Crc sV\\P!R4VP4#)z& Return all subclasses deemed viable. r3)filteroperator attrgetterrr2r*rget_viable_backendsZ"KeyringBackend.get_viable_backendscs h))(3S\\BBrcr+r,r-strrr.r/rr0r1ms 2 2S 2rc sVPPR4wrpVPRR4pRPW0P.4#)zZ The keyring name, suitable for display. The name is derived from module and class name. .Z_Z )r!Z rpartitionZreplaceZjoinr )rZparentsepZmod_names& rrZKeyringBackend.namelsE!$ 9 9# >X##C-xx<<011rcr+r9rr.r/rr0r1xsmmmrc sl\V4pVP RVP RVPR R2#)r;z (priority: ZgZ))Ztyper!r r)rZ keyring_classrr__str__ZKeyringBackend.__str__xs>T **+1]-C-C,DLQ^QgQghiPjjkllrc$V^8dQhRRRRRR/#)r,servicer:rr- str | Nonerr.r/rr0r1}s!C3:rc R#)z,Get password of the username for the serviceNrrr?r&&&r get_passwordZKeyringBackend.get_password|srcr4)r,rr:r-Nonerr.r/rr0r1s  3 4 rc sTV'g \P!R\^R7R#R#)z# Ensure the username is not empty. z(Empty usernames are deprecated. See #668)Z stacklevelN)warningsZwarnZDeprecationWarning)rr&&rrZ!KeyringBackend._validate_usernames! MM:" rcs(V^8dQhRRRRRRRR/#)r,r?r:rpasswordr-rErr.r/rr0r1s(00C030#0$0rc .\P!R4h)znSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rZPasswordSetErrorrr?rrHs&&&&rrZKeyringBackend.set_passwords%%h//rcr>)r,r?r:rr-rErr.r/rr0r1s!33s3c3d3rc rI)zyDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. rJ)rZPasswordDeleteErrorrBrCrdelete_passwordZKeyringBackend.delete_passwords ((22rcs$V^8dQhRRRRRR/#)r,r?r:rr@r-zcredentials.Credential | Nonerr.r/rr0r1s( ' rc sdVe,VPW4pVe\P!W#4#R#)zGets the username and password for the service. Returns a Credential instance. The *username* argument is optional and may be omitted by the caller or ignored by the backend. Callers must use the returned username. N)rDrZSimpleCredentialrKs&&& rget_credentialZKeyringBackend.get_credentials4  ((;H#"33HGGrcr+r,r-rErr.r/rr0r1s ' ' 'rc sRRlp\R\V\PP 444pVFwr4\ WV4K R#)z6For all KEYRING_PROPERTY_* env var, set that property.cr+)r,itemztuple[str, str]rr.r/rr0Z.__annotate__s 1 1 1rcsjVwrVPR4wr4pT;'dVP4V3#)ZKEYRING_PROPERTY_)Z partitionZlower)rOZkeyvalueZprer<rs& rparseZ5KeyringBackend.set_properties_from_env..parses5JC ]]+>?NCd00DJJL%0 0rN)r5ZmaposZenvironZitemsZsetattr)rrQZpropsrrPs& rr(Z&KeyringBackend.set_properties_from_envs? 1 *0c%AQAQAS6T)U KD D &!rcr4)r,r typing.Anyr-r'rr.r/rr0r1s ~rc sf\P!V4p\V4PV4V#r )copyZvarsZupdate)rrZalts&, rwith_propertiesZKeyringBackend.with_propertiess&iio S   rrN)r r!r"r#r$r rZ classpropertyrrZpassesr3Z classmethodr8rr=abcabstractmethodrDrrrLrMr(rUr%rrrr'r'As'""$_ # #F  CC 2 2m   003& 'rr')Z metaclasscsb]tRt^tRt]P R4t]P R4tRt R#)Crypterz.Base class providing encryption and decryptionc rA)zEncrypt the value.NrrrPrGrencryptZCrypter.encrypt rc rA)zDecrypt the value.NrrYrGrdecryptZCrypter.decryptr[rrN) r r!r"r#r$rVrWrZr\r%rrrrXrXs78     rrXcs&]tRt^tRtRtRtRtR#) NullCrypterzA crypter that does nothingc V#r rrYrGrrZZNullCrypter.encrypt rc r^r rrYrGrr\ZNullCrypter.decryptr_rrN)r r!r"r#r$rZr\r%rrrr]r]s%rr]cr+rNrr.r/rr0r0s>>t>rcs.\P!RR7FNp\PRVP4VP 4p\ V4'd V!4KNKP R# \d\PRT R24K{i;i)a Locate all setuptools entry points by the name 'keyring backends' and initialize them. Any third-party library may register an entry point by adding the following to their setup.cfg:: [options.entry_points] keyring.backends = plugin_name = mylib.mymodule:initialize_func `plugin_name` can be anything, and is only used to display the name of the plugin at initialization time. `initialize_func` is optional, but will be invoked if callable. zkeyring.backends)Zgroupz Loading %szError initializing plugin r;N) rZ entry_pointslogZdebugrZloadZcallableZ ExceptionZ exception)ZepZ init_func r _load_pluginsrbsx ##*<= > IIlBGG , I "" # >  > MM6rd!< = >sAA,,$BBcr+)r,r-zlist[KeyringBackend]rr.r/rr0r0s-rcs\4\P4p\P!V\ R7p\ V4#)zW Return a list of all implemented keyrings that can be constructed without parameters. )Z exceptions)rbr'r8rZsuppress_exceptionsZ TypeErrorZlist)Zviable_classesZringsrarget_all_keyringrcs3 O#779N  $ $^ JE ;rcsb]tRtRtRtRt]!]!RRR7]!RRR7R 7tRR R lltR t R #)SchemeSelectableia Allow a backend to select different "schemes" for the username and service. >>> backend = SchemeSelectable() >>> backend._query('contoso', 'alice') {'username': 'alice', 'service': 'contoso'} >>> backend._query('contoso') {'service': 'contoso'} >>> backend.scheme = 'KeePassXC' >>> backend._query('contoso', 'alice') {'UserName': 'alice', 'Title': 'contoso'} >>> backend._query('contoso', 'alice', foo='bar') {'UserName': 'alice', 'Title': 'contoso', 'foo': 'bar'} defaultrr?)rr?ZUserNameZTitle)reZ KeePassXCNcs(V^8dQhRRRRRRRR/#) r,r?r:rr@baserSr-zdict[str, str]rr.r/rr0ZSchemeSelectable.__annotate__s,   &0 AK  rc sVPVP,p\VeVR,VVR,V/M VR,V/3/VB#)Nrr?)schemesschemer)rr?rrfrhs&&&, r_queryZSchemeSelectable._querysadkk* #z"Hy!7  y!7    rrr ) r r!r"r#r$rhrrgrir%rrrrdrds6 Fj)< G<G   rrd)'__conditional_annotations__r$Z __future__rrVrTrZloggingr6rRZtypingrFZjaraco.contextrZjaraco.functoolsrZrrrZcompatrZ compat.py312rZ getLoggerr r`r7Z by_priorityr Z__annotations__ZABCMetar r'rXr]rbrcrd)rjr&rrks#  (!''" !!!*- 9=6= # #FE1EP   '>4% % r