Modernize Debian packaging

Vitexus · oz-agent · Vitexus · commit dd0c6560a4d1 · 2026-03-02T18:42:29.000+01:00
- debhelper-compat (= 13), pkg-php-tools, phpab

- Remove old compat file, composer-global-update

- Standards-Version 4.7.0, Section php

Co-Authored-By: Oz &lt;oz-agent@warp.dev&gt;
diff --git a/WARP.md b/WARP.md
@@ -0,0 +1,74 @@
+# WARP.md - Working AI Reference for php-spojenet-subreg
+
+## Project Overview
+**Type**: PHP Project/Debian Package
+**Purpose**: ![Php-subreg Logo](php-subreg-logo.png?raw=true "Project Logo")
+**Status**: Active
+**Repository**: git@github.com:Spoje-NET/php-subreg.git
+
+## Key Technologies
+- PHP
+- Composer
+- Debian Packaging
+
+## Architecture & Structure
+```
+php-spojenet-subreg/
+├── src/           # Source code
+├── tests/         # Test files
+├── docs/          # Documentation
+└── ...
+```
+
+## Development Workflow
+
+### Prerequisites
+- Development environment setup
+- Required dependencies
+
+### Setup Instructions
+```bash
+# Clone the repository
+git clone git@github.com:Spoje-NET/php-subreg.git
+cd php-spojenet-subreg
+
+# Install dependencies
+composer install
+```
+
+### Build & Run
+```bash
+dpkg-buildpackage -b -uc
+```
+
+### Testing
+```bash
+composer test
+```
+
+## Key Concepts
+- **Main Components**: Core functionality and modules
+- **Configuration**: Configuration files and environment variables
+- **Integration Points**: External services and dependencies
+
+## Common Tasks
+
+### Development
+- Review code structure
+- Implement new features
+- Fix bugs and issues
+
+### Deployment
+- Build and package
+- Deploy to target environment
+- Monitor and maintain
+
+## Troubleshooting
+- **Common Issues**: Check logs and error messages
+- **Debug Commands**: Use appropriate debugging tools
+- **Support**: Check documentation and issue tracker
+
+## Additional Notes
+- Project-specific conventions
+- Development guidelines
+- Related documentation
diff --git a/composer.json b/composer.json
@@ -1,40 +1,41 @@
 {
-    "name": "spojenet/subreg",
-    "description": "PHP Based Library for easy interaction with soap.subreg.cz",
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Vítězslav Dvořák",
-            "email": "info@vitexsoftware.cz"
-        }
-    ],
-    "require": {
-        "ext-soap": "*",
-        "vitexsoftware/ease-core": ">=1.50.1"
-    },
-    "autoload": {
-        "psr-4": {
-            "Subreg\\": "src/Subreg/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "Test\\Ease\\": "vendor/vitexsoftware/ease-core/tests/src/Ease",
-            "Test\\Subreg\\": "testing/src/Subreg/",
-            "Test\\": "testing/"
-        }
-    },
-    "require-dev": {
-        "phpunit/phpunit": "*",
-        "phpstan/phpstan": "*",
-        "friendsofphp/php-cs-fixer": "^3.93",
-        "ergebnis/composer-normalize": "^2.49",
-        "ergebnis/php-cs-fixer-config": "^6.59",
-        "phpstan/phpstan-phpunit": "2.0.12"
-    },
-    "config": {
-        "allow-plugins": {
-            "ergebnis/composer-normalize": true
-        }
+  "name": "spojenet/subreg",
+  "description": "PHP Based Library for easy interaction with soap.subreg.cz",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Vítězslav Dvořák",
+      "email": "info@vitexsoftware.cz"
     }
+  ],
+  "require": {
+    "ext-soap": "*",
+    "vitexsoftware/ease-core": ">=1.49.0"
+  },
+  "autoload": {
+    "psr-4": {
+      "Subreg\\": "src/Subreg/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Test\\Ease\\": "vendor/vitexsoftware/ease-core/tests/src/Ease",
+      "Test\\Subreg\\": "testing/src/Subreg/",
+      "Test\\": "testing/"
+    }
+  },
+  "require-dev": {
+    "phpunit/phpunit": "*",
+    "phpstan/phpstan": "*",
+    "friendsofphp/php-cs-fixer": "^3.92",
+    "ergebnis/composer-normalize": "^2.48",
+    "ergebnis/php-cs-fixer-config": "^6.58",
+    "phpstan/phpstan-phpunit": "2.0.12"
+  },
+  "config": {
+    "allow-plugins": {
+      "ergebnis/composer-normalize": true
+    }
+  },
+  "type": "library"
 }
