k7im#%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK J r SSK Jr SSKJrJrJr SSKJr SS KJr \R."\5r\R4"S 5rSrS \S '"S S\R<5r"SS\S9r "SS5r!"SS\!5r"SSjr#\SSj5r$"SS5r%g)z Keyring implementation support ) annotationsN) ExceptionTrap)once) credentialserrorsutil) properties)metadatapriorityz.typing.Callable[[KeyringBackend], bool] | None_limitc8^\rSrSrSrU4SjrSrSrSrU=r $)KeyringBackendMetaz} Specialized subclass behavior. Keeps a registry of all (non-abstract) types. Wraps set_password to validate the username. cf>[TU]XU5 UR5 UR5 gN)super__init__ _register"_validate_username_in_set_password)clsnamebasesdict __class__s I/home/james-whalen/.local/lib/python3.13/site-packages/keyring/backend.pyrKeyringBackendMeta.__init__'s' d+  ..0c[US5(d[5UlURnUR(dUR U5 gg)N_classes)hasattrsetr __abstractmethods__add)rclassess rrKeyringBackendMeta._register,s;sJ''5CL,,&& KK 'rch^URm[R"T5U4Sj5nXlg)z= Wrap ``set_password`` such to validate the passed username. c@>URU5 T"XU/UQ70UD6$r)_validate_username)selfsystemusernameargskwargsorigs rwrapperFKeyringBackendMeta._validate_username_in_set_password..wrapper9s(  # #H -h@@@ @rN) set_password functoolswraps)rr0r/s @rr5KeyringBackendMeta._validate_username_in_set_password3s5   A  A#r) __name__ __module__ __qualname____firstlineno____doc__rrr__static_attributes__ __classcell__)rs@rrrs1  # #rrcr\rSrSrSrSr\RSSj5r\ "5Rr \R\ S55r \ SSj5r \RSSj5rSSjr\R"SS j5rSS jr\R"SS j5rSS jrSS jrSSjrSSjrSrg)KeyringBackendAzUThe abstract base class of the keyring, every backend must implement this interface. c$UR5 gr)set_properties_from_envr*s rrKeyringBackend.__init__Fs $$&rc[e)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. )NotImplementedErrorrCs rr KeyringBackend.priorityIs "!rcUR gr)r rs rviableKeyringBackend.viable^s  rcV[[R"S5UR5$)z& Return all subclasses deemed viable. rJ)filteroperator attrgetterr rIs rget_viable_backends"KeyringBackend.get_viable_backendscs h))(3S\\BBrcURRS5upnURSS5nSRX0R/5$)zZ The keyring name, suitable for display. The name is derived from module and class name. ._ )r8 rpartitionreplacejoinr7)rparentsepmod_names rrKeyringBackend.namelsE!$ 9 9# >X##C-xx<<011rcl[U5nURSURSURSS3$)NrSz (priority: g))typer8r7r )r* keyring_classs r__str__KeyringBackend.__str__xs>T **+1]-C-C,DLQ^QgQghiPjjkllrcg)z,Get password of the username for the serviceNr6r*servicer,s r get_passwordKeyringBackend.get_password|srcHU(d"S[SS9 gg)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.[R"S5e)znSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr*rfr,passwords rr2KeyringBackend.set_passwords%%h//rc.[R"S5e)zyDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. rq)rPasswordDeleteErrorres rdelete_passwordKeyringBackend.delete_passwords ((22rc^Ub*URX5nUb[R"X#5$g)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)rgrSimpleCredentialrss rget_credentialKeyringBackend.get_credentials4  ((;H#"33HGGrcSSjn[S[U[RR 555nUHup4[ XU5 M g)z6For all KEYRING_PROPERTY_* env var, set that property.chUupURS5up4nU=(a UR5U4$)NKEYRING_PROPERTY_) partitionlower)itemkeyvalueprerZrs rparse5KeyringBackend.set_properties_from_env..parses2JC ]]+>?NCd0DJJL%0 0rN)rztuple[str, str])rMmaposenvironitemssetattr)r*rpropsrrs rrB&KeyringBackend.set_properties_from_envs? 1 *0c%AQAQAS6T)U KD D &!rc f[R"U5n[U5RU5 U$r)copyvarsupdate)r*r.alts rwith_propertiesKeyringBackend.with_propertiess&iio S   rr6N)returnfloat)rztype[KeyringBackend]rzfilter[type[KeyringBackend]])rstr)rfrr,rr str | None)r,rrNone)rfrr,rrtrrr)rfrr,rrr)rfrr,rrzcredentials.Credential | Nonerr)r. typing.Anyrr?)r7r8r9r:r;rr classpropertyr rpassesrJ classmethodrPrrbabcabstractmethodrgr)r2rxr|rBrr<r6rrr?r?As'""$_ # #F  C !C %CC 2 2m   003 ' & 'rr?) metaclassc`\rSrSrSr\R S5r\R S5rSr g)Crypterz.Base class providing encryption and decryptioncg)zEncrypt the value.Nr6r*rs rencryptCrypter.encrypt rcg)zDecrypt the value.Nr6rs rdecryptCrypter.decryptrrr6N) r7r8r9r:r;rrrrr<r6rrrrs78     rrc$\rSrSrSrSrSrSrg) NullCrypterzA crypter that does nothingcU$rr6rs rrNullCrypter.encrypt rcU$rr6rs rrNullCrypter.decryptrrr6N)r7r8r9r:r;rrr<r6rrrrs%rrc"[R"SS9HMn[RSUR5 UR 5n[ U5(a U"5 MMMO g![a [RSUS35 Mxf=f)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 rSN) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcs r _load_pluginsrsx ##*<= > IIlBGG , I "" # >  > MM6rd!< = >sAA''#B Bc[5 [R5n[R"U[ S9n[ U5$)zW Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr?rPr suppress_exceptions TypeErrorlist)viable_classesringss rget_all_keyringrs3 O#779N  $ $^ JE ;rc\\rSrSrSrSr\"\"SSS9\"SSS9S 9rS SS jjrS r g )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,rf)r,rfUserNameTitle)r KeePassXCNc tURURn[Ub USUUSU0OUSU040UD6$)Nr,rf)schemesschemer)r*rfr,basers r_querySchemeSelectable._querysadkk* #z"Hy!7  y!7    rr6r)rfrr,rrrrzdict[str, str]) r7r8r9r:r;rrrrr<r6rrrrs[ Fj)< G<G 48  &0 AK   rrr)rzlist[KeyringBackend])&r; __future__rrrr3loggingrNrtypingrljaraco.contextrjaraco.functoolsrrrr compatr compat.py312r getLoggerr7rrO by_priorityr __annotations__ABCMetarr?rrrrrr6rrrs#  (!''" !!!*- 9=6= # #FE1EP   '>4% % r