winipedia-utils 0.1.62__py3-none-any.whl → 0.2.0__py3-none-any.whl

winipedia_utils/pyside/ui/widgets/notification.py

@@ -1,78 +1,78 @@
-"""Notification module.
-
-This module contains functions to show notifications.
-"""
-
-from pyqttoast import Toast, ToastIcon, ToastPosition  # type: ignore[import-untyped]
-from PySide6.QtWidgets import QApplication
-
-from winipedia_utils.text.string import value_to_truncated_string
-
-Toast.setPosition(ToastPosition.TOP_MIDDLE)
-
-
-class Notification(Toast):  # type: ignore[misc]
-    """Notification class."""
-
-    def __init__(
-        self,
-        title: str,
-        text: str,
-        icon: ToastIcon = ToastIcon.INFORMATION,
-        duration: int = 10000,
-    ) -> None:
-        """Initialize the notification.
-
-        The notification is shown in the top middle of the screen.
-
-        Args:
-            title: The title of the notification.
-            text: The text of the notification.
-            icon: The icon of the notification. Defaults to INFORMATION.
-            duration: The duration of the notification in milliseconds.
-                        Defaults to 10000.
-        """
-        super().__init__(QApplication.activeWindow())
-        self.setDuration(duration)
-        self.setIcon(icon)
-        self.set_title(title)
-        self.set_text(text)
-
-    def set_title(self, title: str) -> None:
-        """Set the title of the notification.
-
-        Truncates the title to fit within half the window width before setting it.
-
-        Args:
-            title: The title text to set.
-        """
-        title = self.str_to_half_window_width(title)
-        self.setTitle(title)
-
-    def set_text(self, text: str) -> None:
-        """Set the text of the notification.
-
-        Truncates the text to fit within half the window width before setting it.
-
-        Args:
-            text: The notification text to set.
-        """
-        text = self.str_to_half_window_width(text)
-        self.setText(text)
-
-    def str_to_half_window_width(self, string: str) -> str:
-        """Truncate the string to the width of the active window.
-
-        Calculates half the width of the active window and truncates the string
-        to fit within that width. Falls back to 500 pixels if no active window.
-
-        Args:
-            string: The string to truncate.
-
-        Returns:
-            The truncated string that fits within half the window width.
-        """
-        main_window = QApplication.activeWindow()
-        width = main_window.width() / 2 if main_window is not None else 500
-        width = int(width)
-        return value_to_truncated_string(string, width)
+"""Notification module.
+
+This module contains functions to show notifications.
+"""
+
+from pyqttoast import Toast, ToastIcon, ToastPosition  # type: ignore[import-untyped]
+from PySide6.QtWidgets import QApplication
+
+from winipedia_utils.text.string import value_to_truncated_string
+
+Toast.setPosition(ToastPosition.TOP_MIDDLE)
+
+
+class Notification(Toast):  # type: ignore[misc]
+    """Notification class."""
+
+    def __init__(
+        self,
+        title: str,
+        text: str,
+        icon: ToastIcon = ToastIcon.INFORMATION,
+        duration: int = 10000,
+    ) -> None:
+        """Initialize the notification.
+
+        The notification is shown in the top middle of the screen.
+
+        Args:
+            title: The title of the notification.
+            text: The text of the notification.
+            icon: The icon of the notification. Defaults to INFORMATION.
+            duration: The duration of the notification in milliseconds.
+                        Defaults to 10000.
+        """
+        super().__init__(QApplication.activeWindow())
+        self.setDuration(duration)
+        self.setIcon(icon)
+        self.set_title(title)
+        self.set_text(text)
+
+    def set_title(self, title: str) -> None:
+        """Set the title of the notification.
+
+        Truncates the title to fit within half the window width before setting it.
+
+        Args:
+            title: The title text to set.
+        """
+        title = self.str_to_half_window_width(title)
+        self.setTitle(title)
+
+    def set_text(self, text: str) -> None:
+        """Set the text of the notification.
+
+        Truncates the text to fit within half the window width before setting it.
+
+        Args:
+            text: The notification text to set.
+        """
+        text = self.str_to_half_window_width(text)
+        self.setText(text)
+
+    def str_to_half_window_width(self, string: str) -> str:
+        """Truncate the string to the width of the active window.
+
+        Calculates half the width of the active window and truncates the string
+        to fit within that width. Falls back to 500 pixels if no active window.
+
+        Args:
+            string: The string to truncate.
+
+        Returns:
+            The truncated string that fits within half the window width.
+        """
+        main_window = QApplication.activeWindow()
+        width = main_window.width() / 2 if main_window is not None else 500
+        width = int(width)
+        return value_to_truncated_string(string, width)

