Initial commit

Author: Toflar

.gitattributes

@@ -0,0 +1,6 @@
+/bin export-ignore
+/tests export-ignore
+/.github export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/phpunit.xml export-ignore

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: terminal42
+ko_fi: terminal42

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+    push: ~
+    pull_request: ~
+
+permissions: read-all
+
+jobs:
+    ci:
+        uses: 'terminal42/contao-build-tools/.github/workflows/build-tools.yml@main'
+
+    tests:
+        name: Unit tests (PHP ${{ matrix.php }}
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                php: [ '8.1', '8.2', '8.3', '8.4' ]
+        steps:
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: ${{ matrix.php }}
+                  coverage: none
+
+            - name: Checkout
+              uses: actions/checkout@v3
+
+            - name: Install the dependencies
+              run: |
+                  composer install --no-interaction --no-progress --no-plugins
+
+            - name: Run phpunit
+              run: composer unit

.gitignore

@@ -0,0 +1,4 @@
+/.phpunit.cache
+/tests/Fixtures/**/var/restic
+/var
+/vendor

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 terminal42 gmbh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,9 @@
+# terminal42/php-restic
+
+> An opinionated PHP library that installs Restic and provides basic commands to work via PHP with it.
+> It is used for our own purposes and thus **not covered** by any API BC promises whatsoever.
+> Use at your own risk.
+
+## License
+
+This project is open-sourced under the [MIT License](LICENSE).

bin/bump-restic-version.php

@@ -0,0 +1,44 @@
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+
+require __DIR__.'/../vendor/autoload.php';
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\SingleCommandApplication;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Terminal42\Restic\Restic;
+
+(new SingleCommandApplication())
+    ->setName('Bump restic version.')
+    ->addArgument('version', InputArgument::REQUIRED, 'The desired version.')
+    ->setCode(
+        static function (InputInterface $input, OutputInterface $output): int {
+            $io = new SymfonyStyle($input, $output);
+            $version = $input->getArgument('version');
+
+            // Read the file
+            $resticClassPath = __DIR__.'/../src/Restic.php';
+            $content = file_get_contents($resticClassPath);
+            $pattern = "/public?\\s*const\\s+RESTIC_VERSION\\s*=\\s*'[^']*';/";
+            $replacement = "public const RESTIC_VERSION = '{$version}';";
+            $updatedContent = preg_replace($pattern, $replacement, $content);
+            file_put_contents($resticClassPath, $updatedContent);
+
+            if (Restic::RESTIC_VERSION !== $version) {
+                $io->error('Version could not be updated in Restic class.');
+
+                return Command::FAILURE;
+            }
+
+            Restic::updateShaSumFile();
+
+            return Command::SUCCESS;
+        },
+    )
+    ->run()
+;

composer.json

@@ -0,0 +1,41 @@
+{
+    "name": "terminal42/php-restic",
+    "description": "An opinionated helper library for Restic",
+    "type": "library",
+    "require": {
+        "php": "^8.1",
+        "ext-zip": "*",
+        "ext-bz2": "*",
+        "symfony/filesystem": "^6.4 || ^7.0",
+        "symfony/finder": "^6.4 || ^7.0",
+        "symfony/http-client": "^6.4 || ^7.0",
+        "symfony/process": "^6.4 || ^7.0"
+    },
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "Terminal42\\Restic\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Terminal42\\Restic\\Test\\": "tests/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Yanick Witschi",
+            "email": "[email protected]"
+        }
+    ],
+    "config": {
+        "allow-plugins": {
+            "terminal42/contao-build-tools": true
+        }
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^11.5",
+        "symfony/console": "^6.4 || ^7.0",
+        "terminal42/contao-build-tools": "dev-main"
+    }
+}