ww-net 0.1.0__tar.gz

ww_net-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcus Aurelius
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ww_net-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: ww-net
+Version: 0.1.0
+Summary: Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt via arin_log.
+Author: Marcus Aurelius
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/marcus-aurelius-hu/ww_net
+Project-URL: Repository, https://github.com/marcus-aurelius-hu/ww_net
+Project-URL: Issues, https://github.com/marcus-aurelius-hu/ww_net/issues
+Keywords: netwerk,network,internet,host,dns,check,pipeline
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: arin-log>=0.2.0
+Dynamic: license-file
+
+# py_net
+
+Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt
+via `arin_log`. Gebouwd voor langlopende pipelines die niet mogen vallen
+als het internet even wegvalt.
+
+## Waarom py_net?
+
+- **Hamert het netwerk niet.** Wacht met oplopende intervallen (1s → 15s),
+  niet met een vaste korte poll.
+- **Kiest willekeurig een DNS-server.** Cloudflare, Google, Quad9, OpenDNS —
+  als één plat ligt, probeert hij een andere.
+- **Wacht uren als het moet.** Eén parameter (`wait`) in seconden; tot 12 uur
+  of langer, zonder het netwerk te belasten.
+- **Logt via `arin_log`.** Netwerkproblemen komen in je bestaande logbestand,
+  niet in een apart spoor dat je later moet samenvoegen.
+- **Werkt voor twee vragen.** "Is er internet?" én "Is déze host bereikbaar?"
+
+## Installatie
+
+    pip install ww-net
+
+`arin_log` wordt automatisch mee geïnstalleerd als dependency.
+
+## Gebruik
+
+    from ww_net import is_net, is_host
+
+    # Controleer of er internet is (wacht tot 12 uur)
+    if is_net(wait=43200):
+        print("Internet is beschikbaar")
+
+    # Controleer of een specifieke host bereikbaar is
+    if is_host("https://www.google.com/", wait=43200):
+        print("Host is bereikbaar")
+
+## Wachten
+
+De `wait`-parameter is de tijd (in seconden) waarna `py_net` opgeeft.
+De standaardwaarde is `3600` (1 uur). Omdat het in seconden gaat, kun je
+gemakkelijk langere periodes instellen:
+
+| Duur | Seconden |
+|------|----------|
+| 1 uur | 3600 |
+| 4 uur | 14400 |
+| 8 uur | 28800 |
+| 12 uur | 43200 |
+
+Tijdens het wachten loopt het interval op van 1 seconde tot 15 seconden.
+Zo wordt het netwerk niet onnodig belast, maar blijft `py_net` wel alert.
+
+## API
+
+| Functie | Beschrijving |
+|---------|--------------|
+| `is_net(wait=None, logloc=None)` | Controleert of er internet is. Wacht tot `wait` seconden. |
+| `is_host(host, wait=None, logloc=None)` | Controleert of `host` bereikbaar is. Wacht tot `wait` seconden. |
+
+Beide functies retourneren `True` of `False`.
+
+## Logging
+
+`py_net` logt via `arin_log`. De `logloc`-parameter wordt doorgegeven aan
+`arin_log`, zodat je de logberichten in het juiste logbestand kunt plaatsen.
+
+## Licentie
+
+MIT — zie [LICENSE](LICENSE).

ww_net-0.1.0/README.md

