linuxfabrik-lib 2.2.0__tar.gz → 2.3.0__tar.gz

{linuxfabrik_lib-2.2.0/linuxfabrik_lib.egg-info → linuxfabrik_lib-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linuxfabrik-lib
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python libraries used in various Linuxfabrik projects, including the 'Linuxfabrik Monitoring Plugins' project.
 Author-email: "Linuxfabrik GmbH, Zurich, Switzerland" <info@linuxfabrik.ch>
 Project-URL: Homepage, https://github.com/Linuxfabrik/lib

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/distro.py

@@ -17,7 +17,7 @@ Source Code is taken, converted, shortened and modified from:
 """
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025042002'
+__version__ = '2025061001'
 
 
 import os
@@ -51,7 +51,7 @@ SEARCH_STRING = {
 
 OS_FAMILY_MAP = {
     'RedHat': ['RedHat', 'RHEL', 'CentOS', 'Scientific', 'OracleLinux', 'Fedora', 'AlmaLinux', 'Rocky'],
-    'Debian': ['Debian', 'Debian GNU/Linux', 'Ubuntu', 'Raspbian', 'Pop!_OS', 'Kali', 'Parrot', 'Devuan', 'Deepin', 'Mint'],
+    'Debian': ['Debian', 'Debian GNU/Linux', 'Ubuntu', 'Raspbian', 'Pop!_OS', 'Kali', 'Parrot', 'Devuan', 'Devuan GNU/Linux', 'Deepin', 'Mint'],
     'Suse': ['SUSE', 'openSUSE', 'SLES', 'SLED'],
     'Archlinux': ['Archlinux', 'Manjaro', 'Antergos'],
     'Gentoo': ['Gentoo', 'Funtoo'],
@@ -400,7 +400,7 @@ def get_distribution_facts():
     """
     facts = _process_dist_files()
 
-    distro = facts.get('distribution', 'NA')
+    distro = facts.get('distribution_file_variety', 'distribution')
     facts['os_family'] = _map_os_family(distro)  # returns 'RedHat', for example
 
     cmd = '. /etc/os-release && echo "$NAME $VERSION"'

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/endoflifedate.py

@@ -462,22 +462,22 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/gitlab.json': [
     {   'cycle': '18.0',
         'eol': '2025-08-21',
-        'latest': '18.0.1',
-        'latestReleaseDate': '2025-05-21',
+        'latest': '18.0.2',
+        'latestReleaseDate': '2025-06-11',
         'lts': False,
         'releaseDate': '2025-05-15',
         'support': '2025-06-19'},
     {   'cycle': '17.11',
         'eol': '2025-07-17',
-        'latest': '17.11.3',
-        'latestReleaseDate': '2025-05-21',
+        'latest': '17.11.4',
+        'latestReleaseDate': '2025-06-11',
         'lts': False,
         'releaseDate': '2025-04-16',
         'support': '2025-05-15'},
     {   'cycle': '17.10',
         'eol': '2025-06-19',
-        'latest': '17.10.7',
-        'latestReleaseDate': '2025-05-21',
+        'latest': '17.10.8',
+        'latestReleaseDate': '2025-06-11',
         'lts': False,
         'releaseDate': '2025-03-19',
         'support': '2025-04-17'},
@@ -823,43 +823,43 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/grafana.json': [
     {   'cycle': '12.0',
         'eol': '2026-01-31',
-        'latest': '12.0.1',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '12.0.2',
+        'latestReleaseDate': '2025-06-17',
         'lts': False,
         'releaseDate': '2025-05-05',
         'support': True},
     {   'cycle': '11.6',
         'eol': '2026-06-30',
-        'latest': '11.6.2',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '11.6.3',
+        'latestReleaseDate': '2025-06-17',
         'lts': False,
         'releaseDate': '2025-03-25',
         'support': '2025-05-05'},
     {   'cycle': '11.5',
         'eol': '2025-10-31',
-        'latest': '11.5.5',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '11.5.6',
+        'latestReleaseDate': '2025-06-17',
         'lts': False,
         'releaseDate': '2025-01-28',
         'support': '2025-03-25'},
     {   'cycle': '11.4',
         'eol': '2025-09-30',
-        'latest': '11.4.5',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '11.4.6',
+        'latestReleaseDate': '2025-06-17',
         'lts': False,
         'releaseDate': '2024-12-05',
         'support': '2025-01-28'},
     {   'cycle': '11.3',
         'eol': '2025-07-31',
-        'latest': '11.3.7',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '11.3.8',
+        'latestReleaseDate': '2025-06-17',
         'lts': False,
         'releaseDate': '2024-10-22',
         'support': '2024-12-05'},
     {   'cycle': '11.2',
         'eol': '2025-05-31',
-        'latest': '11.2.10',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '11.2.10+security-01',
+        'latestReleaseDate': '2025-06-12',
         'lts': False,
         'releaseDate': '2024-08-27',
         'support': '2024-10-22'},
@@ -879,8 +879,8 @@ ENDOFLIFE_DATE = {
         'support': '2024-06-21'},
     {   'cycle': '10.4',
         'eol': '2025-06-30',
-        'latest': '10.4.19',
-        'latestReleaseDate': '2025-05-22',
+        'latest': '10.4.19+security-01',
+        'latestReleaseDate': '2025-06-12',
         'lts': False,
         'releaseDate': '2024-03-05',
         'support': '2025-06-30'},
@@ -981,14 +981,14 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/graylog.json': [
     {   'cycle': '6.2',
         'eol': False,
-        'latest': '6.2.2',
-        'latestReleaseDate': '2025-05-07',
+        'latest': '6.2.3',
+        'latestReleaseDate': '2025-06-04',
         'lts': False,
         'releaseDate': '2025-04-28'},
     {   'cycle': '6.1',
         'eol': False,
-        'latest': '6.1.11',
-        'latestReleaseDate': '2025-05-07',
+        'latest': '6.1.12',
+        'latestReleaseDate': '2025-06-04',
         'lts': False,
         'releaseDate': '2024-10-18'},
     {   'cycle': '6.0',
@@ -1139,6 +1139,123 @@ ENDOFLIFE_DATE = {
     ],
 
 
+    'https://endoflife.date/api/icinga.json': [
+    {   'cycle': '2.14',
+        'eol': False,
+        'latest': '2.14.6',
+        'latestReleaseDate': '2025-05-21',
+        'lts': False,
+        'releaseDate': '2023-07-12',
+        'support': True},
+    {   'cycle': '2.13',
+        'eol': False,
+        'latest': '2.13.12',
+        'latestReleaseDate': '2025-05-22',
+        'lts': False,
+        'releaseDate': '2021-08-02',
+        'support': '2023-07-12'},
+    {   'cycle': '2.12',
+        'eol': '2023-07-12',
+        'latest': '2.12.12',
+        'latestReleaseDate': '2025-05-22',
+        'lts': False,
+        'releaseDate': '2020-08-03',
+        'support': '2021-08-02'},
+    {   'cycle': '2.11',
+        'eol': '2021-08-02',
+        'latest': '2.11.12',
+        'latestReleaseDate': '2024-10-29',
+        'lts': False,
+        'releaseDate': '2019-09-19',
+        'support': '2020-08-03'},
+    {   'cycle': '2.10',
+        'eol': '2020-08-03',
+        'latest': '2.12.10',
+        'latestReleaseDate': '2023-02-16',
+        'lts': False,
+        'releaseDate': '2018-10-11',
+        'support': '2019-09-19'},
+    {   'cycle': '2.9',
+        'eol': '2018-10-11',
+        'latest': '2.9.3',
+        'latestReleaseDate': '2019-07-30',
+        'lts': False,
+        'releaseDate': '2018-07-17',
+        'support': '2018-10-11'},
+    {   'cycle': '2.8',
+        'eol': '2018-07-17',
+        'latest': '2.8.4',
+        'latestReleaseDate': '2018-04-25',
+        'lts': False,
+        'releaseDate': '2017-11-16',
+        'support': '2018-07-17'},
+    {   'cycle': '2.7',
+        'eol': '2017-11-16',
+        'latest': '2.7.2',
+        'latestReleaseDate': '2017-11-09',
+        'lts': False,
+        'releaseDate': '2017-08-02',
+        'support': '2017-11-16'},
+    {   'cycle': '2.6',
+        'eol': '2017-08-02',
+        'latest': '2.6.3',
+        'latestReleaseDate': '2017-03-29',
+        'lts': False,
+        'releaseDate': '2016-12-13',
+        'support': '2017-08-02'},
+    {   'cycle': '2.5',
+        'eol': '2016-12-13',
+        'latest': '2.5.4',
+        'latestReleaseDate': '2016-08-30',
+        'lts': False,
+        'releaseDate': '2016-08-22',
+        'support': '2016-12-13'},
+    {   'cycle': '2.4',
+        'eol': '2016-08-22',
+        'latest': '2.4.10',
+        'latestReleaseDate': '2016-05-19',
+        'lts': False,
+        'releaseDate': '2015-11-16',
+        'support': '2016-08-22'},
+    {   'cycle': '2.3',
+        'eol': '2015-11-16',
+        'latest': '2.3.11',
+        'latestReleaseDate': '2015-10-19',
+        'lts': False,
+        'releaseDate': '2015-03-09',
+        'support': '2015-11-16'},
+    {   'cycle': '2.2',
+        'eol': '2015-03-09',
+        'latest': '2.2.4',
+        'latestReleaseDate': '2015-02-05',
+        'lts': False,
+        'releaseDate': '2014-11-17',
+        'support': '2015-03-09'},
+    {   'cycle': '2.1',
+        'eol': '2014-11-17',
+        'latest': '2.1.1',
+        'latestReleaseDate': '2014-09-16',
+        'lts': False,
+        'releaseDate': '2014-08-29',
+        'support': '2014-11-17'},
+    {   'cycle': '2.0',
+        'eol': '2014-08-29',
+        'latest': '2.0.2',
+        'latestReleaseDate': '2014-08-07',
+        'lts': False,
+        'releaseDate': '2014-06-16',
+        'support': '2014-08-29'},
+    {   'cycle': '1',
+        'eol': '2018-12-31',
+        'latest': '1.14.2',
+        'latestReleaseDate': '2017-12-20',
+        'link': None,
+        'lts': False,
+        'releaseDate': '2009-12-15',
+        'support': '2014-06-16'},
+    ],
+
+
     'https://endoflife.date/api/keycloak.json': [
     {   'cycle': '26.2',
         'eol': False,
@@ -1276,6 +1393,13 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/mariadb.json': [
+    {   'cycle': '11.8',
+        'eol': '2028-06-04',
+        'extendedSupport': '2033-10-15',
+        'latest': '11.8.2',
+        'latestReleaseDate': '2025-06-04',
+        'lts': True,
+        'releaseDate': '2025-06-04'},
     {   'cycle': '11.7',
         'eol': '2025-05-12',
         'extendedSupport': False,
@@ -1626,24 +1750,24 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/moodle.json': [
     {   'cycle': '5.0',
         'eol': '2026-10-05',
-        'latest': '5.0.0',
-        'latestReleaseDate': '2025-04-13',
+        'latest': '5.0.1',
+        'latestReleaseDate': '2025-06-09',
         'lts': False,
         'releaseDate': '2025-04-14',
         'support': '2026-04-20',
         'supportedPhpVersions': '8.1 - 8.4'},
     {   'cycle': '4.5',
         'eol': '2027-10-06',
-        'latest': '4.5.4',
-        'latestReleaseDate': '2025-04-13',
+        'latest': '4.5.5',
+        'latestReleaseDate': '2025-06-09',
         'lts': True,
         'releaseDate': '2024-10-07',
         'support': '2025-10-06',
         'supportedPhpVersions': '8.1 - 8.3'},
     {   'cycle': '4.4',
         'eol': '2025-12-08',
-        'latest': '4.4.8',
-        'latestReleaseDate': '2025-04-13',
+        'latest': '4.4.9',
+        'latestReleaseDate': '2025-06-09',
         'lts': False,
         'releaseDate': '2024-04-22',
         'support': '2025-04-21',
@@ -1666,8 +1790,8 @@ ENDOFLIFE_DATE = {
         'supportedPhpVersions': '8.0 - 8.2'},
     {   'cycle': '4.1',
         'eol': '2025-12-08',
-        'latest': '4.1.18',
-        'latestReleaseDate': '2025-04-13',
+        'latest': '4.1.19',
+        'latestReleaseDate': '2025-06-09',
         'lts': True,
         'releaseDate': '2022-11-28',
         'support': '2023-12-11',
@@ -1790,6 +1914,7 @@ ENDOFLIFE_DATE = {
         'eol': '2021-02-28',
         'latest': '5.6.51',
         'latestReleaseDate': '2021-01-05',
+        'link': 'https://web.archive.org/web/20211229071247/https://dev.mysql.com/doc/relnotes/mysql/5.6/en/news-5-6-51.html',
         'lts': False,
         'releaseDate': '2013-02-01',
         'support': '2018-02-28'},
@@ -1797,6 +1922,7 @@ ENDOFLIFE_DATE = {
         'eol': '2018-12-31',
         'latest': '5.5.63',
         'latestReleaseDate': '2018-12-21',
+        'link': None,
         'lts': False,
         'releaseDate': '2010-12-03',
         'support': '2015-12-31'},
@@ -1806,14 +1932,14 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/nextcloud.json': [
     {   'cycle': '31',
         'eol': '2026-02-28',
-        'latest': '31.0.5',
-        'latestReleaseDate': '2025-05-15',
+        'latest': '31.0.6',
+        'latestReleaseDate': '2025-06-12',
         'lts': False,
         'releaseDate': '2025-02-25'},
     {   'cycle': '30',
         'eol': '2025-09-30',
-        'latest': '30.0.11',
-        'latestReleaseDate': '2025-05-15',
+        'latest': '30.0.12',
+        'latestReleaseDate': '2025-06-12',
         'lts': False,
         'releaseDate': '2024-09-14'},
     {   'cycle': '29',
@@ -1952,15 +2078,15 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/php.json': [
     {   'cycle': '8.4',
         'eol': '2028-12-31',
-        'latest': '8.4.7',
-        'latestReleaseDate': '2025-05-08',
+        'latest': '8.4.8',
+        'latestReleaseDate': '2025-06-05',
         'lts': False,
         'releaseDate': '2024-11-21',
         'support': '2026-12-31'},
     {   'cycle': '8.3',
         'eol': '2027-12-31',
-        'latest': '8.3.21',
-        'latestReleaseDate': '2025-05-08',
+        'latest': '8.3.22',
+        'latestReleaseDate': '2025-06-05',
         'lts': False,
         'releaseDate': '2023-11-23',
         'support': '2025-12-31'},
@@ -2322,36 +2448,36 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/python.json': [
     {   'cycle': '3.13',
         'eol': '2029-10-31',
-        'latest': '3.13.3',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '3.13.5',
+        'latestReleaseDate': '2025-06-11',
         'lts': False,
         'releaseDate': '2024-10-07',
         'support': '2026-10-01'},
     {   'cycle': '3.12',
         'eol': '2028-10-31',
-        'latest': '3.12.10',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '3.12.11',
+        'latestReleaseDate': '2025-06-03',
         'lts': False,
         'releaseDate': '2023-10-02',
         'support': '2025-04-02'},
     {   'cycle': '3.11',
         'eol': '2027-10-31',
-        'latest': '3.11.12',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '3.11.13',
+        'latestReleaseDate': '2025-06-03',
         'lts': False,
         'releaseDate': '2022-10-24',
         'support': '2024-04-01'},
     {   'cycle': '3.10',
         'eol': '2026-10-31',
-        'latest': '3.10.17',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '3.10.18',
+        'latestReleaseDate': '2025-06-03',
         'lts': False,
         'releaseDate': '2021-10-04',
         'support': '2023-04-05'},
     {   'cycle': '3.9',
         'eol': '2025-10-31',
-        'latest': '3.9.22',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '3.9.23',
+        'latestReleaseDate': '2025-06-03',
         'lts': False,
         'releaseDate': '2020-10-05',
         'support': '2022-05-17'},
@@ -2594,45 +2720,52 @@ ENDOFLIFE_DATE = {
 
 
     'https://endoflife.date/api/rocketchat.json': [
+    {   'cycle': '7.7',
+        'eol': '2025-11-30',
+        'latest': '7.7.1',
+        'latestReleaseDate': '2025-06-12',
+        'lts': False,
+        'releaseDate': '2025-05-31',
+        'support': '2025-05-31'},
     {   'cycle': '7.6',
         'eol': '2025-11-30',
-        'latest': '7.6.1',
-        'latestReleaseDate': '2025-05-23',
+        'latest': '7.6.3',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2025-05-13',
         'support': '2025-05-13'},
     {   'cycle': '7.5',
         'eol': '2025-10-31',
-        'latest': '7.5.1',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '7.5.2',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2025-04-07',
         'support': '2025-04-07'},
     {   'cycle': '7.4',
         'eol': '2025-08-31',
-        'latest': '7.4.2',
-        'latestReleaseDate': '2025-04-08',
+        'latest': '7.4.3',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2025-03-05',
         'support': '2025-03-05'},
     {   'cycle': '7.3',
         'eol': '2025-07-31',
-        'latest': '7.3.4',
-        'latestReleaseDate': '2025-03-11',
+        'latest': '7.3.5',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2025-01-31',
         'support': '2025-01-31'},
     {   'cycle': '7.2',
         'eol': '2025-07-31',
-        'latest': '7.2.5',
-        'latestReleaseDate': '2025-03-01',
+        'latest': '7.2.6',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2025-01-07',
         'support': '2025-01-07'},
     {   'cycle': '7.1',
         'eol': '2025-06-30',
-        'latest': '7.1.5',
-        'latestReleaseDate': '2025-03-01',
+        'latest': '7.1.6',
+        'latestReleaseDate': '2025-06-06',
         'lts': False,
         'releaseDate': '2024-12-04',
         'support': '2024-12-04'},
@@ -3095,8 +3228,8 @@ ENDOFLIFE_DATE = {
     'https://endoflife.date/api/valkey.json': [
     {   'cycle': '8.1',
         'eol': False,
-        'latest': '8.1.1',
-        'latestReleaseDate': '2025-04-23',
+        'latest': '8.1.2',
+        'latestReleaseDate': '2025-06-11',
         'lts': False,
         'releaseDate': '2025-03-31',
         'support': True},

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0/linuxfabrik_lib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linuxfabrik-lib
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python libraries used in various Linuxfabrik projects, including the 'Linuxfabrik Monitoring Plugins' project.
 Author-email: "Linuxfabrik GmbH, Zurich, Switzerland" <info@linuxfabrik.ch>
 Project-URL: Homepage, https://github.com/Linuxfabrik/lib

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/net.py

@@ -13,7 +13,7 @@
 """
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025052001'
+__version__ = '2025053001'
 
 import random
 import re
@@ -327,10 +327,14 @@ def fetch_ssl(host, port, msg=None, timeout=3):
     >>> success, response = fetch_ssl('example.com', 443, b'GET / HTTP/1.0\\r\\nHost: example.com\\r\\n\\r\\n')
     """
     def open_ssl_socket():
-        context = ssl.create_default_context()
-        # forcing TLS 1.2+
-        ctx.options |= ssl.OP_NO_TLSv1
-        ctx.options |= ssl.OP_NO_TLSv1_1
+        # PROTOCOL_TLS_CLIENT automatically disables SSLv2/3 and
+        # TLSv1.0/1.1 on recent OpenSSL builds
+        context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
+
+        # context.check_hostname = True
+        # context.verify_mode = ssl.CERT_REQUIRED
+        context.minimum_version = ssl.TLSVersion.TLSv1_2  # enforce at least TLS 1.2 just to be sure
+
         raw_sock = socket.socket(socket.AF_INET, SOCK_TCP)
         return context.wrap_socket(raw_sock, server_hostname=host)
 

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/pyproject.toml

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

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/shell.py

@@ -12,7 +12,7 @@
 """
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025042001'
+__version__ = '2025060401'
 
 
 import os
@@ -84,51 +84,64 @@ def get_command_output(cmd, regex=None):
     return output
 
 
-def shell_exec(cmd, env=None, shell=False, stdin='', cwd=None, timeout=None):
+def shell_exec(cmd, env=None, shell=False, stdin='', cwd=None, timeout=None, lc_all='C'):
     """
     Execute a command in a subprocess with flexible options for shell execution, environment
     variables, piping, standard input, working directory, and a timeout.
 
-    On Windows, the function changes the codepage to 65001 (UTF-8) so that command output is
+    On Windows, the function changes the code page to 65001 (UTF-8) so that command output is
     handled in UTF-8.
 
     ### Parameters
     - **cmd** (`str`):  
-      The command string to execute. Use `|` to separate piped commands.
+      The command string to execute. If using pipes (`|`), individual commands will be run
+      in a pipeline when `shell=False`. If `shell=True`, the entire string is passed to the shell.
     - **env** (`dict`, optional):  
       A dictionary of environment variables to merge with the current OS environment.
       Defaults to the current environment.
     - **shell** (`bool`, optional):  
-      If True, execute using the shell. Required when using shell features or stdin.
-      Defaults to False.
+      If True, execute the command through the shell. Required when using shell features
+      (e.g., redirection, globbing) or when providing `stdin`. Defaults to False.
     - **stdin** (`str`, optional):  
-      A string to pass as standard input to the command. Defaults to ''.
+      A string to pass as standard input to the command. If non‐empty, `shell` will be set
+      to True on Windows. Defaults to an empty string.
     - **cwd** (`str`, optional):  
       Working directory in which to execute the command. Defaults to None (current directory).
     - **timeout** (`int` or `float`, optional):  
-      Maximum time (in seconds) to allow the command to run. If exceeded, the process is terminated.
-      Defaults to None.
+      Maximum time (in seconds) to allow the command to run. If exceeded, the process is
+      terminated. Defaults to None (no timeout).
+    - **lc_all** (`str`, optional):  
+      Value to set for the `LC_ALL` environment variable, forcing command output locale.
+      Defaults to `'C'` (POSIX "C" locale, i.e., English).
 
     ### Returns
     - **tuple**:  
-      On success:  
-      `(True, (stdout, stderr, return_code))`  
-      - **stdout** (`str`): Standard output of the command.  
-      - **stderr** (`str`): Standard error of the command.  
-      - **return_code** (`int`): Exit status of the command.  
-
-      On failure:  
-      `(False, error_message)` — a string describing the error.
+      - On success:  
+        `(True, (stdout, stderr, return_code))`  
+        - **stdout** (`str`): Standard output of the command (decoded to text).  
+        - **stderr** (`str`): Standard error of the command (decoded to text).  
+        - **return_code** (`int`): Exit status of the command.  
+      - On failure:  
+        `(False, error_message)` — a string describing the error.
 
     ### Notes
-    - Output is always forced to English by setting `LC_ALL=C`.
-    - On Windows, the command is prepended with `chcp 65001 &&` to ensure UTF-8 output.
-    - If `shell=False` and the command contains pipes (`|`), it creates a manual pipeline.
-    - Exceptions such as `OSError`, `ValueError`, or general execution errors are caught and
-      reported.
+    - The environment is merged with `env` and always includes `LC_ALL=<lc_all>`, forcing output
+      to the specified locale.
+    - On Windows (`os.name == 'nt'`), `cmd` is automatically prefixed with `chcp 65001 &&` to
+      switch to UTF-8 code page, and `shell` is set to True.
+    - If `shell=False` and `cmd` contains pipes (`|`), the function splits `cmd` on `|` and
+      creates a pipeline of subprocesses. Each segment is run without a shell, with stdout of
+      one feeding stdin of the next.
+    - If `shell=True` or `stdin` is provided, the command is executed in a single shell
+      invocation (`subprocess.Popen(..., shell=True)`). The provided `stdin` string is passed
+      to `communicate()`.
+    - Exceptions such as `OSError`, `ValueError`, or other execution errors during process
+      creation are caught and reported as `(False, <error message>)`.
+    - If the process exceeds the specified `timeout`, it is killed, and the function returns
+      `(False, "Timeout after <timeout> seconds.")`.
     """
     env = {**os.environ.copy(), **(env or {})}
-    env['LC_ALL'] = 'C'
+    env['LC_ALL'] = lc_all
 
     if os.name == 'nt':
         cmd = f'chcp 65001 && {cmd}'

{linuxfabrik_lib-2.2.0 → linuxfabrik_lib-2.3.0}/txt.py

@@ -15,7 +15,7 @@ The functions "to_text()" and "to_bytes()" are copied from
 """
 
 __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
-__version__ = '2025051301'
+__version__ = '2025053101'
 
 import codecs
 import re
@@ -180,22 +180,22 @@ def filter_mltext(_input, ignore):
     >>> filter_mltext('abcde', 'a')  # "ignore" has to be a list
     ''
 
-    >>> s = 'Lorem ipsum\n\ndolor sit amet\n\nconsectetur adipisicing'
+    >>> s = 'Lorem ipsum\\n\\ndolor sit amet\\n\\nconsectetur adipisicing'
     >>> filter_mltext(s, ['ipsum'])
-    '\ndolor sit amet\n\nconsectetur adipisicing\n'
+    '\\ndolor sit amet\\n\\nconsectetur adipisicing\\n'
 
     >>> filter_mltext(s, ['dol'])
-    'Lorem ipsum\n\n\nconsectetur adipisicing\n'
+    'Lorem ipsum\\n\\n\\nconsectetur adipisicing\\n'
 
     >>> filter_mltext(s, ['Dol'])
-    'Lorem ipsum\n\ndolor sit amet\n\nconsectetur adipisicing\n'
+    'Lorem ipsum\\n\\ndolor sit amet\\n\\nconsectetur adipisicing\\n'
 
     >>> filter_mltext(s, ['d'])
-    'Lorem ipsum\n\n\n'
+    'Lorem ipsum\\n\\n\\n'
 
     >>> s = 'Lorem ipsum'
     >>> filter_mltext(s, ['Dol'])
-    'Lorem ipsum\n'
+    'Lorem ipsum\\n'
 
     >>> filter_mltext(s, ['ipsum'])
     ''
@@ -254,7 +254,7 @@ def mltext2array(_input, skip_header=False, sort_key=-1):
     - **list of list**: A list where each inner list represents a line split by whitespace.
 
     ### Example
-    >>> s = '1662130953 timedatex\n1662130757 python3-pip-wheel\n1662130975 python3-dateutil'
+    >>> s = '1662130953 timedatex\\n1662130757 python3-pip-wheel\\n1662130975 python3-dateutil'
 
     >>> mltext2array(s, skip_header=False, sort_key=0)
     [['1662130757', 'python3-pip-wheel'], ['1662130953', 'timedatex'], ['1662130975', 'python3-dateutil']]