vping 1.0.1__py3-none-any.whl

vping/__init__.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+
+# File: vping/__init__.py
+# Author: Hadi Cahyadi <cumulus13@gmail.com>
+# Date: 2026-10-27
+# Description: 
+# License: MIT
+
+from .core import ping
+
+__version__ = "1.0.0"
+__all__ = ["ping"]

vping/__main__.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+
+# File: vping/__main__.py
+# Author: Hadi Cahyadi <cumulus13@gmail.com>
+# Date: 2026-10-27
+# Description: 
+# License: MIT
+
+import sys
+from .core import ping
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python -m vping <hostname_or_ip>")
+        sys.exit(1)
+        
+    host = sys.argv[1]
+    print(f"Checking target: {host} ...")
+    
+    alive = ping(host)
+    if alive:
+        print(f"RESULT: {host} is ALIVE")
+        sys.exit(0)
+    else:
+        print(f"RESULT: {host} is DOWN / UNREACHABLE")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

vping/core.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+
+# File: vping/core.py
+# Author: Hadi Cahyadi <cumulus13@gmail.com>
+# Date: 2026-10-27
+# Description: 
+# License: MIT
+
+import socket
+import logging
+
+logger = logging.getLogger("vping")
+
+def _tcp_fallback(host: str, ports: list = None, timeout: float = 1.0) -> bool:
+    """Fallback method using TCP connect scans across common ports."""
+    if ports is None:
+        ports = [80, 443, 53]
+        
+    for port in ports:
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.settimeout(timeout)
+                if s.connect_ex((host, port)) == 0:
+                    return True
+        except Exception:
+            continue
+    return False
+
+
+def ping(host: str, timeout: float = 1.0, ports: list = None) -> bool:
+    """
+    Checks if a host is alive. 
+    Tries icmplib first; if missing, unprivileged, or errored, 
+    automatically falls back to robust TCP connect scanning.
+    """
+    # Attempt 1: Try using icmplib if available
+    try:
+        from icmplib import ping as icmp_ping
+        try:
+            host_info = icmp_ping(host, count=1, timeout=timeout, privileged=False)
+            if host_info.is_alive:
+                return True
+        except Exception:
+            try:
+                host_info = icmp_ping(host, count=1, timeout=timeout, privileged=True)
+                if host_info.is_alive:
+                    return True
+            except Exception:
+                pass
+    except ImportError:
+        logger.debug("icmplib not found. Using TCP fallback.")
+    except Exception:
+        pass
+
+    # Attempt 2: Bulletproof TCP fallback
+    return _tcp_fallback(host, ports=ports, timeout=timeout)
+

vping-1.0.1.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: vping
+Version: 1.0.1
+Summary: Fast, robust host alive checker with icmplib and TCP fallback
+Author-email: Hadi Cahyadi <cumulus13@gmail.com>
+Maintainer-email: cumulus13 <cumulus13@gmail.com>
+License-Expression: MIT
+Keywords: ping,network,host-checker,icmplib,tcp-scan,lan
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Operating System :: OS Independent
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: icmplib>=2.1.1; sys_platform != "win32" or python_version >= "3.8"
+
+# vping
+
+Fast and robust host alive checker for LAN and WAN networks. Tries native ICMP (`icmplib`) first and automatically falls back to high-performance TCP socket checks if ICMP fails or permissions are restricted.
+
+## Usage
+
+```python
+from vping import ping
+
+if ping("8.8.8.8"):
+    print("Host is alive!")
+
+```
+
+CLI usage:
+
+```bash
+python -m vping 8.8.8.8
+
+```
+
+## 👤 Author
+        
+[Hadi Cahyadi](mailto:cumulus13@gmail.com)
+    
+
+[![Buy Me a Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/cumulus13)
+
+[![Donate via Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/cumulus13)
+ 
+[Support me on Patreon](https://www.patreon.com/cumulus13)

vping-1.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+vping/__init__.py,sha256=O9qLcru4zBqRls-KLq9rkQ2SXZBsPJ_OV3ylGwj5li4,221
+vping/__main__.py,sha256=DEYSB_5lzNirdEBbULxJ0K7ZhwxNoxMgWYdAuBIr0p8,625
+vping/core.py,sha256=qrscSJCrR10q89fP02XZ3mwzRnY6jEzzraecp1d2Ffo,1704
+vping-1.0.1.dist-info/METADATA,sha256=2EK4bt6hSBq-J-c26048dYILmCZL6I_3r_-yrIuDzRY,1614
+vping-1.0.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+vping-1.0.1.dist-info/entry_points.txt,sha256=zwfByyVNsO33vH0gn20ysu_07mqXC75Ao8LkGJAQxs8,46
+vping-1.0.1.dist-info/top_level.txt,sha256=Ii-eMmQxPo-TPAnrzoOKno1HHJDUW8EEJ-rH8VO0jZ4,6
+vping-1.0.1.dist-info/RECORD,,

vping-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

vping-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+vping = vping.__main__:main

vping-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+vping