From 20ef01b2c3d70a15d194309e8eba433f1c8ea45c Mon Sep 17 00:00:00 2001
From: Andreas Heigl <heiglandreas@users.noreply.github.com>
Date: Fri, 4 Dec 2020 07:59:13 +0100
Subject: [PATCH] Move away from pect-extension

This commit moves away from using the PECL-extension towards using a
self-created GnuPG interface that itself agains mimics the functions of
the GnuPG extension.

This should make testing and execution without GnuPG being available in
either an extension or as binary easier.
---
 .editorconfig                          |  11 +
 src/Exception/GpgBinaryNotFound.php    |  21 ++
 src/Exception/GpgExtensionNotFound.php |  19 ++
 src/Factory.php                        |  69 ++---
 src/GnuPG.php                          | 340 +---------------------
 src/GnuPG/Binary.php                   | 386 +++++++++++++++++++++++++
 src/GnuPG/ErrorHandler.php             |  11 +
 src/GnuPG/Extension.php                |  45 +++
 src/GnuPG/Importer.php                 |  16 +
 src/GnuPG/Informer.php                 |  13 +
 src/GnuPG/NoGpgAvailable.php           |  29 ++
 src/GnuPG/Verifier.php                 |   8 +
 12 files changed, 591 insertions(+), 377 deletions(-)
 create mode 100644 .editorconfig
 create mode 100644 src/Exception/GpgBinaryNotFound.php
 create mode 100644 src/Exception/GpgExtensionNotFound.php
 create mode 100644 src/GnuPG/Binary.php
 create mode 100644 src/GnuPG/ErrorHandler.php
 create mode 100644 src/GnuPG/Extension.php
 create mode 100644 src/GnuPG/Importer.php
 create mode 100644 src/GnuPG/Informer.php
 create mode 100644 src/GnuPG/NoGpgAvailable.php
 create mode 100644 src/GnuPG/Verifier.php

diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..0ed5997
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+indent_size = tab
+indent_style = tab
+insert_final_newline = true
+max_line_length = off
+trim_trailing_whitespace = true
+tab_width = 4
\ No newline at end of file
diff --git a/src/Exception/GpgBinaryNotFound.php b/src/Exception/GpgBinaryNotFound.php
new file mode 100644
index 0000000..e6f44ed
--- /dev/null
+++ b/src/Exception/GpgBinaryNotFound.php
@@ -0,0 +1,21 @@
+<?php declare(strict_types=1);
+
+namespace PharIo\GnuPG\Exception;
+
+use RuntimeException;
+
+class GpgBinaryNotFound extends RuntimeException
+{
+    public static function inDefaultPath(): self
+    {
+        return new self('No gnupg binary found - please specify or install the pecl/gnupg extension.');
+    }
+
+    public static function inProvidedPath(string $path): self
+    {
+        return new self(sprintf(
+            'No gnupg binary found in %1$s - please check the location',
+            $path
+        ));
+    }
+}
\ No newline at end of file
diff --git a/src/Exception/GpgExtensionNotFound.php b/src/Exception/GpgExtensionNotFound.php
new file mode 100644
index 0000000..69a0db0
--- /dev/null
+++ b/src/Exception/GpgExtensionNotFound.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace PharIo\GnuPG\Exception;
+
+use RuntimeException;
+use Throwable;
+
+class GpgExtensionNotFound extends RuntimeException
+{
+    public static function inPhp(): self
+    {
+        return new self('The pecl/GnuPG extension for PHP was not found. You might want to install it.');
+    }
+
+    public static function orBroken(Throwable $t): self
+    {
+        return new self('The pexl/GnuPG extension for PHP was found but an Exception was thrown when using it. You might want to check the installation.', null, $t);
+    }
+}
\ No newline at end of file
diff --git a/src/Factory.php b/src/Factory.php
index 325beb9..b2931a3 100644
--- a/src/Factory.php
+++ b/src/Factory.php
@@ -1,16 +1,18 @@
 <?php declare(strict_types = 1);
+
 namespace PharIo\GnuPG;
 
