linuxfabrik-lib 3.3.0__tar.gz → 3.4.1__tar.gz

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linuxfabrik-lib
-Version: 3.3.0
+Version: 3.4.1
 Summary: Python libraries used in various Linuxfabrik projects, including the 'Linuxfabrik Monitoring Plugins' project.
 Author-email: "Linuxfabrik GmbH, Zurich, Switzerland" <info@linuxfabrik.ch>
 License: This is free and unencumbered software released into the public domain.
@@ -97,6 +97,11 @@ A mature, production-grade Python library collection providing 35+ modules with
 The library requires Python 3.9+ and runs on every platform.
 
 
+## Documentation
+
+Full documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
+
+
 ## Installation
 
 Add `linuxfabrik-lib` as a dependency to your project, or install it manually:
@@ -106,11 +111,6 @@ pip install --user linuxfabrik-lib
 ```
 
 
-## Documentation
-
-Full API documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
-
-
 ## Design Principles
 
 These libraries are built with a clear set of priorities:

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/README.md

@@ -29,6 +29,11 @@ A mature, production-grade Python library collection providing 35+ modules with
 The library requires Python 3.9+ and runs on every platform.
 
 
+## Documentation
+
+Full documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
+
+
 ## Installation
 
 Add `linuxfabrik-lib` as a dependency to your project, or install it manually:
@@ -38,11 +43,6 @@ pip install --user linuxfabrik-lib
 ```
 
 
-## Documentation
-
-Full API documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
-
-
 ## Design Principles
 
 These libraries are built with a clear set of priorities:

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/endoflifedate.py