winipedia_utils/pyside/ui/windows/__init__.py

@@ -1 +1 @@
-"""__init__ module."""
+"""__init__ module."""

winipedia_utils/pyside/ui/windows/base/__init__.py

@@ -1 +1 @@
-"""__init__ module."""
+"""__init__ module."""

winipedia_utils/pyside/ui/windows/base/base.py

@@ -1,49 +1,49 @@
-"""Base window module.
-
-This module contains the base window class for the VideoVault application.
-"""
-
-from abc import abstractmethod
-
-from PySide6.QtWidgets import QMainWindow, QStackedWidget
-
-from winipedia_utils.pyside.ui.base.base import Base as BaseUI
-from winipedia_utils.pyside.ui.pages.base.base import Base as BasePage
-
-
-class Base(BaseUI, QMainWindow):
-    """Base window class for the VideoVault application."""
-
-    @classmethod
-    @abstractmethod
-    def get_all_page_classes(cls) -> list[type[BasePage]]:
-        """Get all page classes."""
-
-    @classmethod
-    @abstractmethod
-    def get_start_page_cls(cls) -> type[BasePage]:
-        """Get the start page class."""
-
-    def base_setup(self) -> None:
-        """Get the Qt object of the UI."""
-        self.setWindowTitle(self.get_display_name())
-
-        self.stack = QStackedWidget()
-        self.setCentralWidget(self.stack)
-
-        self.make_pages()
-
-        self.set_start_page()
-
-    def make_pages(self) -> None:
-        """Get the pages to add to the window."""
-        for page_cls in self.get_all_page_classes():
-            page_cls(base_window=self)
-
-    def set_start_page(self) -> None:
-        """Set the start page."""
-        self.set_current_page(self.get_start_page_cls())
-
-    def add_page(self, page: BasePage) -> None:
-        """Add the pages to the window."""
-        self.stack.addWidget(page)
+"""Base window module.
+
+This module contains the base window class for the VideoVault application.
+"""
+
+from abc import abstractmethod
+
+from PySide6.QtWidgets import QMainWindow, QStackedWidget
+
+from winipedia_utils.pyside.ui.base.base import Base as BaseUI
+from winipedia_utils.pyside.ui.pages.base.base import Base as BasePage
+
+
+class Base(BaseUI, QMainWindow):
+    """Base window class for the VideoVault application."""
+
+    @classmethod
+    @abstractmethod
+    def get_all_page_classes(cls) -> list[type[BasePage]]:
+        """Get all page classes."""
+
+    @classmethod
+    @abstractmethod
+    def get_start_page_cls(cls) -> type[BasePage]:
+        """Get the start page class."""
+
+    def base_setup(self) -> None:
+        """Get the Qt object of the UI."""
+        self.setWindowTitle(self.get_display_name())
+
+        self.stack = QStackedWidget()
+        self.setCentralWidget(self.stack)
+
+        self.make_pages()
+
+        self.set_start_page()
+
+    def make_pages(self) -> None:
+        """Get the pages to add to the window."""
+        for page_cls in self.get_all_page_classes():
+            page_cls(base_window=self)
+
+    def set_start_page(self) -> None:
+        """Set the start page."""
+        self.set_current_page(self.get_start_page_cls())
+
+    def add_page(self, page: BasePage) -> None:
+        """Add the pages to the window."""
+        self.stack.addWidget(page)

winipedia_utils/resources/__init__.py

@@ -1 +1 @@
-"""__init__ module."""
+"""__init__ module."""

winipedia_utils/resources/svgs/__init__.py

@@ -1 +1 @@
-"""__init__ module."""
+"""__init__ module."""

winipedia_utils/resources/svgs/download_arrow.svg

@@ -1,3 +1,3 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="black" width="24" height="24">
-  <path d="M12 3v12m0 0l-5-5m5 5l5-5M5 21h14" stroke="black" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="black" width="24" height="24">
+  <path d="M12 3v12m0 0l-5-5m5 5l5-5M5 21h14" stroke="black" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

