Typing: Add keyring stubs

4 files changed, 39 insertions, 0 deletions

diff --git a/typings/keyring/__init__.pyi b/typings/keyring/__init__.pyi
new file mode 100644
index 000000000..7424fe72b
--- /dev/null
+++ b/typings/keyring/__init__.pyi
@@ -0,0 +1,7 @@
+
+
+from . import backend as backend
+from . import core as core
+from . import errors as errors
+from .core import get_keyring as get_keyring
+
diff --git a/typings/keyring/backend.pyi b/typings/keyring/backend.pyi
new file mode 100644
index 000000000..03bbd7fd4
--- /dev/null
+++ b/typings/keyring/backend.pyi
@@ -0,0 +1,13 @@
+
+
+from typing import Optional
+
+
+class KeyringBackend:
+
+    def get_password(self, service: str, username: str) -> Optional[str]: ...
+    def set_password(self, service: str, username: str, password: str) -> None: ...
+    def delete_password(self, service: str, username: str) -> None: ...
+
+
+def get_all_keyring() -> list[KeyringBackend]: ...
diff --git a/typings/keyring/core.pyi b/typings/keyring/core.pyi
new file mode 100644
index 000000000..eb224d4ca
--- /dev/null
+++ b/typings/keyring/core.pyi
@@ -0,0 +1,11 @@
+
+from typing import Optional
+
+from keyring.backend import KeyringBackend
+
+
+def get_password(service_name: str, username: str) -> Optional[str]: ...
+def set_password(service_name: str, username: str, password: str) -> None: ...
+def delete_password(service_name: str, username: str) -> None: ...
+def recommended(backend: KeyringBackend) -> bool: ...
+def get_keyring() -> KeyringBackend: ...
diff --git a/typings/keyring/errors.pyi b/typings/keyring/errors.pyi
new file mode 100644
index 000000000..4ee019ba8
--- /dev/null
+++ b/typings/keyring/errors.pyi
@@ -0,0 +1,8 @@
+
+
+class KeyringError(Exception): ...
+class PasswordSetError(KeyringError): ...
+class PasswordDeleteError(KeyringError): ...
+class InitError(KeyringError): ...
+class KeyringLocked(KeyringError): ...
+class NoKeyringError(KeyringError): ...