Define new interfaces for version 2

src/CliWrapper.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+use PharIo\Executor\Executor;
+use PharIo\FileSystem\Directory;
+
+final class CliWrapper implements GPG
+{
+    public function __construct(Executor $executor, Directory $home, ?Directory $temp = null)
+    {
+    }
+
+    public function importPublicKey(string $keyData): PublicKey
+    {
+        // TODO: Implement importPublicKey() method.
+    }
+
+    public function importSecretKey(string $keyData): SecretKey
+    {
+        // TODO: Implement importSecretKey() method.
+    }
+
+    public function verify(string $message, Signature $signature): KeyInfo
+    {
+        // TODO: Implement verify() method.
+    }
+
+    public function sign(SecretKey $privateKey, string $message): Signature
+    {
+        // TODO: Implement sign() method.
+    }
+}

src/GPG.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+interface GPG
+{
+    /**
+     * @param string $keyData raw key data
+     *
+     * @throws InvalidHomeDirectory
+     * @throws InvalidKey
+     */
+    public function importPublicKey(string $keyData): PublicKey;
+
+    /**
+     *
+     * @since 2.1 this method can be added later because phive is no just using the verify logic
+     * @param string $keyData raw key data
+     *
+     * @throws InvalidHomeDirectory
+     * @throws InvalidKey
+     */
+    public function importSecretKey(string $keyData): SecretKey;
+
+    /**
+     * Verifies the message is signed with the sigature
+     *
+     * Ensures that the signature is valid.
+     *
+     * @throws VerificiationFailed When message was not signed with the signature
+     * @throws UnknownFingerPrint When signature doesn't belong to a known key, key must be imported first
+     */
+    public function verify(string $message, Signature $signature): KeyInfo;
+
+    /**
+     * Uses the secret to create a signature.
+     *
+     * @since 2.1 this method can be added later because phive is no just using the verify logic
+     * @return Signature
+     */
+    public function sign(SecretKey $privateKey, string $message): Signature;
+}

src/InvalidHomeDirectory.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+class InvalidHomeDirectory extends Exception
+{
+
+}

src/InvalidKey.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+class InvalidKey extends Exception
+{
+
+}

src/KeyInfo.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+
+class KeyInfo
+{
+
+}

src/PeclWrapper.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+use PharIo\FileSystem\Directory;
+
+final class PeclWrapper implements GPG
+{
+    public function __construct(Directory $home, ?Directory $temp = null)
+    {
+        $this->gpg = new \Gnupg();
+    }
+
+    public function importPublicKey(string $keyData): PublicKey
+    {
+        // TODO: Implement importPublicKey() method.
+    }
+
+    public function importSecretKey(string $keyData): SecretKey
+    {
+        // TODO: Implement importSecretKey() method.
+    }
+
+    public function verify(string $message, Signature $signature): KeyInfo
+    {
+        // TODO: Implement verify() method.
+    }
+
+    public function sign(SecretKey $privateKey, string $message): Signature
+    {
+        // TODO: Implement sign() method.
+    }
+}

src/PublicKey.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+class PublicKey
+{
+    private function __construct(string $id, string $fingerprint, array $uids, string $key, \DateTimeImmutable $created)
+    {
+    }
+
+    public function getId(): string {
+    }
+
+    public function getInfo(): string {
+    }
+
+    public function getKey(): string {
+
+    }
+
+    public function getFingerprint(): string {
+
+    }
+}

src/SecretKey.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+/**
+ * @todo define what is needed here.
+ */
+class SecretKey
+{
+
+
+    public function getKeyData() {}
+}

src/Signature.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+/**
+ * This class could be prevent sigatures form being serialized.
+ *
+ * @see https://github.com/paragonie/hidden-string/blob/master/src/HiddenString.php inspired by.
+ */
+class Signature
+{
+    /**
+     * Will return internal sigature data
+     *
+     * This can be stored to a file for example.
+     */
+    public function getData(): string {
+    }
+}

src/VerificiationFailed.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PharIo\GnuPG;
+
+class VerificiationFailed extends Exception
+{
+
+}