winipedia_utils/resources/svgs/exit_fullscreen_icon.svg

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <path d="M1 6L6 6L6 1L4.2 1L4.2 4.2L1 4.2L1 6Z" fill="#000000"/>
-  <path d="M15 10L10 10L10 15L11.8 15L11.8 11.8L15 11.8L15 10Z" fill="#000000"/>
-  <path d="M6 15L6 10L1 10L1 11.8L4.2 11.8L4.2 15L6 15Z" fill="#000000"/>
-  <path d="M10 1L10 6L15 6L15 4.2L11.8 4.2L11.8 1L10 1Z" fill="#000000"/>
+<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M1 6L6 6L6 1L4.2 1L4.2 4.2L1 4.2L1 6Z" fill="#000000"/>
+  <path d="M15 10L10 10L10 15L11.8 15L11.8 11.8L15 11.8L15 10Z" fill="#000000"/>
+  <path d="M6 15L6 10L1 10L1 11.8L4.2 11.8L4.2 15L6 15Z" fill="#000000"/>
+  <path d="M10 1L10 6L15 6L15 4.2L11.8 4.2L11.8 1L10 1Z" fill="#000000"/>
 </svg>

winipedia_utils/resources/svgs/fullscreen_icon.svg

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <path fill-rule="evenodd" clip-rule="evenodd" d="M10 15H15V10H13.2V13.2H10V15ZM6 15V13.2H2.8V10H1V15H6ZM10 2.8H12.375H13.2V6H15V1H10V2.8ZM6 1V2.8H2.8V6H1V1H6Z" fill="#000000"/>
+<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M10 15H15V10H13.2V13.2H10V15ZM6 15V13.2H2.8V10H1V15H6ZM10 2.8H12.375H13.2V6H15V1H10V2.8ZM6 1V2.8H2.8V6H1V1H6Z" fill="#000000"/>
 </svg>

winipedia_utils/resources/svgs/menu_icon.svg

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M4 6H20M4 12H20M4 18H20" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+<?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg width="800px" height="800px" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4 6H20M4 12H20M4 18H20" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

winipedia_utils/resources/svgs/pause_icon.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
-  <rect x="4" y="4" width="6" height="16"/>
-  <rect x="14" y="4" width="6" height="16"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
+  <rect x="4" y="4" width="6" height="16"/>
+  <rect x="14" y="4" width="6" height="16"/>
 </svg>

winipedia_utils/resources/svgs/play_icon.svg

@@ -1,17 +1,17 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="-3 0 28 28" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:sketch="http://www.bohemiancoding.com/sketch/ns">
-    
-    <title>play</title>
-    <desc>Created with Sketch Beta.</desc>
-    <defs>
-
-</defs>
-    <g id="Page-1" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd" sketch:type="MSPage">
-        <g id="Icon-Set-Filled" sketch:type="MSLayerGroup" transform="translate(-419.000000, -571.000000)" fill="#000000">
-            <path d="M440.415,583.554 L421.418,571.311 C420.291,570.704 419,570.767 419,572.946 L419,597.054 C419,599.046 420.385,599.36 421.418,598.689 L440.415,586.446 C441.197,585.647 441.197,584.353 440.415,583.554" id="play" sketch:type="MSShapeGroup">
-
-</path>
-        </g>
-    </g>
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg width="800px" height="800px" viewBox="-3 0 28 28" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:sketch="http://www.bohemiancoding.com/sketch/ns">
+    
+    <title>play</title>
+    <desc>Created with Sketch Beta.</desc>
+    <defs>
+
+</defs>
+    <g id="Page-1" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd" sketch:type="MSPage">
+        <g id="Icon-Set-Filled" sketch:type="MSLayerGroup" transform="translate(-419.000000, -571.000000)" fill="#000000">
+            <path d="M440.415,583.554 L421.418,571.311 C420.291,570.704 419,570.767 419,572.946 L419,597.054 C419,599.046 420.385,599.36 421.418,598.689 L440.415,586.446 C441.197,585.647 441.197,584.353 440.415,583.554" id="play" sketch:type="MSShapeGroup">
+
+</path>
+        </g>
+    </g>
 </svg>

winipedia_utils/resources/svgs/plus_icon.svg