diff --git a/composer.json.bak b/composer.json.bak
@@ -0,0 +1,40 @@
+{
+    "name": "spojenet/subreg",
+    "description": "PHP Based Library for easy interaction with soap.subreg.cz",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Vítězslav Dvořák",
+            "email": "info@vitexsoftware.cz"
+        }
+    ],
+    "require": {
+        "ext-soap": "*",
+        "vitexsoftware/ease-core": ">=1.49.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Subreg\\": "src/Subreg/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Test\\Ease\\": "vendor/vitexsoftware/ease-core/tests/src/Ease",
+            "Test\\Subreg\\": "testing/src/Subreg/",
+            "Test\\": "testing/"
+        }
+    },
+    "require-dev": {
+        "phpunit/phpunit": "*",
+        "phpstan/phpstan": "*",
+        "friendsofphp/php-cs-fixer": "^3.92",
+        "ergebnis/composer-normalize": "^2.48",
+        "ergebnis/php-cs-fixer-config": "^6.58",
+        "phpstan/phpstan-phpunit": "2.0.12"
+    },
+    "config": {
+        "allow-plugins": {
+            "ergebnis/composer-normalize": true
+        }
+    }
+}
diff --git a/debian/changelog b/debian/changelog
@@ -1,6 +1,7 @@
-php-spojenet-subreg (1.4.0) UNRELEASED; urgency=medium
+php-spojenet-subreg (1.4.0) unstable; urgency=medium
 
   * minimal supported version of php is 8.1
+  * Modernize Debian packaging: debhelper-compat 13, pkg-php-tools, phpab
 
  -- vitex <info@vitexsoftware.cz>  Mon, 12 May 2025 12:14:10 +0200
 
diff --git a/debian/clean b/debian/clean
@@ -0,0 +1 @@
+vendor/
diff --git a/debian/compat b/debian/compat
diff --git a/debian/control b/debian/control
@@ -1,16 +1,16 @@
 Source: php-spojenet-subreg
-Build-Depends: debhelper (>= 7.0.50~), jq, moreutils
-Section: web
-Standards-Version: 3.9.8
+Section: php
+Priority: optional
 Maintainer: Vítězslav Dvořák <info@vitexsoftware.cz>
 Uploaders: Vitex <vitex@hippy.cz>
-Priority: optional
+Build-Depends: debhelper-compat (= 13), pkg-php-tools (>= 1.7~), phpab, jq, moreutils
+Standards-Version: 4.7.0
 Homepage: https://github.com/Spoje-NET/php-subreg
+Rules-Requires-Root: no
 
 Package: php-spojenet-subreg
-Depends: ${misc:Depends}, php-vitexsoftware-ease-core, php-soap
 Architecture: all
-Section: web
-Priority: optional
+Section: php
+Depends: ${misc:Depends}, ${phpcomposer:Debian-require}, php-soap
 Description: PHP Client Library for soap.subreg.cz
  Provide classes for several domain/customer related operations
diff --git a/debian/php-spojenet-subreg.postinst b/debian/php-spojenet-subreg.postinst
@@ -1,40 +1,6 @@
 #!/bin/sh
-# postinst script for php-spojenet-subreg
-#
-# see: dh_installdeb(1)
-
 set -e
 
-# summary of how this script can be called:
-#        * <postinst> `configure' <most-recently-configured-version>
-#        * <old-postinst> `abort-upgrade' <new version>
-#        * <conflictor's-postinst> `abort-remove' `in-favour' <package>
-#          <new-version>
-#        * <postinst> `abort-remove'
-#        * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
-#          <failed-install-package> <version> `removing'
-#          <conflicting-package> <version>
-# for details, see http://www.debian.org/doc/debian-policy/ or
-# the debian-policy package
-
-
-case "$1" in
-    configure)
-
-        composer-global-update deb/subreg
-
-    ;;
-
-    abort-upgrade|abort-remove|abort-deconfigure)
-    ;;
-
-    *)
-        echo "postinst called with unknown argument \`$1'" >&2
-        exit 1
-    ;;
-esac
-
-# dh_installdeb will replace this with shell code automatically
-# generated by other debhelper scripts.
+#DEBHELPER#
 
 exit 0
diff --git a/debian/rules b/debian/rules
@@ -1,11 +1,16 @@
 #!/usr/bin/make -f
 
 %:
-	dh $@
+	dh $@ --with phpcomposer
 
 override_dh_auto_test:
 	echo tests temporarly skipped for now in rules file
 
 override_dh_install:
+	# Generate autoloader
+	phpab --output src/Subreg/autoload.php --basedir src/Subreg src/Subreg
 	dh_install
+	# Register with pkg-php-tools
+	pkg-php-tools-phpcomposer install deb subreg Subreg/autoload.php
+	# Version stamp
 	jq '.version = "'`dpkg-parsechangelog | sed -n 's/^Version: //p'| sed 's/~.*//'`'"'  debian/composer.json |sponge debian/php-spojenet-subreg/usr/share/php/Subreg/composer.json