@@ -0,0 +1,69 @@
+# py_net
+
+Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt
+via `arin_log`. Gebouwd voor langlopende pipelines die niet mogen vallen
+als het internet even wegvalt.
+
+## Waarom py_net?
+
+- **Hamert het netwerk niet.** Wacht met oplopende intervallen (1s → 15s),
+  niet met een vaste korte poll.
+- **Kiest willekeurig een DNS-server.** Cloudflare, Google, Quad9, OpenDNS —
+  als één plat ligt, probeert hij een andere.
+- **Wacht uren als het moet.** Eén parameter (`wait`) in seconden; tot 12 uur
+  of langer, zonder het netwerk te belasten.
+- **Logt via `arin_log`.** Netwerkproblemen komen in je bestaande logbestand,
+  niet in een apart spoor dat je later moet samenvoegen.
+- **Werkt voor twee vragen.** "Is er internet?" én "Is déze host bereikbaar?"
+
+## Installatie
+
+    pip install ww-net
+
+`arin_log` wordt automatisch mee geïnstalleerd als dependency.
+
+## Gebruik
+
+    from ww_net import is_net, is_host
+
+    # Controleer of er internet is (wacht tot 12 uur)
+    if is_net(wait=43200):
+        print("Internet is beschikbaar")
+
+    # Controleer of een specifieke host bereikbaar is
+    if is_host("https://www.google.com/", wait=43200):
+        print("Host is bereikbaar")
+
+## Wachten
+
+De `wait`-parameter is de tijd (in seconden) waarna `py_net` opgeeft.
+De standaardwaarde is `3600` (1 uur). Omdat het in seconden gaat, kun je
+gemakkelijk langere periodes instellen:
+
+| Duur | Seconden |
+|------|----------|
+| 1 uur | 3600 |
+| 4 uur | 14400 |
+| 8 uur | 28800 |
+| 12 uur | 43200 |
+
+Tijdens het wachten loopt het interval op van 1 seconde tot 15 seconden.
+Zo wordt het netwerk niet onnodig belast, maar blijft `py_net` wel alert.
+
+## API
+
+| Functie | Beschrijving |
+|---------|--------------|
+| `is_net(wait=None, logloc=None)` | Controleert of er internet is. Wacht tot `wait` seconden. |
+| `is_host(host, wait=None, logloc=None)` | Controleert of `host` bereikbaar is. Wacht tot `wait` seconden. |
+
+Beide functies retourneren `True` of `False`.
+
+## Logging
+
+`py_net` logt via `arin_log`. De `logloc`-parameter wordt doorgegeven aan
+`arin_log`, zodat je de logberichten in het juiste logbestand kunt plaatsen.
+
+## Licentie
+
+MIT — zie [LICENSE](LICENSE).