@@ -1,24 +1,24 @@
-<?xml version="1.0" ?>
-
-<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-
-<title/>
-
-<g id="Complete">
-
-<g data-name="add" id="add-2">
-
-<g>
-
-<line fill="none" stroke="#000000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" x1="12" x2="12" y1="19" y2="5"/>
-
-<line fill="none" stroke="#000000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" x1="5" x2="19" y1="12" y2="12"/>
-
-</g>
-
-</g>
-
-</g>
-
+<?xml version="1.0" ?>
+
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg width="800px" height="800px" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+
+<title/>
+
+<g id="Complete">
+
+<g data-name="add" id="add-2">
+
+<g>
+
+<line fill="none" stroke="#000000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" x1="12" x2="12" y1="19" y2="5"/>
+
+<line fill="none" stroke="#000000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" x1="5" x2="19" y1="12" y2="12"/>
+
+</g>
+
+</g>
+
+</g>
+
 </svg>

winipedia_utils/resources/svgs/svg.py

@@ -1,15 +1,15 @@
-"""utils for svgs."""
-
-from importlib.resources import as_file, files
-from pathlib import Path
-from types import ModuleType
-
-from winipedia_utils.resources import svgs
-
-
-def get_svg_path(svg_name: str, package: ModuleType | None = None) -> Path:
-    """Get the path to a svg."""
-    package = package or svgs
-    svg_path = files(package) / f"{svg_name}.svg"
-    with as_file(svg_path) as path:
-        return path
+"""utils for svgs."""
+
+from importlib.resources import as_file, files
+from pathlib import Path
+from types import ModuleType
+
+from winipedia_utils.resources import svgs
+
+
+def get_svg_path(svg_name: str, package: ModuleType | None = None) -> Path:
+    """Get the path to a svg."""
+    package = package or svgs
+    svg_path = files(package) / f"{svg_name}.svg"
+    with as_file(svg_path) as path:
+        return path

winipedia_utils/security/__init__.py

@@ -1 +1 @@
-"""__init__ module for winipedia_utils.security."""
+"""__init__ module for winipedia_utils.security."""

winipedia_utils/security/cryptography.py

@@ -1,29 +1,29 @@
-"""Cryptography utilities for secure data handling.
-
-This module provides utility functions for working with cryptography,
-including encryption and decryption using Fernet and AESGCM.
-These utilities help with secure data handling.
-"""
-
-import os
-
-from cryptography.hazmat.primitives.ciphers.aead import AESGCM
-
-IV_LEN = 12
-
-
-def encrypt_with_aes_gcm(
-    aes_gcm: AESGCM, data: bytes, aad: bytes | None = None
-) -> bytes:
-    """Encrypt data using AESGCM."""
-    iv = os.urandom(IV_LEN)
-    encrypted = aes_gcm.encrypt(iv, data, aad)
-    return iv + encrypted
-
-
-def decrypt_with_aes_gcm(
-    aes_gcm: AESGCM, data: bytes, aad: bytes | None = None
-) -> bytes:
-    """Decrypt data using AESGCM."""
-    iv, encrypted = data[:IV_LEN], data[IV_LEN:]
-    return aes_gcm.decrypt(iv, encrypted, aad)
+"""Cryptography utilities for secure data handling.
+
+This module provides utility functions for working with cryptography,
+including encryption and decryption using Fernet and AESGCM.
+These utilities help with secure data handling.
+"""
+
+import os
+
+from cryptography.hazmat.primitives.ciphers.aead import AESGCM
+
+IV_LEN = 12
+
+
+def encrypt_with_aes_gcm(
+    aes_gcm: AESGCM, data: bytes, aad: bytes | None = None
+) -> bytes:
+    """Encrypt data using AESGCM."""
+    iv = os.urandom(IV_LEN)
+    encrypted = aes_gcm.encrypt(iv, data, aad)
+    return iv + encrypted
+
+
+def decrypt_with_aes_gcm(
+    aes_gcm: AESGCM, data: bytes, aad: bytes | None = None
+) -> bytes:
+    """Decrypt data using AESGCM."""
+    iv, encrypted = data[:IV_LEN], data[IV_LEN:]
+    return aes_gcm.decrypt(iv, encrypted, aad)

winipedia_utils/security/keyring.py

