patch

Author: lbr38

documentation/docs/reference/api.md

@@ -396,8 +396,8 @@ Once generated, copy the key and keep it safe. This key is used to authenticate
     <tr>
       <td>/hosts/package/<code>&lt;PACKAGE&gt;</code>/<code>&lt;VERSION?&gt;</code><br><code>GET</code></td>
       <td><code>&lt;APIKEY&gt;</code></td>
-      <td><code>package</code> (required, in URL)<br><code>version</code> (optional, in URL)<br><code>strict</code> (optional, query parameter)<br><code>strict-name</code> (optional, query parameter)<br><code>strict-version</code> (optional, query parameter)</td>
-      <td>List hosts that have the specified package installed, optionally filtered by version. By default, package name and version matching can be non-strict. Use <code>strict</code> to enable strict matching for both package name and version, or use <code>strict-name</code> and <code>strict-version</code> independently.</td>
+      <td><code>package</code> (required, in URL)<br><code>version</code> (optional, in URL)<br><code>strict</code> (optional, query parameter)<br><code>strict-name</code> (optional, query parameter)<br><code>strict-version</code> (optional, query parameter)<br><code>absent</code> (optional, query parameter)</td>
+      <td>List hosts that have the specified package installed, optionally filtered by version. By default, package name and version matching can be non-strict. Use <code>strict</code> to enable strict matching for both package name and version, or use <code>strict-name</code> and <code>strict-version</code> independently. Set <code>absent</code> to list hosts where the package (and optional version) is not installed.</td>
       <td markdown="block">
         ```bash
         curl --fail-with-body -L -s -X GET -H "Authorization: Bearer <APIKEY>" https://repomanager.mydomain.net/api/v2/hosts/package/nginx
@@ -418,6 +418,14 @@ Once generated, copy the key and keep it safe. This key is used to authenticate
         ```bash
         curl --fail-with-body -L -s -X GET -H "Authorization: Bearer <APIKEY>" "https://repomanager.mydomain.net/api/v2/hosts/package/nginx/1.24.0-1?strict-version"
         ```
+        Return hosts where package is absent:
+        ```bash
+        curl --fail-with-body -L -s -X GET -H "Authorization: Bearer <APIKEY>" "https://repomanager.mydomain.net/api/v2/hosts/package/nginx?absent"
+        ```
+        Return hosts where exact package version is absent:
+        ```bash
+        curl --fail-with-body -L -s -X GET -H "Authorization: Bearer <APIKEY>" "https://repomanager.mydomain.net/api/v2/hosts/package/nginx/1.24.0-1?absent&strict"
+        ```
       </td>
     </tr>
     <tr>

www/controllers/Api/Hosts/Hosts.php

@@ -99,11 +99,14 @@ public function execute(): array
                     $strictVersion = true;
                 }
 
+                // If the "absent" query parameter is set, return hosts on which the package is NOT installed
+                $absent = isset($_GET['absent']);
+
                 if (empty($this->uri[5])) {
                     throw new Exception('You must specify a package');
                 }
 
-                return ['results' => $hostListingController->getByPackage($this->uri[5], $version, $strictName, $strictVersion)];
+                return ['results' => $hostListingController->getByPackage($this->uri[5], $version, $strictName, $strictVersion, $absent)];
             }
 
             /**

www/controllers/Host/Listing.php

@@ -76,8 +76,9 @@ public function getByGroup(string $group): array
 
     /**
      *  Return hosts that have the specified package
+     *  If $absent is true, return hosts that do NOT have the specified package instead
      */
-    public function getByPackage(string $name, string $version = '', bool $strictName = false, bool $strictVersion = false): array
+    public function getByPackage(string $name, string $version = '', bool $strictName = false, bool $strictVersion = false, bool $absent = false): array
     {
         $data = [];
 
@@ -96,6 +97,21 @@ public function getByPackage(string $name, string $version = '', bool $strictNam
             $hostPackageController = new HostPackage($host['Id']);
             $results = $hostPackageController->searchPackage($name, $version, $strictName, $strictVersion);
 
+            // If looking for hosts on which the package is absent
+            if ($absent) {
+                // If the host has the specified package, continue to the next host
+                if (!empty($results)) {
+                    continue;
+                }
+
+                $data[] = [
+                    'id' => $host['Id'],
+                    'hostname' => $host['Hostname']
+                ];
+
+                continue;
+            }
+
             // If the host does not have the specified package, continue to the next host
             if (empty($results)) {
                 continue;