Initial commit

Author: msmahon

.github/workflows/phpunit.yml

@@ -0,0 +1,19 @@
+name: PHPUnit (Unit Tests)
+
+on: [push]
+
+jobs:
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Composer dependencies
+        uses: php-actions/composer@v6
+
+      - name: Install QPDF
+        run: sudo apt-get install -y qpdf
+
+      - name: Run PHPUnit
+        run: vendor/bin/phpunit tests

.gitignore

@@ -0,0 +1,6 @@
+/vendor/
+/.idea
+composer.lock
+.DS_Store
+.editorconfig
+.phpunit*

README.md

@@ -0,0 +1,3 @@
+A simple PHP wrapper for QPDF.
+
+https://github.com/qpdf/qpdf

composer.json

@@ -0,0 +1,32 @@
+{
+    "name": "msmahon/qpdf-php-wrapper",
+    "type": "library",
+    "description": "A simple PHP wrapper for QPDF",
+    "keywords": ["qpdf", "pdf"],
+    "homepage": "https://github.com/msmahon/qpdf-php-wrapper",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Mitchell Mahoney",
+            "email": "mahoneymitch@gmail.com"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "Msmahon\\QpdfPhpWrapper\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Msmahon\\QpdfPhpWrapper\\Tests\\": "tests/"
+        }
+    },
+    "minimum-stability": "dev",
+    "require": {
+        "php": "^8.1",
+        "symfony/process": "^6.4.2"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.6"
+    }
+}

index.php

@@ -0,0 +1,5 @@
+<?php
+
+require_once 'vendor/autoload.php';
+
+$class = new \Msmahon\QpdfPhpWrapper\Pdf();

phpunit.xml

@@ -0,0 +1,5 @@
+<phpunit
+    bootstrap="vendor/autoload.php"
+    displayDetailsOnTestsThatTriggerWarnings="true"
+>
+</phpunit>

src/Enums/ExitCode.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Msmahon\QpdfPhpWrapper\Enums;
+
+enum ExitCode: int
+{
+    /**
+     * no errors or warnings
+     */
+    case success = 0;
+    /**
+     * not used by qpdf but may be used by the shell if unable to invoke qpdf
+     */
+    case nonInvokable = 1;
+    /**
+     * errors detected
+     */
+    case error = 2;
+    /**
+     * warnings detected, unless --warning-exit-0 is given
+     */
+    case warning = 3;
+}

src/Enums/Rotation.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Msmahon\QpdfPhpWrapper\Enums;
+
+use InvalidArgumentException;
+
+enum Rotation: string
+{
+    CASE RIGHT = '+90';
+    CASE LEFT = '-90';
+    CASE DOWN = '+180';
+    CASE UP = '-180';
+
+    /**
+     * @param int $value
+     * @return self
+     * @throws InvalidArgumentException
+     */
+    public static function fromInt(int $value): self
+    {
+        return match ($value) {
+            90 => self::RIGHT,
+            -90 => self::LEFT,
+            180 => self::DOWN,
+            -180 => self::UP,
+            default => throw new InvalidArgumentException("Invalid rotation value: $value"),
+        };
+    }
+
+    /**
+     * @param string $value
+     * @return self
+     * @throws InvalidArgumentException
+     */
+    public static function fromCardinal(string $value): self
+    {
+        return match ($value) {
+            'right' => self::RIGHT,
+            'left' => self::LEFT,
+            'down' => self::DOWN,
+            'up' => self::UP,
+            default => throw new InvalidArgumentException("Invalid rotation value: $value"),
+        };
+    }
+}