-use PharIo\Executor\Executor;
 use PharIo\FileSystem\Directory;
 use PharIo\FileSystem\Filename;
+use PharIo\GnuPG\Exception\GpgBinaryNotFound;
+use PharIo\GnuPG\Exception\GpgExtensionNotFound;
+use PharIo\GnuPG\GnuPG as GPG;
+use function extension_loaded;
+use function putenv;
+use function sys_get_temp_dir;
 
-/** @noinspection PhpComposerExtensionStubsInspection */
 class Factory {
 
-    /** @var Filename */
-    private $gpgBinary;
-
     /**
      * Factory constructor.
      *
@@ -20,49 +22,24 @@ public function __construct(Filename $gpgBinary = null) {
         $this->gpgBinary = $gpgBinary;
     }
 
-    public function createGnuPG(Directory $homeDirectory): \Gnupg {
-        if (\extension_loaded('gnupg')) {
-            \putenv('GNUPGHOME=' . $homeDirectory->asString());
-            $gpg = new \Gnupg();
-            $gpg->seterrormode(\Gnupg::ERROR_SILENT);
-
-            return $gpg;
+    public function createGnuPG(Directory $homeDirectory): GnuPG
+    {
+        putenv('GNUPGHOME=' . $homeDirectory->asString());
+        try {
+            return new GPG\Extension();
+        } catch (GpgExtensionNotFound $e) {
+            // Do nothing on purpose
         }
 
-        $gpg = new GnuPG(
-            new Executor(),
-            $this->getGPGBinaryPath(),
-            $this->getTempDirectory(),
-            $homeDirectory
-        );
-
-        if (!\class_exists('\Gnupg')) {
-            \class_alias(GnuPG::class, '\Gnupg');
-        }
-
-        /** @var \Gnupg $gpg */
-        return $gpg;
-    }
-
-    /**
-     * @throws Exception
-     */
-    private function getGPGBinaryPath(): Filename {
-        if ($this->gpgBinary === null) {
-            $which  = \stripos(\PHP_OS, 'WIN') === 0 ? 'where.exe' : 'which';
-            $result = \exec(\sprintf('%s %s', $which, 'gpg'), $output, $exitCode);
-
-            if ($exitCode !== 0) {
-                throw new Exception('No gnupg binary found - please specify or install the pecl/gnupg extension.');
-            }
-            $resultLines     = \explode("\n", $result, 2);
-            $this->gpgBinary = new Filename($resultLines[0]);
+        try {
+            return GPG\Binary::createwithPaths(
+                $this->gpgBinary->asString(),
+                sys_get_temp_dir(),
+                $homeDirectory->asString()
+            );
+        } catch (GpgBinaryNotFound $e) {
+            // Do nothing on purpose
         }
-
-        return $this->gpgBinary;
-    }
-
-    private function getTempDirectory(): Directory {
-        return new Directory(\sys_get_temp_dir());
+        return new GPG\NoGpgAvailable;
     }
 }
