+ Z8im#a0t$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_limitc8a]tRt^tRtV3RltRtRtRtV;t #)KeyringBackendMetaz} Specialized subclass behavior. Keeps a registry of all (non-abstract) types. Wraps set_password to validate the username. c h<\SV`WV4VP4VP4R#N)super__init__ _register"_validate_username_in_set_password)clsnamebasesdict __class__s&&&&/lib/python3.14/site-packages/keyring/backend.pyrKeyringBackendMeta.__init__'s' d+  ..0c \VR4'g\4VnVPpVP'gVP V4R#R#)_classesN)hasattrsetr__abstractmethods__add)rclassess& rrKeyringBackendMeta._register,s>sJ''5CL,,&&& KK 'rc jaVPo\P!S4V3Rl4pWnR#)z= Wrap ``set_password`` such to validate the passed username. c@<VPV4S!WV.VO5/VB#r)_validate_username)selfsystemusernameargskwargsorigs&&&*,rwrapperFKeyringBackendMeta._validate_username_in_set_password..wrapper9s(  # #H -h@@@ @rN) set_password functoolswraps)rr-r,s& @rr5KeyringBackendMeta._validate_username_in_set_password3s5   A  A#r) __name__ __module__ __qualname____firstlineno____doc__rrr__static_attributes__ __classcell__)rs@rr r s1  # #rr cv]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 &VP4R#r)set_properties_from_envr's&rrKeyringBackend.__init__Fs $$&rcV^8dQhRR/#)returnfloatr3)formats"r __annotate__KeyringBackend.__annotate__Js""%"rc \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. )NotImplementedErrorr?s&rr KeyringBackend.priorityIs "!rc VPR#r)r rs&rviableKeyringBackend.viable^s  rc V^8dQhRRRR/#)rBrztype[KeyringBackend]rCzfilter[type[KeyringBackend]]r3)rEs"rrFrGds CC !C %Crc V\\P!R4VP4#)z& Return all subclasses deemed viable. rM)filteroperator attrgetterrrLs&rget_viable_backends"KeyringBackend.get_viable_backendscs h))(3S\\BBrcV^8dQhRR/#rBrCstrr3)rEs"rrFrGms 2 2S 2rc VPPR4wrpVPRR4pRPW0P.4#)zZ The keyring name, suitable for display. The name is derived from module and class name. ._ )r5 rpartitionreplacejoinr4)rparentsepmod_names& rrKeyringBackend.namelsE!$ 9 9# >X##C-xx<<011rcV^8dQhRR/#rWr3)rEs"rrFrGxsmmmrc l\V4pVP RVP RVPR R2#)rZz (priority: g))typer5r4r )r' keyring_classs& r__str__KeyringBackend.__str__xs>T **+1]-C-C,DLQ^QgQghiPjjkllrc$V^8dQhRRRRRR/#)rBservicerXr)rC str | Noner3)rEs"rrFrG}s!C3:rc R#)z,Get password of the username for the serviceNr3r'rmr)s&&&r get_passwordKeyringBackend.get_password|src V^8dQhRRRR/#)rBr)rXrCNoner3)rEs"rrFrGs  3 4 rc TV'g \P!R\^R7R#R#)z# Ensure the username is not empty. z(Empty usernames are deprecated. See #668) stacklevelN)warningswarnDeprecationWarning)r'r)s&&rr&!KeyringBackend._validate_usernames! MM:" rc(V^8dQhRRRRRRRR/#)rBrmrXr)passwordrCrtr3)rEs"rrFrGs(00C030#0$0rc .\P!R4h)znSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr'rmr)r|s&&&&rr/KeyringBackend.set_passwords%%h//rc$V^8dQhRRRRRR/#)rBrmrXr)rCrtr3)rEs"rrFrGs!33s3c3d3rc .\P!R4h)zyDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. r~)rPasswordDeleteErrorrps&&&rdelete_passwordKeyringBackend.delete_passwords ((22rc$V^8dQhRRRRRR/#)rBrmrXr)rnrCzcredentials.Credential | Noner3)rEs"rrFrGs( ' rc dVe,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)rqrSimpleCredentialrs&&& rget_credentialKeyringBackend.get_credentials4  ((;H#"33HGGrcV^8dQhRR/#rBrCrtr3)rEs"rrFrGs ' ' 'rc RRlp\R\V\PP 444pVFwr4\ WV4K R#)z6For all KEYRING_PROPERTY_* env var, set that property.cV^8dQhRR/#)rBitemztuple[str, str]r3)rEs"rrF.__annotate__s 1 1 1rcjVwrVPR4wr4pT;'dVP4V3#)KEYRING_PROPERTY_) partitionlower)rkeyvalueprerars& rparse5KeyringBackend.set_properties_from_env..parses5JC ]]+>?NCd00DJJL%0 0rN)rQmaposenvironitemssetattr)r'rpropsrrs& rr>&KeyringBackend.set_properties_from_envs? 1 *0c%AQAQAS6T)U KD D &!rc V^8dQhRRRR/#)rBr+ typing.AnyrCr<r3)rEs"rrFrGs ~rc f\P!V4p\V4PV4V#r)copyvarsupdate)r'r+alts&, rwith_propertiesKeyringBackend.with_propertiess&iio S   rr3N)r4r5r6r7r8rr classpropertyr rpassesrM classmethodrTrrjabcabstractmethodrqr&r/rrr>rr9r3rrr<r<As'""$_ # #F  CC 2 2m   003& 'rr<) metaclasscb]tRt^tRt]P R4t]P R4tRt R#)Crypterz.Base class providing encryption and decryptionc R#)zEncrypt the value.Nr3r'rs&&rencryptCrypter.encrypt rc R#)zDecrypt the value.Nr3rs&&rdecryptCrypter.decryptrrr3N) r4r5r6r7r8rrrrr9r3rrrrs78     rrc&]tRt^tRtRtRtRtR#) NullCrypterzA crypter that does nothingc V#rr3rs&&rrNullCrypter.encrypt rc V#rr3rs&&rrNullCrypter.decryptrrr3N)r4r5r6r7r8rrr9r3rrrrs%rrcV^8dQhRR/#rr3)rEs"rrFrFs>>t>rc.\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)groupz Loading %szError initializing plugin rZN) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcs r _load_pluginsrsx ##*<= > IIlBGG , I "" # >  > MM6rd!< = >sAA,,$BBcV^8dQhRR/#)rBrCzlist[KeyringBackend]r3)rEs"rrFrFs-rc\4\P4p\P!V\ R7p\ V4#)zW Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr<rTrsuppress_exceptions TypeErrorlist)viable_classesringss rget_all_keyringrs3 O#779N  $ $^ JE ;rcb]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'} defaultr)rm)r)rmUserNameTitle)r KeePassXCNc(V^8dQhRRRRRRRR/#) rBrmrXr)rnbaserrCzdict[str, str]r3)rEs"rrFSchemeSelectable.__annotate__s,   &0 AK  rc VPVP,p\VeVR,VVR,V/M VR,V/3/VB#)Nr)rm)schemesschemer)r'rmr)rrs&&&, r_querySchemeSelectable._querysadkk* #z"Hy!7  y!7    rr3r) r4r5r6r7r8rrrrr9r3rrrrs6 Fj)< G<G   rr)'__conditional_annotations__r8 __future__rrrr0loggingrRrtypingrwjaraco.contextrjaraco.functoolsrrrrcompatr compat.py312r getLoggerr4rrS by_priorityr __annotations__ABCMetar r<rrrrr)rs@rrs#  (!''" !!!*- 9=6= # #FE1EP   '>4% % r