Setup the initial repo for publication

.editorconfig

@@ -246,7 +246,7 @@ ij_javascript_array_initializer_wrap = off
 ij_javascript_assignment_wrap = off
 ij_javascript_binary_operation_sign_on_next_line = false
 ij_javascript_binary_operation_wrap = off
-ij_javascript_blacklist_imports = rxjs/Rx,node_modules/**,**/node_modules/**,@angular/material,@angular/material/typings/**
+ij_javascript_blacklist_imports = rxjs/Rx, node_modules/**, **/node_modules/**, @angular/material, @angular/material/typings/**
 ij_javascript_blank_lines_after_imports = 1
 ij_javascript_blank_lines_around_class = 1
 ij_javascript_blank_lines_around_field = 0
@@ -633,22 +633,22 @@ ij_json_spaces_within_brackets = false
 ij_json_wrap_long_lines = false
 
 [{*.html,*.inky,*.twig}]
-ij_html_add_new_line_before_tags = p,form,h1,h2,h3
+ij_html_add_new_line_before_tags = p, form, h1, h2, h3
 ij_html_align_attributes = true
 ij_html_align_text = false
 ij_html_attribute_wrap = normal
 ij_html_block_comment_at_first_column = true
 ij_html_do_not_align_children_of_min_lines = 0
-ij_html_do_not_break_if_inline_tags = title,h1,h2,h3,h4,h5,h6,p
-ij_html_do_not_indent_children_of_tags = html,body,thead,tbody,tfoot
+ij_html_do_not_break_if_inline_tags = title, h1, h2, h3, h4, h5, h6, p
+ij_html_do_not_indent_children_of_tags = html, body, thead, tbody, tfoot
 ij_html_enforce_quotes = true
-ij_html_inline_tags = a,abbr,acronym,b,basefont,bdo,big,br,cite,cite,code,dfn,em,font,i,img,input,kbd,label,q,s,samp,select,small,span,strike,strong,sub,sup,textarea,tt,u,var
+ij_html_inline_tags = a, abbr, acronym, b, basefont, bdo, big, br, cite, cite, code, dfn, em, font, i, img, input, kbd, label, q, s, samp, select, small, span, strike, strong, sub, sup, textarea, tt, u, var
 ij_html_keep_blank_lines = 1
 ij_html_keep_indents_on_empty_lines = false
 ij_html_keep_line_breaks = false
 ij_html_keep_line_breaks_in_text = true
 ij_html_keep_whitespaces = false
-ij_html_keep_whitespaces_inside = pre,textarea
+ij_html_keep_whitespaces_inside = pre, textarea
 ij_html_line_comment_at_first_column = true
 ij_html_new_line_after_last_attribute = never
 ij_html_new_line_before_first_attribute = never

.github/workflows/test.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-versions: ['8.1', '8.2', '8.3', '8.4']
+        php-versions: ['8.3', '8.4']
         composer-flags: ['', '--prefer-lowest']
     steps:
       - uses: actions/checkout@v4
@@ -36,7 +36,7 @@ jobs:
         run: composer update --prefer-dist --no-progress --no-suggest --prefer-stable ${{ matrix.composer-flags }}
 
       - name: Run test suite
-        run: composer test
+        run: composer test:unit
 
   coverage:
     name: PHP coverage
@@ -46,17 +46,17 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.3
           coverage: pcov
 
       - name: Install dependencies
         run: composer update --prefer-dist --no-progress --no-suggest --prefer-stable
 
       - name: Run test suite
-        run: php -dpcov.enabled=1 -dpcov.exclude="~vendor~" vendor/bin/phpunit --testsuite unit --coverage-clover ./.coverage/coverage.xml
+        run: php -dpcov.enabled=1 -dpcov.exclude="~vendor~" vendor/bin/phpunit --testsuite unit --coverage-clover ./coverage.xml
 
       - name: Check coverage
-        run: test ! -f ./.coverage/coverage.xml || php vendor/bin/phpfci inspect ./.coverage/coverage.xml ./.coverage/phpfci.xml --exit-code-on-failure
+        run: test ! -f ./.coverage/coverage.xml || php vendor/bin/phpfci inspect ./coverage.xml ./phpfci.xml --exit-code-on-failure
 
   quality:
     name: Quality checks
@@ -67,7 +67,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.1
+          php-version: 8.3
           coverage: none
 
       - name: Install dependencies

.gitignore

@@ -1,5 +1,6 @@
 /.idea
 /vendor
-/composer.lock
-/phpunit.xml
 /.phpunit.result.cache
+/.phpunit.cache
+/composer.lock
+/coverage.xml

README.md

@@ -1,6 +1,86 @@
-[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%208.1-8892BF)](https://php.net/)
+# Digitalrevolution IPP library
+
+## Installation
+
+```bash
+composer require digitalrevolution/ipp
+```
+
+## Usage
+
+### Initialize the library
+```php
+    $server = new IppServer();
+    $server->setUri('https://cups.local');
+    $server->setUserName('admin'); // optional
+    $server->setPassword('admin'); // optional
+
+    $ipp = new Ipp($server, new Psr18Client());
+```
+
+### Print a file
+```php
+    // define a printer        
+    $printer = new IppPrinter();
+    $printer->setHostname('my.printer');
+
+    // print a file on the selected printer
+    $ippFile = new IppPrintFile(file_get_contents('/dir/file.ps'), FileTypeEnum::PS);
+    $ipp->print($printer, $ippFile);
+```
+
+### Fetch job attributes
+```php
+    $printJob = $ipp->print($printer, $ippFile);
+    $updatedPrintJob = $ipp->getJobAttributes($printJob->getJobUri());
+```
+
+### Register a printer with cups
+```php
+    $printer = new IppPrinter();
+    $printer->setHostname('my.printer');
+    $printer->setDeviceUri('my.uri');
+    $printer->setLocation('location');
+
+    $ipp->createPrinter($printer);
+```
+
+### Delete a printer
+```php
+    $printer = new IppPrinter();
+    $printer->setHostname('my.printer');
+
+    $ipp->deletePrinter($printer);
+```
+
+### Contributing
+See [contributing.md](./CONTRIBUTING.md)  
+Pull requests welcome for adding standard IPP Operations  
+
+### Creating a custom IPP operation
+
+This project is created to be easily extensible, adding a new IPP operation is as simple as making sure it has an identifier in IppOperationEnum  
+Then adding any Job, Printer or Operation Attributes as required by your standard.    
+Finally sending the request and parsing the response using the standard parser.    
+```php
+public function myOperation(): IppResponseInterface
+    $operation = new IppOperation(IppOperationEnum::OperationType);
+    $operation->addOperationAttribute(new IppAttribute(IppTypeEnum::Charset, 'attributes-charset', 'utf-8'));
+
+    $response = $this->client->sendRequest(
+        new Request(
+            'POST',
+            $this->server->getUri(),
+            ['Content-Type' => 'application/ipp'],
+            (string)$operation
+        )
+    );
+
+    return $this->parser->getResponse($response->getBody()->getContents());
+}
+```
 
 ## About us
 
-At 123inkt (Part of Digital Revolution B.V.), every day more than 50 development professionals are working on improving our internal ERP 
+At 123inkt (Part of Digital Revolution B.V.), every day more than 50 development professionals are working on improving our internal ERP
 and our several shops. Do you want to join us? [We are looking for developers](https://www.werkenbij123inkt.nl/zoek-op-afdeling/it).

composer.json

@@ -1,42 +1,73 @@
 {
-    "name": "digitalrevolution/skeleton",
-    "description": "Digital Revolution skeleton package",
+    "name": "digitalrevolution/ipp",
+    "description": "Digital Revolution IPP library",
     "type": "library",
     "license": "MIT",
     "minimum-stability": "stable",
     "config": {
         "sort-packages": true,
+        "process-timeout": 0,
         "allow-plugins": {
-            "phpstan/extension-installer": true
-        }
+            "phpstan/extension-installer": true,
+            "dealerdirect/phpcodesniffer-composer-installer": true,
+            "digitalrevolution/php-codesniffer-baseline": true
+        },
+        "lock": false
     },
     "require": {
-        "php": ">=8.1"
+        "php": "^8.3",
+        "nyholm/psr7": "^1.8",
+        "psr/http-client": "^1.0",
+        "psr/log": "^3.0",
+        "digitalrevolution/utils": "^1.0"
     },
     "require-dev": {
-        "digitalrevolution/phpunit-file-coverage-inspection": "^v2.0.0",
-        "phpmd/phpmd": "^2.14",
-        "phpstan/extension-installer": "^1.3",
-        "phpstan/phpstan": "^2.0",
-        "phpstan/phpstan-phpunit": "^2.0",
-        "phpstan/phpstan-strict-rules": "^2.0",
-        "phpunit/phpunit": "^11.5 || ^12.0",
+        "digitalrevolution/accessorpair-constraint": "^v2.4.1",
+        "digitalrevolution/phpunit-file-coverage-inspection": "^3.0",
+        "digitalrevolution/php-codesniffer-baseline": "^1.1",
+        "phpmd/phpmd": "^2.12",
+        "phpstan/extension-installer": "^1.2",
+        "phpstan/phpstan": "^1.9.1",
+        "phpstan/phpstan-phpunit": "^1.2.2",
+        "phpunit/phpunit": "^11.5",
         "roave/security-advisories": "dev-latest",
         "squizlabs/php_codesniffer": "^3.7",
         "slevomat/coding-standard": "^8.16"
     },
     "scripts": {
-        "baseline": ["@baseline:phpstan", "@baseline:phpmd"],
+        "baseline": [
+            "@baseline:phpstan",
+            "@baseline:phpmd"
+        ],
         "baseline:phpstan": "phpstan --generate-baseline",
-        "baseline:phpmd": "phpmd src,tests xml phpmd.xml.dist --generate-baseline",
-        "check": ["@check:phpstan", "@check:phpmd", "@check:phpcs"],
+        "baseline:phpmd": "phpmd src,tests xml phpmd.xml --generate-baseline",
+        "check": [
+            "@check:phpstan",
+            "@check:phpmd",
+            "@check:phpcs"
+        ],
         "check:phpstan": "phpstan analyse",
-        "check:phpmd": "phpmd src,tests text phpmd.xml.dist --suffixes php",
+        "check:phpmd": "phpmd src,tests text phpmd.xml --suffixes php",
         "check:phpcs": "phpcs src tests",
         "fix": "@fix:phpcbf",
         "fix:phpcbf": "phpcbf src tests",
-        "test": "phpunit",
-        "test:integration": "phpunit --testsuite integration",
-        "test:unit": "phpunit --testsuite unit"
+        "test": [
+            "@test:unit:coverage",
+            "@test:phpfci"
+        ],
+        "test:unit": "phpunit --testsuite unit",
+        "test:unit:coverage": "phpunit --testsuite unit --coverage-clover coverage.xml",
+        "test:phpfci": "phpfci inspect coverage.xml --exit-code-on-failure"
+    },
+    "autoload": {
+        "psr-4": {
+            "DR\\Ipp\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "DR\\Ipp\\Tests\\Unit\\": "tests/Unit/",
+            "DR\\Ipp\\Tests\\": "tests/"
+        }
     }
 }

phpcs.xml.dist → phpcs.xml

@@ -20,8 +20,8 @@
     </rule>
     <rule ref="SlevomatCodingStandard.Complexity.Cognitive">
         <properties>
-            <property name="warningThreshold" value="16"/>
-            <property name="errorThreshold" value="16"/>
+            <property name="warningThreshold" value="6"/>
+            <property name="errorThreshold" value="6"/>
         </properties>
     </rule>
     <rule ref="SlevomatCodingStandard.Arrays.DisallowImplicitArrayCreation"/>

phpfci.xml

@@ -1,6 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <phpfci xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="vendor/digitalrevolution/phpunit-file-coverage-inspection/resources/phpfci.xsd"
-        min-coverage="100"
->
+        min-coverage="100">
 </phpfci>

phpstan.neon

@@ -3,3 +3,4 @@ parameters:
   treatPhpDocTypesAsCertain: false
   paths:
     - src
+    - tests

renovate.json

@@ -1,6 +1,6 @@
 {
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": [
-    "local>123inkt/.github:renovate-config"
-  ]
+    "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+    "extends": [
+        "local>123inkt/.github:renovate-config"
+    ]
 }