Feature/plugins

Cargo.toml

@@ -18,7 +18,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 age-core = "0.10"
-age = { version = "0.10", features = ["ssh"] }
+age = { version = "0.10", features = ["ssh", "plugin"] }
 pyo3 = { version = "0.21", features = [
     "extension-module",
     "abi3",

pyrage-stubs/pyrage-stubs/__init__.pyi

@@ -1,9 +1,9 @@
 from typing import Sequence, Union
 
-from pyrage import ssh, x25519, passphrase
+from pyrage import ssh, x25519, passphrase, plugin
 
-Identity = Union[ssh.Identity, x25519.Identity]
-Recipient = Union[ssh.Recipient, x25519.Recipient]
+Identity = Union[ssh.Identity, x25519.Identity, plugin.IdentityPluginV1]
+Recipient = Union[ssh.Recipient, x25519.Recipient, plugin.RecipientPluginV1]
 
 
 class RecipientError(Exception):

pyrage-stubs/pyrage-stubs/plugin.pyi

@@ -0,0 +1,48 @@
+from __future__ import annotations
+from typing import Sequence, Self, Optional, Protocol
+
+
+class Callbacks(Protocol):
+    def display_message(self, message: str) -> None:
+        ...
+
+    def confirm(self, message: str, yes_string: str, no_string: Optional[str]) -> Optional[bool]:
+        ...
+
+    def request_public_string(self, description: str) -> Optional[str]:
+        ...
+
+    def request_passphrase(self, description: str) -> Optional[str]:
+        ...
+
+
+class Recipient:
+    @classmethod
+    def from_str(cls, v: str) -> Recipient:
+        ...
+
+    def plugin(self) -> str:
+        ...
+
+
+class RecipientPluginV1:
+    def __new__(cls, plugin_name: str, recipients: Sequence[Recipient], identities: Sequence[Identity], callbacks: Callbacks) -> Self:
+        ...
+
+
+class Identity:
+    @classmethod
+    def from_str(cls, v: str) -> Identity:
+        ...
+
+    @classmethod
+    def default_for_plugin(cls, plugin: str) -> Identity:
+        ...
+
+    def plugin(self) -> str:
+        ...
+
+
+class IdentityPluginV1:
+    def __new__(cls, plugin_name: str, identities: Sequence[Identity], callbacks: Callbacks) -> Self:
+        ...