@@ -1,70 +1,70 @@
-"""Keyring utilities for secure storage and retrieval of secrets.
-
-This module provides utility functions for working with keyring,
-including getting and creating secrets and fernets.
-These utilities help with secure storage and retrieval of secrets.
-"""
-
-from base64 import b64decode, b64encode
-from collections.abc import Callable
-
-import keyring
-from cryptography.fernet import Fernet
-from cryptography.hazmat.primitives.ciphers.aead import AESGCM
-
-
-def get_or_create_fernet(service_name: str, username: str) -> tuple[Fernet, bytes]:
-    """Get the app secret using keyring.
-
-    If it does not exist, create it with a Fernet.
-    """
-    return get_or_create_key(
-        service_name, username, Fernet, lambda: Fernet.generate_key()
-    )
-
-
-def get_or_create_aes_gcm(service_name: str, username: str) -> tuple[AESGCM, bytes]:
-    """Get the app secret using keyring.
-
-    If it does not exist, create it with a AESGCM.
-    """
-    return get_or_create_key(
-        service_name, username, AESGCM, lambda: AESGCM.generate_key(bit_length=256)
-    )
-
-
-def get_or_create_key[T](
-    service_name: str,
-    username: str,
-    key_class: Callable[[bytes], T],
-    generate_key_func: Callable[..., bytes],
-) -> tuple[T, bytes]:
-    """Get the app secret using keyring.
-
-    If it does not exist, create it with the generate_func.
-    """
-    key = get_key_as_str(service_name, username, key_class)
-    if key is None:
-        binary_key = generate_key_func()
-        key = b64encode(binary_key).decode("ascii")
-        modified_service_name = make_service_name(service_name, key_class)
-        keyring.set_password(modified_service_name, username, key)
-
-    binary_key = b64decode(key)
-    return key_class(binary_key), binary_key
-
-
-def get_key_as_str[T](
-    service_name: str, username: str, key_class: Callable[[bytes], T]
-) -> str | None:
-    """Get the app secret using keyring.
-
-    If it does not exist, create it with the generate_func.
-    """
-    service_name = make_service_name(service_name, key_class)
-    return keyring.get_password(service_name, username)
-
-
-def make_service_name[T](service_name: str, key_class: Callable[[bytes], T]) -> str:
-    """Make a service name from a service name and a key class."""
-    return f"{service_name}_{key_class.__name__}"
+"""Keyring utilities for secure storage and retrieval of secrets.
+
+This module provides utility functions for working with keyring,
+including getting and creating secrets and fernets.
+These utilities help with secure storage and retrieval of secrets.
+"""
+
+from base64 import b64decode, b64encode
+from collections.abc import Callable
+
+import keyring
+from cryptography.fernet import Fernet
+from cryptography.hazmat.primitives.ciphers.aead import AESGCM
+
+
+def get_or_create_fernet(service_name: str, username: str) -> tuple[Fernet, bytes]:
+    """Get the app secret using keyring.
+
+    If it does not exist, create it with a Fernet.
+    """
+    return get_or_create_key(
+        service_name, username, Fernet, lambda: Fernet.generate_key()
+    )
+
+
+def get_or_create_aes_gcm(service_name: str, username: str) -> tuple[AESGCM, bytes]:
+    """Get the app secret using keyring.
+
+    If it does not exist, create it with a AESGCM.
+    """
+    return get_or_create_key(
+        service_name, username, AESGCM, lambda: AESGCM.generate_key(bit_length=256)
+    )
+
+
+def get_or_create_key[T](
+    service_name: str,
+    username: str,
+    key_class: Callable[[bytes], T],
+    generate_key_func: Callable[..., bytes],
+) -> tuple[T, bytes]:
+    """Get the app secret using keyring.
+
+    If it does not exist, create it with the generate_func.
+    """
+    key = get_key_as_str(service_name, username, key_class)
+    if key is None:
+        binary_key = generate_key_func()
+        key = b64encode(binary_key).decode("ascii")
+        modified_service_name = make_service_name(service_name, key_class)
+        keyring.set_password(modified_service_name, username, key)
+
+    binary_key = b64decode(key)
+    return key_class(binary_key), binary_key
+
+
+def get_key_as_str[T](
+    service_name: str, username: str, key_class: Callable[[bytes], T]
+) -> str | None:
+    """Get the app secret using keyring.
+
+    If it does not exist, create it with the generate_func.
+    """
+    service_name = make_service_name(service_name, key_class)
+    return keyring.get_password(service_name, username)
+
+
+def make_service_name[T](service_name: str, key_class: Callable[[bytes], T]) -> str:
+    """Make a service name from a service name and a key class."""
+    return f"{service_name}_{key_class.__name__}"