From fa52b3aaeb190edc753626f0b428b9f16be7962a Mon Sep 17 00:00:00 2001
From: Jens Reimann <ctron@dentrassi.de>
Date: Mon, 26 May 2025 16:17:55 +0200
Subject: [PATCH] feat: expose signature validation tools on API

---
 common/src/validate/openpgp.rs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/common/src/validate/openpgp.rs b/common/src/validate/openpgp.rs
index 39a4bb68..024b3af6 100644
--- a/common/src/validate/openpgp.rs
+++ b/common/src/validate/openpgp.rs
@@ -1,6 +1,5 @@
 //! OpenPGP validation
-use crate::utils::openpgp::PublicKey;
-use crate::validate::ValidationOptions;
+use crate::{utils::openpgp::PublicKey, validate::ValidationOptions};
 use anyhow::bail;
 use sequoia_openpgp::{
     Cert, KeyHandle, Packet,
@@ -15,8 +14,9 @@ use sequoia_openpgp::{
 };
 use std::fmt::Debug;
 
-struct Helper<'a> {
-    keys: &'a [PublicKey],
+/// A verify helper for `PublicKey`.
+pub struct Helper<'a> {
+    pub keys: &'a [PublicKey],
 }
 
 impl VerificationHelper for Helper<'_> {
@@ -54,8 +54,9 @@ impl VerificationHelper for Helper<'_> {
     }
 }
 
+/// A wrapper policy, logging the outcome of the package call on debug level.
 #[derive(Debug)]
-struct LoggingPolicy<'a>(pub StandardPolicy<'a>);
+pub struct LoggingPolicy<'a>(pub StandardPolicy<'a>);
 
 impl Policy for LoggingPolicy<'_> {
     fn signature(&self, sig: &Signature, sec: HashAlgoSecurity) -> sequoia_openpgp::Result<()> {
@@ -85,6 +86,7 @@ impl Policy for LoggingPolicy<'_> {
     }
 }
 
+/// Validate a PGP signature
 pub fn validate_signature(
     options: &ValidationOptions,
     keys: &[PublicKey],