ww_net-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=77.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ww-net"
+version = "0.1.0"
+description = "Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt via arin_log."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Marcus Aurelius" }
+]
+keywords = ["netwerk", "network", "internet", "host", "dns", "check", "pipeline"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Intended Audience :: Developers",
+    "Topic :: System :: Networking",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "arin-log>=0.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/marcus-aurelius-hu/ww_net"
+Repository = "https://github.com/marcus-aurelius-hu/ww_net"
+Issues = "https://github.com/marcus-aurelius-hu/ww_net/issues"
+
+[tool.setuptools]
+packages = ["ww_net"]

ww_net-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ww_net-0.1.0/ww_net/__init__.py

@@ -0,0 +1,31 @@
+"""
+ww_net
+------
+Een lichtgewicht netwerk-checker voor langlopende pipelines.
+
+Controleert of er internet is en of een specifieke host bereikbaar is.
+Wacht geduldig tot de verbinding terugkomt, met oplopende intervallen,
+en logt ondertussen via arin_log.
+
+Publieke API
+------------
+    is_net(wait=None, logloc=None)
+        Controleert of er internet is.
+
+    is_host(host, wait=None, logloc=None)
+        Controleert of een specifieke host bereikbaar is.
+
+Beide functies retourneren True of False.
+"""
+
+__version__ = "0.1.0"
+
+from ww_net.net import (
+    is_net,
+    is_host,
+)
+
+__all__ = [
+    "is_net",
+    "is_host",
+]

ww_net-0.1.0/ww_net/net.py

@@ -0,0 +1,135 @@
+from socket import gaierror, gethostbyname, socket, AF_INET, SOCK_STREAM
+from time import sleep, time, strftime
+from urllib.parse import urlparse
+from arin_log import log_notes
+from random import choice
+from sys import _getframe
+from os import path
+
+br = chr(10)
+prgnm = path.basename(__file__).split('.')[0]
+
+class CheckNet:
+    def __init__(self, timeout=1.5, wait=3600, logloc=None):
+        self.timeout = timeout
+        self.wait = wait
+        self.dns_servers = ["1.1.1.1", "8.8.8.8", "9.9.9.9", "208.67.222.222"]
+        self.logloc = prgnm if logloc is None else logloc
+        self.slpd = {'1;5': 1, '6;10': 2, '11;20': 3, '21;50': 4, '51;100': 5, '101;150': 6, '151;200': 7,
+                     '201;300': 8, '301;400': 9, '401;600': 10, '601;1000': 11, '1001;1500': 12,
+                     '1501;999999999': 15}
+
+    def get_interval(self, count):
+        """Return the sleep time based on the poll_count without logging."""
+        slpt = 1
+        for key in self.slpd:
+            start, end = map(int, key.split(';'))
+            if start <= count <= end:
+                slpt = self.slpd[key]
+                break
+        return slpt
+
+    def tcp_check(self, ip=None, timeout=None):
+        if timeout is None:
+            timeout = self.timeout if ip is None else 2.0
+        host = choice(self.dns_servers) if ip is None else ip
+        ports = [443, 80]
+
+        for port in ports:
+            try:
+                with socket(AF_INET, SOCK_STREAM) as sock:
+                    sock.settimeout(timeout)
+                    if sock.connect_ex((host, port)) == 0:
+                        return True
+            except Exception:
+                continue
+        return False
+
+    def is_net(self, wait=None, logloc=None):
+        wait = self.wait if wait is None else wait
+        logloc = self.logloc if logloc is None else logloc
+        if self.tcp_check():
+            return True
+        return self.wait_net(typ='internet', wait=wait, logloc=logloc)
+
+    def wait_net(self, typ=None, wait=None, logloc=None):
+        typ = 'internet' if typ is None else typ
+        wait = self.wait if wait is None else wait
+        logloc = self.logloc if logloc is None else logloc
+        fcnm = _getframe().f_code.co_name
+
+        log_notes(f"⚠️ {typ} ; connection ; exception", logloc=logloc)
+        log_notes(f"⚠️ {prgnm} ; {fcnm} ; {strftime('%H:%M:%S')}", cons=False, logloc=logloc)
+        exc_time = time()
+        start_time = time()
+        count = 1
+
+        while time() - start_time < wait:
+            if self.tcp_check():
+                log_notes(f"✅ {typ} ; connection ; restored", logloc=logloc)
+                log_notes(f"✅ {prgnm} ; {fcnm} ; {time() - exc_time:.3f} sec{br}", cons=False, logloc=logloc)
+                return True
+            interval = self.get_interval(count)
+            count += 1
+            sleep(interval)
+        log_notes(f"⚠️ {typ} ; connection ; timeout", logloc=logloc)
+        log_notes(f"⚠️ {prgnm} ; {fcnm} ; {time() - exc_time:.3f} sec{br}", cons=False, logloc=logloc)
+        return False
+
+    def is_host(self, host, wait=None, logloc=None):
+        wait = self.wait if wait is None else wait
+        logloc = self.logloc if logloc is None else logloc
+        fcnm = _getframe().f_code.co_name
+
+        if "://" in host:
+            host = urlparse(host).netloc.replace('www.', '')
+
+        if self.tcp_check():
+            try:
+                gethostbyname(host)
+                start_time = time()
+                exc_time = None
+                count = 1
+                while time() - start_time < wait:
+                    if count == 2:
+                        log_notes(f"⚠️ {host} ; connection ; exception", logloc=logloc)
+                        log_notes(f"⚠️ {prgnm} ; {fcnm} ; {strftime('%H:%M:%S')}", cons=False, logloc=logloc)
+                        exc_time = time()
+                    if self.tcp_check(ip=host):
+                        if count > 1:
+                            log_notes(f"✅ {host} ; connection ; restored", logloc=logloc)
+                            log_notes(f"✅ {prgnm} ; {fcnm} ; {time() - exc_time:.3f} sec{br}", cons=False,
+                                      logloc=logloc)
+                        return True
+                    interval = self.get_interval(count)
+                    count += 1
+                    sleep(interval)
+                log_notes(f"⚠️ {host} ; connection ; timeout", logloc=logloc)
+                log_notes(f"⚠️ {prgnm} ; {fcnm} ; {time() - exc_time:.3f} sec{br}", cons=False, logloc=logloc)
+                return False
+            except gaierror:
+                return self.wait_net(typ=host, wait=wait, logloc=logloc)
+            except Exception:
+                return self.wait_net(typ=host, wait=wait, logloc=logloc)
+        else:
+            return self.wait_net(typ=host, wait=wait, logloc=logloc)
+
+_net = CheckNet()
+
+def is_net(wait=None, logloc=None):
+    return _net.is_net(wait=wait, logloc=logloc)
+
+def is_host(host, wait=None, logloc=None):
+    return _net.is_host(host, wait=wait, logloc=logloc)
+
+__all__ = ['is_net', 'is_host']
+
+if __name__ == "__main__":
+    t0 = time()
+    result = is_net(wait=360)
+    print(f"🌐 internet ; {result} ; {(time() - t0) * 1000:.2f} msec")
+
+    t0 = time()
+    result = is_host('https://nl.investing.com/', wait=360)
+    print(f"🌍 nl.investing.com ; {result} ; {(time() - t0) * 1000:.2f} msec")
+    exit(0)

ww_net-0.1.0/ww_net.egg-info/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: ww-net
+Version: 0.1.0
+Summary: Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt via arin_log.
+Author: Marcus Aurelius
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/marcus-aurelius-hu/ww_net
+Project-URL: Repository, https://github.com/marcus-aurelius-hu/ww_net
+Project-URL: Issues, https://github.com/marcus-aurelius-hu/ww_net/issues
+Keywords: netwerk,network,internet,host,dns,check,pipeline
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: arin-log>=0.2.0
+Dynamic: license-file
+
+# py_net
+
+Een netwerk-checker die geduldig wacht, slim omgaat met DNS, en logt
+via `arin_log`. Gebouwd voor langlopende pipelines die niet mogen vallen
+als het internet even wegvalt.
+
+## Waarom py_net?
+
+- **Hamert het netwerk niet.** Wacht met oplopende intervallen (1s → 15s),
+  niet met een vaste korte poll.
+- **Kiest willekeurig een DNS-server.** Cloudflare, Google, Quad9, OpenDNS —
+  als één plat ligt, probeert hij een andere.
+- **Wacht uren als het moet.** Eén parameter (`wait`) in seconden; tot 12 uur
+  of langer, zonder het netwerk te belasten.
+- **Logt via `arin_log`.** Netwerkproblemen komen in je bestaande logbestand,
+  niet in een apart spoor dat je later moet samenvoegen.
+- **Werkt voor twee vragen.** "Is er internet?" én "Is déze host bereikbaar?"
+
+## Installatie
+
+    pip install ww-net
+
+`arin_log` wordt automatisch mee geïnstalleerd als dependency.
+
+## Gebruik
+
+    from ww_net import is_net, is_host
+
+    # Controleer of er internet is (wacht tot 12 uur)
+    if is_net(wait=43200):
+        print("Internet is beschikbaar")
+
+    # Controleer of een specifieke host bereikbaar is
+    if is_host("https://www.google.com/", wait=43200):
+        print("Host is bereikbaar")
+
+## Wachten
+
+De `wait`-parameter is de tijd (in seconden) waarna `py_net` opgeeft.
+De standaardwaarde is `3600` (1 uur). Omdat het in seconden gaat, kun je
+gemakkelijk langere periodes instellen:
+
+| Duur | Seconden |
+|------|----------|
+| 1 uur | 3600 |
+| 4 uur | 14400 |
+| 8 uur | 28800 |
+| 12 uur | 43200 |
+
+Tijdens het wachten loopt het interval op van 1 seconde tot 15 seconden.
+Zo wordt het netwerk niet onnodig belast, maar blijft `py_net` wel alert.
+
+## API
+
+| Functie | Beschrijving |
+|---------|--------------|
+| `is_net(wait=None, logloc=None)` | Controleert of er internet is. Wacht tot `wait` seconden. |
+| `is_host(host, wait=None, logloc=None)` | Controleert of `host` bereikbaar is. Wacht tot `wait` seconden. |
+
+Beide functies retourneren `True` of `False`.
+
+## Logging
+
+`py_net` logt via `arin_log`. De `logloc`-parameter wordt doorgegeven aan
+`arin_log`, zodat je de logberichten in het juiste logbestand kunt plaatsen.
+
+## Licentie
+
+MIT — zie [LICENSE](LICENSE).

ww_net-0.1.0/ww_net.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+ww_net/__init__.py
+ww_net/net.py
+ww_net.egg-info/PKG-INFO
+ww_net.egg-info/SOURCES.txt
+ww_net.egg-info/dependency_links.txt
+ww_net.egg-info/requires.txt
+ww_net.egg-info/top_level.txt

ww_net-0.1.0/ww_net.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ww_net-0.1.0/ww_net.egg-info/requires.txt

@@ -0,0 +1 @@
+arin-log>=0.2.0

ww_net-0.1.0/ww_net.egg-info/top_level.txt

@@ -0,0 +1 @@
+ww_net