diff --git a/src/GnuPG.php b/src/GnuPG.php
index e3ac8bb..1bbf7ae 100644
--- a/src/GnuPG.php
+++ b/src/GnuPG.php
@@ -1,334 +1,12 @@
-<?php declare(strict_types = 1);
-namespace PharIo\GnuPG;
-
-use PharIo\Executor\Executor;
-use PharIo\Executor\ExecutorResult;
-use PharIo\FileSystem\Directory;
-use PharIo\FileSystem\Filename;
-
-/**
- * This is a (thin) wrapper around the gnupg binary, mimicking the pecl/gnupg api
- * Currently, only the methods required by phive (import, info, geterror and verify) are implemented
- *
- * NOTE: The implementation may not be complete enough to be useful for other purposes
- */
-class GnuPG {
-
-    /** @var Executor */
-    private $executor;
-
-    /** @var Directory */
-    private $homeDirectory;
-
-    /** @var Directory */
-    private $tmpDirectory;
-
-    /** @var Filename */
-    private $gpgBinary;
-
-    /** @var int */
-    private $lastExitCode = -1;
-
-    public function __construct(Executor $executor, Filename $gpgBinary, Directory $tmpDirectory, Directory $homeDirectory) {
-        $this->executor      = $executor;
-        $this->gpgBinary     = $gpgBinary;
-        $this->tmpDirectory  = $tmpDirectory;
-        $this->homeDirectory = $homeDirectory;
-    }
-
-    public function import(string $key): array {
-        $tmpFile = $this->createTemporaryFile($key);
-        $result  = $this->execute([
-            '--import',
-            \escapeshellarg($tmpFile->asString())
-        ])->getOutput();
-        $tmpFile->delete();
-
-        if (\preg_match('=.*IMPORT_OK\s(\d+)\s(.*)=', \implode('', $result), $matches)) {
-            return [
-                'imported'    => (int)$matches[1],
-                'fingerprint' => $matches[2]
-            ];
-        }
-
-        return ['imported' => 0];
-    }
-
-    public function keyinfo(string $search): array {
-        $result = $this->execute([
-            '--list-keys',
-            '--with-fingerprint',
-            '--with-fingerprint', // duplication intentional
-            '--fixed-list-mode',
-            \escapeshellarg($search)
-        ])->getOutput();
-
-        return $this->parseInfoOutput($result);
-    }
-
-    /**
-     * @return array|false
-     */
-    public function verify(string $message, string $signature) {
-        $messageFile   = $this->createTemporaryFile($message);
-        $signatureFile = $this->createTemporaryFile($signature);
-
-        $result = $this->execute([
-            '--verify',
-            \escapeshellarg($signatureFile->asString()),
-            \escapeshellarg($messageFile->asString())
-        ]);
-
-        $signatureFile->delete();
-        $messageFile->delete();
-
-        return $this->parseVerifyOutput($result->getOutput(), $result->getExitCode());
-    }
-
-    /**
-     * @return false|string
-     */
-    public function geterror() {
-        if ($this->lastExitCode === -1) {
-            return false;
-        }
-
-        return ErrorStrings::fromCode($this->lastExitCode);
-    }
-
-    /**
-     * @return array|false
-     */
-    private function parseVerifyOutput(array $status, int $exitCode) {
-        $fingerprint = '';
-        $timestamp   = 0;
-        $summary     = false;
-
-        foreach ($status as $line) {
-            $parts = \explode(' ', $line);
-
-            if (\count($parts) < 3) {
-                continue;
-            }
-            $fingerprint = $parts[2];
-
-            if (\strpos($line, 'VALIDSIG') !== false) {
-                // [GNUPG:] VALIDSIG D8406D0D82947747{...}A394072C20A 2014-07-19 1405769272 0 4 0 1 10 00 D8{...}C20A
-                /*
-                VALIDSIG <args>
-
-                The args are:
-
-                - <fingerprint_in_hex>
-                - <sig_creation_date>
-                - <sig-timestamp>
-                - <expire-timestamp>
-                - <sig-version>
-                - <reserved>
-                - <pubkey-algo>
-                - <hash-algo>
-                - <sig-class>
-                - [ <primary-key-fpr> ]
-                */
-                $timestamp = $parts[4];
-                $summary   = 0;
-
-                break;
-            }
-
-            if (\strpos($line, 'BADSIG') !== false) {
-                // [GNUPG:] BADSIG 4AA394086372C20A Sebastian Bergmann <sb@sebastian-bergmann.de>
-                $summary = 4;
-
-                break;
-            }
-
-            if (\strpos($line, 'ERRSIG') !== false) {
-                // [GNUPG:] ERRSIG 4AA394086372C20A 1 10 00 1405769272 9
-                // ERRSIG  <keyid>  <pkalgo> <hashalgo> <sig_class> <time> <rc>
-                $timestamp = $parts[6];
-                $summary   = 128;
+<?php
 
-                break;
-            }
-        }
-
-        if ($summary === false) {
-            return false;
-        }
-
-        return [[
-            'fingerprint' => $fingerprint,
-            'validity'    => 0,
-            'timestamp'   => $timestamp,
-            'status'      => $exitCode,
-            'summary'     => $summary
-        ]];
-    }
-
-    /**
-     * @return string[]
-     */
-    private function getDefaultGpgParams(): array {
-        return [
-            '--homedir ' . \escapeshellarg($this->homeDirectory->asString()),
-            '--quiet',
-            '--status-fd 1',
-            '--lock-multiple',
-            '--no-permission-warning',
-            '--no-greeting',
-            '--exit-on-status-write-error',
-            '--batch',
-            '--no-tty',
-            '--with-colons'
-        ];
-    }
-
-    /**
-     * @param string[] $params
-     */
-    private function execute(array $params): ExecutorResult {
-        $devNull = \stripos(\PHP_OS, 'win') === 0 ? 'nul' : '/dev/null';
-
-        $argLine = \sprintf(
-            '%s %s 2>%s',
-            \implode(' ', $this->getDefaultGpgParams()),
-            \implode(' ', $params),
-            $devNull
-        );
-
-        $result             = $this->executor->execute($this->gpgBinary, $argLine);
-        $this->lastExitCode = $result->getExitCode();
-
-        return $result;
-    }
-
-    private function createTemporaryFile($content): Filename {
-        $tmpFile = $this->tmpDirectory->file(\uniqid('phive_gpg_', true));
-        $tmpFile->putContent($content);
-
-        return $tmpFile;
-    }
-
-    private function parseInfoOutput(array $result): array {
-        //
-        // Fragment docs @  https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob_plain;f=doc/DETAILS
-        //
-
-        $key     = [];
-        $uids    = [];
-        $subkeys = [];
-
-        foreach ($result as $line) {
-            $fragments = \explode(':', $line);
-
-            switch ($fragments[0]) {
-                case 'sub':
-                case 'pub':
-                {
-                    $subkeys[] = \array_merge(
-                        [
-                            'keyid'     => $fragments[4],
-                            'timestamp' => (int)$fragments[5],
-                            'expires'   => (int)$fragments[6]
-                        ],
-                        $this->parseCapabilities($fragments[11]),
-                        $this->parseValidity($fragments[1])
-                    );
-
-                    if (empty($key)) {
-                        $key = \array_merge(
-                            $this->parseValidity($fragments[1]),
-                            $this->parseCapabilities($fragments[11])
-                        );
-                    }
-
-                    break;
-                }
-
-                case 'fpr':
-                {
-                    $subkeys[] = \array_merge(
-                        ['fingerprint' => $fragments[9]],
-                        \array_pop($subkeys)
-                    );
-
-                    break;
-                }
-
-                case 'uid':
-                {
-                    \preg_match('/(.*)\s<(.*)>/', $fragments[9], $matches);
-
-                    $uids[] = \array_merge(
-                        [
-                            'name'    => $matches[1],
-                            'comment' => '',
-                            'email'   => $matches[2],
-                            'uid'     => $fragments[9],
-                        ],
-                        $this->parseValidity($fragments[1])
-                    );
-
-                    break;
-                }
-            }
-        }
-
-        $key['uids']    = $uids;
-        $key['subkeys'] = $subkeys;
-
-        return [$key];
-    }
-
-    private function parseValidity(string $flag): array {
-        static $map = [
-            'i' => 'invalid',
-            'd' => 'disabled',
-            'r' => 'revoked',
-            'e' => 'expired',
-            'n' => 'invalid'
-        ];
-
-        $parsed = [
-            'disabled' => false,
-            'expired'  => false,
-            'revoked'  => false,
-            'invalid'  => false
-        ];
-
-        if (isset($map[$flag])) {
-            $parsed[$map[$flag]] = true;
-        }
-
-        return $parsed;
-    }
-
-    private function parseCapabilities(string $flags): array {
-        /*
-         * - e :: Encrypt
-         * - s :: Sign
-         * - c :: Certify
-         * - a :: Authentication
-         * - ? :: Unknown capability
-         */
-
-        $result = [
-            'can_encrypt' => false,
-            'can_sign'    => false
-        ];
-
-        static $map = [
-            's' => 'can_sign',
-            'e' => 'can_encrypt'
-        ];
+namespace PharIo\GnuPG;
 
-        foreach (\str_split(\strtolower($flags), 1) as $char) {
-            if (isset($map[$char])) {
-                $result[$map[$char]] = true;
-            }
-        }
+use PharIo\GnuPG\GnuPG\ErrorHandler;
+use PharIo\GnuPG\GnuPG\Importer;
+use PharIo\GnuPG\GnuPG\Informer;
+use PharIo\GnuPG\GnuPG\Verifier;
 
-        return $result;
-    }
-}
+interface GnuPG extends Verifier, Importer, Informer, ErrorHandler
+{
+}
\ No newline at end of file
diff --git a/src/GnuPG/Binary.php b/src/GnuPG/Binary.php
new file mode 100644
index 0000000..42a5136
--- /dev/null
+++ b/src/GnuPG/Binary.php
@@ -0,0 +1,386 @@
+<?php declare(strict_types = 1);
+namespace PharIo\GnuPG\GnuPG;
+
+use PharIo\Executor\Executor;
+use PharIo\Executor\ExecutorResult;
+use PharIo\FileSystem\Directory;
+use PharIo\FileSystem\Filename;
+use PharIo\GnuPG\Exception;
+use PharIo\GnuPG\Exception\GpgBinaryNotFound;
+use PharIo\GnuPG\GnuPG;
+use function exec;
+use function explode;
+use function getcwd;
+use function getenv;
+use function shell_exec;
+use function sprintf;
+use function stripos;
+use function sys_get_temp_dir;
+use const PHP_OS;
+
+/**
+ * This is a (thin) wrapper around the gnupg binary, mimicking the pecl/gnupg api
+ * Currently, only the methods required by phive (import, info, geterror and verify) are implemented
+ *
+ * NOTE: The implementation may not be complete enough to be useful for other purposes
+ */
+class Binary implements GnuPG
+{
+
+    /** @var Executor */
+    private $executor;
+
+    /** @var Directory */
+    private $homeDirectory;
+
+    /** @var Directory */
+    private $tmpDirectory;
+
+    /** @var Filename */
+    private $gpgBinary;
+
+    /** @var int */
+    private $lastExitCode = -1;
+
+
+    public static function createwithPaths(string $gpgBinary = '', string $tmpDirectory = '', string $homeDirectory = '')
+    {
+        if(realpath($gpgBinary) === false) {
+            $gpgBinary = self::getGPGBinaryPath();
+        }
+        if (realpath($gpgBinary) === false) {
+            throw GpgBinaryNotFound::inProvidedPath($gpgBinary);
+        }
+
+        if (realpath($tmpDirectory) === false) {
+            $tmpDirectory = sys_get_temp_dir();
+        }
+
+        if (realpath($homeDirectory) === false) {
+            $homeDirectory = (string) getenv('GNUPGHOME');
+        }
+
+        if (realpath($homeDirectory) === false) {
+            $homeDirectory === getcwd();
+        }
+
+        return new self(new Executor(), new Filename($gpgBinary), new Directory($tmpDirectory), new Directory($homeDirectory));
+    }
+
+    private static function getGPGBinaryPath(): string
+    {
+        $which = stripos(PHP_OS, 'WIN') === 0 ? 'where.exe' : 'which';
+        $result = exec(sprintf('%s %s', $which, 'gpg'), $output, $exitCode);
+
+        if ($exitCode !== 0) {
+            throw GpgBinaryNotFound::inDefaultPath();
+        }
+        $resultLines = explode("\n", $result, 2);
+
+        return $resultLines[0];
+    }
+
+
+        public function __construct(Executor $executor, Filename $gpgBinary, Directory $tmpDirectory, Directory $homeDirectory) {
+        $this->executor      = $executor;
+        $this->gpgBinary     = $gpgBinary;
+        $this->tmpDirectory  = $tmpDirectory;
+        $this->homeDirectory = $homeDirectory;
+    }
+
+    public function import(string $key): array {
+        $tmpFile = $this->createTemporaryFile($key);
+        $result  = $this->execute([
+            '--import',
+            \escapeshellarg($tmpFile->asString())
+        ])->getOutput();
+        $tmpFile->delete();
+
+        if (\preg_match('=.*IMPORT_OK\s(\d+)\s(.*)=', \implode('', $result), $matches)) {
+            return [
+                'imported'    => (int)$matches[1],
+                'fingerprint' => $matches[2]
+            ];
+        }
+
+        return ['imported' => 0];
+    }
+
+    public function keyinfo(string $search): array {
+        $result = $this->execute([
+            '--list-keys',
+            '--with-fingerprint',
+            '--with-fingerprint', // duplication intentional
+            '--fixed-list-mode',
+            \escapeshellarg($search)
+        ])->getOutput();
+
+        return $this->parseInfoOutput($result);
+    }
+
+    /**
+     * @return array|false
+     */
+    public function verify(string $message, string $signature) {
+        $messageFile   = $this->createTemporaryFile($message);
+        $signatureFile = $this->createTemporaryFile($signature);
+
+        $result = $this->execute([
+            '--verify',
+            \escapeshellarg($signatureFile->asString()),
+            \escapeshellarg($messageFile->asString())
+        ]);
+
+        $signatureFile->delete();
+        $messageFile->delete();
+
+        return $this->parseVerifyOutput($result->getOutput(), $result->getExitCode());
+    }
+
+    /**
+     * @return false|string
+     */
+    public function geterror() {
+        if ($this->lastExitCode === -1) {
+            return false;
+        }
+
+        return ErrorStrings::fromCode($this->lastExitCode);
+    }
+
+    /**
+     * @return array|false
+     */
+    private function parseVerifyOutput(array $status, int $exitCode) {
+        $fingerprint = '';
+        $timestamp   = 0;
+        $summary     = false;
+
+        foreach ($status as $line) {
+            $parts = \explode(' ', $line);
+
+            if (\count($parts) < 3) {
+                continue;
+            }
+            $fingerprint = $parts[2];
+
+            if (\strpos($line, 'VALIDSIG') !== false) {
+                // [GNUPG:] VALIDSIG D8406D0D82947747{...}A394072C20A 2014-07-19 1405769272 0 4 0 1 10 00 D8{...}C20A
+                /*
+                VALIDSIG <args>
+
+                The args are:
+
+                - <fingerprint_in_hex>
+                - <sig_creation_date>
+                - <sig-timestamp>
+                - <expire-timestamp>
+                - <sig-version>
+                - <reserved>
+                - <pubkey-algo>
+                - <hash-algo>
+                - <sig-class>
+                - [ <primary-key-fpr> ]
+                */
+                $timestamp = $parts[4];
+                $summary   = 0;
+
+                break;
+            }
+
+            if (\strpos($line, 'BADSIG') !== false) {
+                // [GNUPG:] BADSIG 4AA394086372C20A Sebastian Bergmann <sb@sebastian-bergmann.de>
+                $summary = 4;
+
+                break;
+            }
+
+            if (\strpos($line, 'ERRSIG') !== false) {
+                // [GNUPG:] ERRSIG 4AA394086372C20A 1 10 00 1405769272 9
+                // ERRSIG  <keyid>  <pkalgo> <hashalgo> <sig_class> <time> <rc>
+                $timestamp = $parts[6];
+                $summary   = 128;
+
+                break;
+            }
+        }
+
+        if ($summary === false) {
+            return false;
+        }
+
+        return [[
+            'fingerprint' => $fingerprint,
+            'validity'    => 0,
+            'timestamp'   => $timestamp,
+            'status'      => $exitCode,
+            'summary'     => $summary
+        ]];
+    }
+
+    /**
+     * @return string[]
+     */
+    private function getDefaultGpgParams(): array {
+        return [
+            '--homedir ' . \escapeshellarg($this->homeDirectory->asString()),
+            '--quiet',
+            '--status-fd 1',
+            '--lock-multiple',
+            '--no-permission-warning',
+            '--no-greeting',
+            '--exit-on-status-write-error',
+            '--batch',
+            '--no-tty',
+            '--with-colons'
+        ];
+    }
+
+    /**
+     * @param string[] $params
+     */
+    private function execute(array $params): ExecutorResult {
+        $devNull = \stripos(\PHP_OS, 'win') === 0 ? 'nul' : '/dev/null';
+
+        $argLine = \sprintf(
+            '%s %s 2>%s',
+            \implode(' ', $this->getDefaultGpgParams()),
+            \implode(' ', $params),
+            $devNull
+        );
+
+        $result             = $this->executor->execute($this->gpgBinary, $argLine);
+        $this->lastExitCode = $result->getExitCode();
+
+        return $result;
+    }
+
+    private function createTemporaryFile($content): Filename {
+        $tmpFile = $this->tmpDirectory->file(\uniqid('phive_gpg_', true));
+        $tmpFile->putContent($content);
+
+        return $tmpFile;
+    }
+
+    private function parseInfoOutput(array $result): array {
+        //
+        // Fragment docs @  https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob_plain;f=doc/DETAILS
+        //
+
+        $key     = [];
+        $uids    = [];
+        $subkeys = [];
+
+        foreach ($result as $line) {
+            $fragments = \explode(':', $line);
+
+            switch ($fragments[0]) {
+                case 'sub':
+                case 'pub':
+                {
+                    $subkeys[] = \array_merge(
+                        [
+                            'keyid'     => $fragments[4],
+                            'timestamp' => (int)$fragments[5],
+                            'expires'   => (int)$fragments[6]
+                        ],
+                        $this->parseCapabilities($fragments[11]),
+                        $this->parseValidity($fragments[1])
+                    );
+
+                    if (empty($key)) {
+                        $key = \array_merge(
+                            $this->parseValidity($fragments[1]),
+                            $this->parseCapabilities($fragments[11])
+                        );
+                    }
+
+                    break;
+                }
+
+                case 'fpr':
+                {
+                    $subkeys[] = \array_merge(
+                        ['fingerprint' => $fragments[9]],
+                        \array_pop($subkeys)
+                    );
+
+                    break;
+                }
+
+                case 'uid':
+                {
+                    \preg_match('/(.*)\s<(.*)>/', $fragments[9], $matches);
+
+                    $uids[] = \array_merge(
+                        [
+                            'name'    => $matches[1],
+                            'comment' => '',
+                            'email'   => $matches[2],
+                            'uid'     => $fragments[9],
+                        ],
+                        $this->parseValidity($fragments[1])
+                    );
+
+                    break;
+                }
+            }
+        }
+
+        $key['uids']    = $uids;
+        $key['subkeys'] = $subkeys;
+
+        return [$key];
+    }
+
+    private function parseValidity(string $flag): array {
+        static $map = [
+            'i' => 'invalid',
+            'd' => 'disabled',
+            'r' => 'revoked',
+            'e' => 'expired',
+            'n' => 'invalid'
+        ];
+
+        $parsed = [
+            'disabled' => false,
+            'expired'  => false,
+            'revoked'  => false,
+            'invalid'  => false
+        ];
+
+        if (isset($map[$flag])) {
+            $parsed[$map[$flag]] = true;
+        }
+
+        return $parsed;
+    }
+
+    private function parseCapabilities(string $flags): array {
+        /*
+         * - e :: Encrypt
+         * - s :: Sign
+         * - c :: Certify
+         * - a :: Authentication
+         * - ? :: Unknown capability
+         */
+
+        $result = [
+            'can_encrypt' => false,
+            'can_sign'    => false
+        ];
+
+        static $map = [
+            's' => 'can_sign',
+            'e' => 'can_encrypt'
+        ];
+
+        foreach (\str_split(\strtolower($flags), 1) as $char) {
+            if (isset($map[$char])) {
+                $result[$map[$char]] = true;
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/src/GnuPG/ErrorHandler.php b/src/GnuPG/ErrorHandler.php
new file mode 100644
index 0000000..fbd5092
--- /dev/null
+++ b/src/GnuPG/ErrorHandler.php
@@ -0,0 +1,11 @@
+<?php
+
+namespace PharIo\GnuPG\GnuPG;
+
+interface ErrorHandler
+{
+    /**
+     * @return false|string
+     */
+    public function geterror();
+}
\ No newline at end of file
diff --git a/src/GnuPG/Extension.php b/src/GnuPG/Extension.php
new file mode 100644
index 0000000..2c75d3a
--- /dev/null
+++ b/src/GnuPG/Extension.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace PharIo\GnuPG\GnuPG;
+
+use PharIo\GnuPG\Exception\GpgExtensionNotFound;
+use PharIo\GnuPG\GnuPG;
+use Throwable;
+use function extension_loaded;
+
+class Extension implements GnuPG
+{
+    public function __construct()
+    {
+        if (! extension_loaded('gnupg')) {
+            throw GpgExtensionNotFound::inPhp();
+        }
+
+        try {
+            $this->gnupg = new \Gnupg;
+            $this->gnupg->seterrormode(\Gnupg::ERROR_SILENT);
+        } catch (Throwable $t) {
+            throw GpgExtensionNotFound::orBroken($t);
+        }
+    }
+
+    public function verify(string $content, string $signature) : bool
+    {
+        return $this->gnupg->verify($content, $signature);
+    }
+
+    public function geterror()
+    {
+        return $this->gnupg->geterror();
+    }
+
+    public function import(string $key) : array
+    {
+        return $this->gnupg->import($key);
+    }
+
+    public function keyInfo(string $search) : array
+    {
+        return $this->gnupg->keyinfo($search);
+    }
+}
\ No newline at end of file
diff --git a/src/GnuPG/Importer.php b/src/GnuPG/Importer.php
new file mode 100644
index 0000000..a5ff8c3
--- /dev/null
+++ b/src/GnuPG/Importer.php
@@ -0,0 +1,16 @@
+<?php
+/**
+ * Copyright Andreas Heigl <andreas@heigl.org>
+ *
+ * Licensed under the MIT-license. For details see the included file LICENSE.md
+ */
+
+namespace PharIo\GnuPG\GnuPG;
+
+interface Importer
+{
+    /**
+     * @return int[]
+     */
+    public function import(string $key): array;
+}
\ No newline at end of file
diff --git a/src/GnuPG/Informer.php b/src/GnuPG/Informer.php
new file mode 100644
index 0000000..60c3221
--- /dev/null
+++ b/src/GnuPG/Informer.php
@@ -0,0 +1,13 @@
+<?php
+/**
+ * Copyright Andreas Heigl <andreas@heigl.org>
+ *
+ * Licensed under the MIT-license. For details see the included file LICENSE.md
+ */
+
+namespace PharIo\GnuPG\GnuPG;
+
+interface Informer
+{
+    public function keyInfo(string $search): array;
+}
\ No newline at end of file
diff --git a/src/GnuPG/NoGpgAvailable.php b/src/GnuPG/NoGpgAvailable.php
new file mode 100644
index 0000000..cfdee54
--- /dev/null
+++ b/src/GnuPG/NoGpgAvailable.php
@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+
+namespace PharIo\GnuPG\GnuPG;
+
+use PharIo\GnuPG\GnuPG;
+
+class NoGpgAvailable implements GnuPG
+{
+
+    public function geterror()
+    {
+        return '';
+    }
+
+    public function import(string $key) : array
+    {
+        return [];
+    }
+
+    public function keyInfo(string $search) : array
+    {
+        return [];
+    }
+
+    public function verify(string $content, string $signature) : bool
+    {
+        return true;
+    }
+}
\ No newline at end of file
diff --git a/src/GnuPG/Verifier.php b/src/GnuPG/Verifier.php
new file mode 100644
index 0000000..88b1291
--- /dev/null
+++ b/src/GnuPG/Verifier.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace PharIo\GnuPG\GnuPG;
+
+interface Verifier
+{
+    public function verify(string $content, string $signature): bool;
+}
\ No newline at end of file