@@ -54,8 +54,8 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/composer.json': [
     {   'cycle': '2.9',
         'eol': False,
-        'latest': '2.9.5',
-        'latestReleaseDate': '2026-01-29',
+        'latest': '2.9.7',
+        'latestReleaseDate': '2026-04-14',
         'lts': False,
         'releaseDate': '2025-11-13'},
     {   'cycle': '2.8',
@@ -96,10 +96,22 @@ ENDOFLIFE_DATE = {
         'releaseDate': '2022-03-30'},
     {   'cycle': '2.2',
         'eol': False,
-        'latest': '2.2.26',
-        'latestReleaseDate': '2025-12-30',
+        'latest': '2.2.27',
+        'latestReleaseDate': '2026-04-14',
         'lts': True,
         'releaseDate': '2021-12-22'},
+    {   'cycle': '2.1',
+        'eol': '2021-12-22',
+        'latest': '2.1.14',
+        'latestReleaseDate': '2021-11-30',
+        'lts': False,
+        'releaseDate': '2021-06-03'},
+    {   'cycle': '2.0',
+        'eol': '2021-06-03',
+        'latest': '2.0.14',
+        'latestReleaseDate': '2021-05-21',
+        'lts': False,
+        'releaseDate': '2020-10-24'},
     {   'cycle': '1',
         'eol': '2020-10-24',
         'latest': '1.10.27',
@@ -110,6 +122,12 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/fedora.json': [
+    {   'cycle': '44',
+        'eol': '2027-06-02',
+        'latest': '44',
+        'latestReleaseDate': '2026-04-28',
+        'lts': False,
+        'releaseDate': '2026-04-28'},
     {   'cycle': '43',
         'eol': '2026-12-09',
         'latest': '43',
@@ -118,7 +136,7 @@ ENDOFLIFE_DATE = {
         'releaseDate': '2025-10-28'},
     {   'codename': 'Adams',
         'cycle': '42',
-        'eol': '2026-05-13',
+        'eol': '2026-05-27',
         'latest': '42',
         'latestReleaseDate': '2025-04-15',
         'lts': False,
@@ -433,6 +451,11 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/fortios.json': [
+    {   'cycle': '8.0',
+        'eol': '2030-10-21',
+        'lts': False,
+        'releaseDate': '2026-04-21',
+        'support': '2029-04-21'},
     {   'cycle': '7.6',
         'eol': '2030-01-25',
         'lts': False,
@@ -472,17 +495,24 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/gitlab.json': [
+    {   'cycle': '18.11',
+        'eol': '2026-07-16',
+        'latest': '18.11.2',
+        'latestReleaseDate': '2026-04-28',
+        'lts': False,
+        'releaseDate': '2026-04-16',
+        'support': '2026-05-21'},
     {   'cycle': '18.10',
         'eol': '2026-06-18',
-        'latest': '18.10.3',
-        'latestReleaseDate': '2026-04-07',
+        'latest': '18.10.5',
+        'latestReleaseDate': '2026-04-28',
         'lts': False,
         'releaseDate': '2026-03-19',
         'support': '2026-04-16'},
     {   'cycle': '18.9',
         'eol': '2026-05-21',
-        'latest': '18.9.5',
-        'latestReleaseDate': '2026-04-07',
+        'latest': '18.9.6',
+        'latestReleaseDate': '2026-04-21',
         'lts': False,
         'releaseDate': '2026-02-19',
         'support': '2026-03-19'},
@@ -903,13 +933,20 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/grafana.json': [
+    {   'cycle': '13.0',
+        'eol': '2027-01-09',
+        'latest': '13.0.1',
+        'latestReleaseDate': '2026-04-17',
+        'lts': False,
+        'releaseDate': '2026-04-14',
+        'support': True},
     {   'cycle': '12.4',
         'eol': '2027-05-24',
-        'latest': '12.4.2',
-        'latestReleaseDate': '2026-03-25',
+        'latest': '12.4.3',
+        'latestReleaseDate': '2026-04-14',
         'lts': False,
         'releaseDate': '2026-02-24',
-        'support': '2026-04-24'},
+        'support': '2026-04-17'},
     {   'cycle': '12.3',
         'eol': '2026-08-19',
         'latest': '12.3.6+security-01',
@@ -1262,15 +1299,22 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/icinga.json': [
+    {   'cycle': '2.16',
+        'eol': False,
+        'latest': '2.16.0',
+        'latestReleaseDate': '2026-04-22',
+        'lts': False,
+        'releaseDate': '2026-04-23',
+        'support': True},
     {   'cycle': '2.15',
         'eol': False,
-        'latest': '2.15.2',
-        'latestReleaseDate': '2026-01-29',
+        'latest': '2.15.3',
+        'latestReleaseDate': '2026-04-22',
         'lts': False,
         'releaseDate': '2025-06-17',
-        'support': True},
+        'support': '2026-04-23'},
     {   'cycle': '2.14',
-        'eol': False,
+        'eol': '2026-04-23',
         'latest': '2.14.8',
         'latestReleaseDate': '2026-01-29',
         'lts': False,
@@ -1388,8 +1432,8 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/keycloak.json': [
     {   'cycle': '26.6',
         'eol': False,
-        'latest': '26.6.0',
-        'latestReleaseDate': '2026-04-08',
+        'latest': '26.6.1',
+        'latestReleaseDate': '2026-04-15',
         'lts': False,
         'releaseDate': '2026-04-08'},
     {   'cycle': '26.5',
@@ -1769,20 +1813,20 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/mastodon.json': [
     {   'cycle': '4.5',
         'eol': False,
-        'latest': '4.5.8',
-        'latestReleaseDate': '2026-03-24',
+        'latest': '4.5.9',
+        'latestReleaseDate': '2026-04-15',
         'lts': False,
         'releaseDate': '2025-11-06'},
     {   'cycle': '4.4',
         'eol': False,
-        'latest': '4.4.15',
-        'latestReleaseDate': '2026-03-24',
+        'latest': '4.4.16',
+        'latestReleaseDate': '2026-04-15',
         'lts': False,
         'releaseDate': '2025-07-08'},
     {   'cycle': '4.3',
         'eol': '2026-05-06',
-        'latest': '4.3.21',
-        'latestReleaseDate': '2026-03-24',
+        'latest': '4.3.22',
+        'latestReleaseDate': '2026-04-15',
         'lts': False,
         'releaseDate': '2024-10-08'},
     {   'cycle': '4.2',
@@ -1857,8 +1901,8 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/matomo.json': [
     {   'cycle': '5',
         'eol': False,
-        'latest': '5.8.0',
-        'latestReleaseDate': '2026-03-05',
+        'latest': '5.10.0',
+        'latestReleaseDate': '2026-05-04',
         'lts': False,
         'releaseDate': '2023-12-18',
         'support': True},
@@ -1988,26 +2032,34 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/moodle.json': [
+    {   'cycle': '5.2',
+        'eol': '2027-10-04',
+        'latest': '5.2.0',
+        'latestReleaseDate': '2026-04-16',
+        'lts': False,
+        'releaseDate': '2026-04-20',
+        'support': '2027-04-19',
+        'supportedPhpVersions': '8.2 - 8.4'},
     {   'cycle': '5.1',
         'eol': '2027-04-19',
-        'latest': '5.1.3',
-        'latestReleaseDate': '2026-02-11',
+        'latest': '5.1.4',
+        'latestReleaseDate': '2026-04-16',
         'lts': False,
         'releaseDate': '2025-10-06',
         'support': '2026-10-05',
         'supportedPhpVersions': '8.2 - 8.4'},
     {   'cycle': '5.0',
         'eol': '2026-10-05',
-        'latest': '5.0.6',
-        'latestReleaseDate': '2026-02-11',
+        'latest': '5.0.7',
+        'latestReleaseDate': '2026-04-16',
         'lts': False,
         'releaseDate': '2025-04-14',
         'support': '2026-04-20',
         'supportedPhpVersions': '8.1 - 8.4'},
     {   'cycle': '4.5',
         'eol': '2027-10-04',
-        'latest': '4.5.10',
-        'latestReleaseDate': '2026-02-11',
+        'latest': '4.5.11',
+        'latestReleaseDate': '2026-04-16',
         'lts': True,
         'releaseDate': '2024-10-07',
         'support': '2025-10-06',
@@ -2088,14 +2140,22 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/mysql.json': [
+    {   'cycle': '9.7',
+        'eol': '2034-04-21',
+        'latest': '9.7.0',
+        'latestReleaseDate': '2026-04-07',
+        'link': 'https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-0.html',
+        'lts': True,
+        'releaseDate': '2026-04-21',
+        'support': True},
     {   'cycle': '9.6',
-        'eol': False,
-        'latest': '9.6.0',
-        'latestReleaseDate': '2025-12-23',
+        'eol': '2026-04-21',
+        'latest': '9.6.1',
+        'latestReleaseDate': '2026-01-16',
         'link': 'https://dev.mysql.com/doc/relnotes/mysql/9.6/en/news-9-6-0.html',
         'lts': False,
         'releaseDate': '2026-01-20',
-        'support': True},
+        'support': '2026-04-21'},
     {   'cycle': '9.5',
         'eol': '2026-01-20',
         'latest': '9.5.2',
@@ -2145,8 +2205,8 @@ ENDOFLIFE_DATE = {
         'support': '2024-10-15'},
     {   'cycle': '8.4',
         'eol': '2032-04-30',
-        'latest': '8.4.8',
-        'latestReleaseDate': '2025-12-24',
+        'latest': '8.4.9',
+        'latestReleaseDate': '2026-04-07',
         'lts': True,
         'releaseDate': '2024-04-10',
         'support': '2029-04-30'},
@@ -2173,8 +2233,8 @@ ENDOFLIFE_DATE = {
         'support': '2023-10-25'},
     {   'cycle': '8.0',
         'eol': '2026-04-30',
-        'latest': '8.0.45',
-        'latestReleaseDate': '2026-01-20',
+        'latest': '8.0.46',
+        'latestReleaseDate': '2026-04-07',
         'lts': '2023-07-18',
         'releaseDate': '2018-04-08',
         'support': '2025-04-30'},
@@ -2207,14 +2267,14 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/nextcloud.json': [
     {   'cycle': '33',
         'eol': '2027-02-28',
-        'latest': '33.0.2',
-        'latestReleaseDate': '2026-04-02',
+        'latest': '33.0.3',
+        'latestReleaseDate': '2026-04-30',
         'lts': False,
         'releaseDate': '2026-02-18'},
     {   'cycle': '32',
         'eol': '2026-09-30',
-        'latest': '32.0.8',
-        'latestReleaseDate': '2026-04-02',
+        'latest': '32.0.9',
+        'latestReleaseDate': '2026-04-30',
         'lts': False,
         'releaseDate': '2025-09-27'},
     {   'cycle': '31',
@@ -2361,15 +2421,15 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/openvpn.json': [
     {   'cycle': '2.7',
         'eol': False,
-        'latest': '2.7.1',
-        'latestReleaseDate': '2026-03-31',
+        'latest': '2.7.4',
+        'latestReleaseDate': '2026-04-30',
         'lts': False,
         'releaseDate': '2026-02-11',
         'support': True},
     {   'cycle': '2.6',
         'eol': '2028-08-31',
-        'latest': '2.6.19',
-        'latestReleaseDate': '2026-02-04',
+        'latest': '2.6.20',
+        'latestReleaseDate': '2026-04-22',
         'lts': False,
         'releaseDate': '2023-01-25',
         'support': '2026-08-31'},
@@ -2544,29 +2604,29 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/postfix.json': [
     {   'cycle': '3.11',
         'eol': False,
-        'latest': '3.11.1',
-        'latestReleaseDate': '2026-03-11',
+        'latest': '3.11.2',
+        'latestReleaseDate': '2026-05-02',
         'link': 'https://www.postfix.org/announcements/postfix-3.11.0.html',
         'lts': False,
         'releaseDate': '2026-03-06'},
     {   'cycle': '3.10',
         'eol': False,
-        'latest': '3.10.8',
-        'latestReleaseDate': '2026-02-19',
+        'latest': '3.10.9',
+        'latestReleaseDate': '2026-05-02',
         'link': 'https://www.postfix.org/announcements/postfix-3.10.0.html',
         'lts': False,
         'releaseDate': '2025-02-16'},
     {   'cycle': '3.9',
         'eol': False,
-        'latest': '3.9.9',
-        'latestReleaseDate': '2026-02-19',
+        'latest': '3.9.10',
+        'latestReleaseDate': '2026-05-02',
         'link': 'https://www.postfix.org/announcements/postfix-3.9.2.html',
         'lts': False,
         'releaseDate': '2024-03-06'},
     {   'cycle': '3.8',
         'eol': False,
-        'latest': '3.8.15',
-        'latestReleaseDate': '2026-02-19',
+        'latest': '3.8.16',
+        'latestReleaseDate': '2026-05-02',
         'link': 'https://www.postfix.org/announcements/postfix-3.9.2.html',
         'lts': False,
         'releaseDate': '2023-04-17'},
@@ -3191,43 +3251,43 @@ ENDOFLIFE_DATE = {
         'support': '2026-03-02'},
     {   'cycle': '8.1',
         'eol': '2026-08-31',
-        'latest': '8.1.2',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '8.1.3',
+        'latestReleaseDate': '2026-04-13',
         'lts': False,
         'releaseDate': '2026-02-10',
         'support': '2026-02-10'},
     {   'cycle': '8.0',
         'eol': '2026-06-30',
-        'latest': '8.0.3',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '8.0.4',
+        'latestReleaseDate': '2026-04-13',
         'lts': False,
         'releaseDate': '2026-01-12',
         'support': '2026-01-12'},
     {   'cycle': '7.13',
         'eol': '2026-05-31',
-        'latest': '7.13.5',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '7.13.6',
+        'latestReleaseDate': '2026-04-13',
         'lts': False,
         'releaseDate': '2025-12-05',
         'support': '2025-12-05'},
     {   'cycle': '7.12',
         'eol': '2026-04-30',
-        'latest': '7.12.6',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '7.12.7',
+        'latestReleaseDate': '2026-04-13',
         'lts': False,
         'releaseDate': '2025-10-31',
         'support': '2025-10-31'},
     {   'cycle': '7.11',
         'eol': '2026-03-31',
-        'latest': '7.11.6',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '7.11.7',
+        'latestReleaseDate': '2026-04-13',
         'lts': False,
         'releaseDate': '2025-10-17',
         'support': '2025-10-17'},
     {   'cycle': '7.10',
         'eol': '2026-06-30',
-        'latest': '7.10.9',
-        'latestReleaseDate': '2026-03-16',
+        'latest': '7.10.10',
+        'latestReleaseDate': '2026-04-13',
         'lts': True,
         'releaseDate': '2025-09-04',
         'support': '2025-09-04'},

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/librenms.py

@@ -12,7 +12,7 @@
 needed by LibreNMS check plugins."""
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025042001'
+__version__ = '2026042401'
 
 from . import (
     base,  # pylint: disable=C0413
@@ -124,12 +124,17 @@ def get_state(librestate, severity='crit'):
     """
     Translate LibreNMS service state to a Nagios-compatible state.
 
-    LibreNMS returns a custom service state where:
-      - 0 = OK
-      - 1 = Alert
-      - 2 = Acknowledged
+    LibreNMS encodes the alert lifecycle in `alerts.state` (see
+    `LibreNMS/Enum/AlertState.php`):
+      - 0 = CLEAR / RECOVERED
+      - 1 = ACTIVE
+      - 2 = ACKNOWLEDGED
+      - 3 = WORSE
+      - 4 = BETTER
+      - 5 = CHANGED
 
-    This function maps these LibreNMS states to Nagios exit codes.
+    ACTIVE, WORSE, BETTER and CHANGED all represent an open, notifiable
+    alert, so they map to WARN/CRIT. ACKNOWLEDGED and CLEAR map to OK.
 
     ### Parameters
     - **librestate** (`int`):
@@ -154,8 +159,10 @@ def get_state(librestate, severity='crit'):
     1
     >>> get_state(1, severity='crit')
     2
+    >>> get_state(3, severity='crit')
+    2
     """
 
-    if librestate != 1:
+    if librestate not in (1, 3, 4, 5):
         return STATE_OK
     return STATE_CRIT if severity == 'crit' else STATE_WARN

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/linuxfabrik_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linuxfabrik-lib
-Version: 3.3.0
+Version: 3.4.1
 Summary: Python libraries used in various Linuxfabrik projects, including the 'Linuxfabrik Monitoring Plugins' project.
 Author-email: "Linuxfabrik GmbH, Zurich, Switzerland" <info@linuxfabrik.ch>
 License: This is free and unencumbered software released into the public domain.
@@ -97,6 +97,11 @@ A mature, production-grade Python library collection providing 35+ modules with
 The library requires Python 3.9+ and runs on every platform.
 
 
+## Documentation
+
+Full documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
+
+
 ## Installation
 
 Add `linuxfabrik-lib` as a dependency to your project, or install it manually:
@@ -106,11 +111,6 @@ pip install --user linuxfabrik-lib
 ```
 
 
-## Documentation
-
-Full API documentation is available at [linuxfabrik.github.io/lib](https://linuxfabrik.github.io/lib/). It is automatically built and deployed on every push to `main`.
-
-
 ## Design Principles
 
 These libraries are built with a clear set of priorities:

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linuxfabrik-lib"
-version = "3.3.0"
+version = "3.4.1"
 description = "Python libraries used in various Linuxfabrik projects, including the 'Linuxfabrik Monitoring Plugins' project."
 readme = "README.md"
 authors = [

{linuxfabrik_lib-3.3.0 → linuxfabrik_lib-3.4.1}/time.py

@@ -11,9 +11,10 @@
 """Provides datetime functions."""
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025052801'
+__version__ = '2026042201'
 
 import datetime
+import re
 import sys
 import time
 
@@ -96,6 +97,60 @@ def get_weekday(epoch):
     return _WEEKDAYS[time.localtime(epoch).tm_wday]
 
 
+_MACRO_COMPONENT = re.compile(r'\{%([YymdHMS])\}')
+
+
+def macro2timestr(s, format=''):
+    """
+    Expand time macros in a string.
+
+    Supported macros (case-sensitive, strftime-faithful):
+
+    - `{today}`     → current date, formatted with `format` (default `%Y-%m-%d`).
+    - `{yesterday}` → current date minus one day, formatted with `format`.
+    - `{%Y}` / `{%y}` → 4-digit / 2-digit year of `now`.
+    - `{%m}`        → month of `now` (01-12).
+    - `{%d}`        → day of `now` (01-31).
+    - `{%H}`        → hour of `now` (00-23).
+    - `{%M}`        → minute of `now` (00-59).
+    - `{%S}`        → second of `now` (00-59).
+
+    Unknown tokens are passed through unchanged.
+
+    ### Parameters
+    - **s** (`str`): Template string.
+    - **format** (`str`, optional): strftime pattern used for `{today}`
+      and `{yesterday}`. Defaults to ISO 8601 date `%Y-%m-%d`.
+
+    ### Returns
+    - **str**: `s` with all recognised macros replaced.
+
+    ### Example
+    >>> # Assuming today is 2026-04-22:
+    >>> macro2timestr('/var/log/laravel/laravel-{today}.log')
+    '/var/log/laravel/laravel-2026-04-22.log'
+    >>> macro2timestr('C:\\\\logs\\\\{%Y}{%m}{%d}.log')
+    'C:\\\\logs\\\\20260422.log'
+    >>> macro2timestr('{today}', format='%Y%m%d')
+    '20260422'
+    >>> macro2timestr('{yesterday}', format='%d.%m.%Y')
+    '21.04.2026'
+    """
+    default_format = format or '%Y-%m-%d'
+    base = now(as_type='datetime')
+
+    result = s.replace('{today}', base.strftime(default_format))
+    result = result.replace(
+        '{yesterday}',
+        (base - datetime.timedelta(days=1)).strftime(default_format),
+    )
+
+    return _MACRO_COMPONENT.sub(
+        lambda match: base.strftime('%' + match.group(1)),
+        result,
+    )
+
+
 def now(as_type=''):
     """
     Returns the current date and time in various formats.