SnakeScan 1.7.5__tar.gz → 1.7.7__tar.gz

snakescan-1.7.7/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: SnakeScan
+Version: 1.7.7
+Summary: IPv4 address scanner for collecting address information.Scan or get the IPv4 address from the IPv6 host
+Author: Den*Ram
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: art
+Requires-Dist: tqdm
+Requires-Dist: termcolor
+
+<!--
+
+This documentation was created with the assistance of the GeekBot language model and Den*Ram
+
+-->
+
+# 🐍 SnakeScan: A Robust Python Port Scanner
+
+A versatile and efficient Python library designed for comprehensive network port scanning.
+
+[![PyPI](https://img.shields.io/pypi/v/SnakeScan?color=blue&label=PyPI)](https://pypi.org/project/SnakeScan/)
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green)](https://opensource.org/licenses/MIT)
+
+[![Python 3.7+](https://img.shields.io/badge/Python-3.7+-brightgreen)](https://www.python.org/)
+
+[![Status: Beta](https://img.shields.io/badge/Status-Beta-yellow)](https://img.shields.io/badge/Status-Beta-yellow)
+
+**SnakeScan** provides a flexible and powerful solution for network administrators, security professionals, and developers requiring reliable port scanning capabilities. From basic port verification to advanced, multi-threaded subnet analysis, SnakeScan delivers the tools necessary for effective network assessment.
+
+## ⚙️ Key Features:
+
+*   **Flexible Port Specification:** Define target ports as single values, ranges, or through pre-configured sets.
+
+*   **Multi-Threaded Architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
+
+*   **IP Information Retrieval:** Obtain detailed information about target IP addresses, supporting both IPv4 and IPv6.
+
+*   **Real-time Port Monitoring:** Utilize the `Watcher` class for continuous monitoring of critical port statuses.
+
+*   **Concise Command-Line Interface & API:** Integrate SnakeScan seamlessly into workflows via CLI or programmatic access.
+
+*   **UDP Port Scanning:** Native support for scanning UDP ports.
+
+## ⬇️ Installation:
+
+Install SnakeScan using pip:
+
+bash
+
+pip install SnakeScan
+
+## ⌨️ Command Line Usage:
+
+### 💡 Attribute Reference:
+
+*   **-p**: Specify target ports for scanning (single port or range). Note: Range specifications exclude the lower bound on the first entry. Example: To scan from port 80 to 443, define the range as `79-443`. Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+
+*   **-u**: Enable UDP port scanning. Example: `snake -p 53 -u`
+
+*   **-h**: Display the complete list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
+
+*   **-sp**: Initiate a scan using a predefined set of common ports with `ProcessPoolExecutor`. Example: `snake -sp`
+
+*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
+
+*   **-gs**: Retrieve the SSL/TLS certificate from a specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
+
+*   **-t**: Enable multi-threading for enhanced scan performance. Example: `snake -t`
+
+*   **-ch**: Scan a subnet to discover active IP addresses on the network. Example: `snake -ch`
+
+*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
+
+*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
+
+## 💻 Python Code Integration:
+
+### ⏱️  Watcher Class: Real-Time Port Status
+
+The `Watcher` class facilitates continuous monitoring of a specified port.
+
+python
+
+from SnakeScan import Watcher
+
+watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
+
+watcher.start()  # Begin monitoring!
+
+#### `Watcher` Methods:
+
+*   `Watcher.start()` - Initiate the port monitoring process.
+
+*   `Watcher.stop()` - Terminate the port monitoring process.
+
+---
+
+**Latest Update:** 1.7.6 (Introduced UDP port scanning)

snakescan-1.7.7/README.md

@@ -0,0 +1,89 @@
+<!--
+
+This documentation was created with the assistance of the GeekBot language model and Den*Ram
+
+-->
+
+# 🐍 SnakeScan: A Robust Python Port Scanner
+
+A versatile and efficient Python library designed for comprehensive network port scanning.
+
+[![PyPI](https://img.shields.io/pypi/v/SnakeScan?color=blue&label=PyPI)](https://pypi.org/project/SnakeScan/)
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green)](https://opensource.org/licenses/MIT)
+
+[![Python 3.7+](https://img.shields.io/badge/Python-3.7+-brightgreen)](https://www.python.org/)
+
+[![Status: Beta](https://img.shields.io/badge/Status-Beta-yellow)](https://img.shields.io/badge/Status-Beta-yellow)
+
+**SnakeScan** provides a flexible and powerful solution for network administrators, security professionals, and developers requiring reliable port scanning capabilities. From basic port verification to advanced, multi-threaded subnet analysis, SnakeScan delivers the tools necessary for effective network assessment.
+
+## ⚙️ Key Features:
+
+*   **Flexible Port Specification:** Define target ports as single values, ranges, or through pre-configured sets.
+
+*   **Multi-Threaded Architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
+
+*   **IP Information Retrieval:** Obtain detailed information about target IP addresses, supporting both IPv4 and IPv6.
+
+*   **Real-time Port Monitoring:** Utilize the `Watcher` class for continuous monitoring of critical port statuses.
+
+*   **Concise Command-Line Interface & API:** Integrate SnakeScan seamlessly into workflows via CLI or programmatic access.
+
+*   **UDP Port Scanning:** Native support for scanning UDP ports.
+
+## ⬇️ Installation:
+
+Install SnakeScan using pip:
+
+bash
+
+pip install SnakeScan
+
+## ⌨️ Command Line Usage:
+
+### 💡 Attribute Reference:
+
+*   **-p**: Specify target ports for scanning (single port or range). Note: Range specifications exclude the lower bound on the first entry. Example: To scan from port 80 to 443, define the range as `79-443`. Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+
+*   **-u**: Enable UDP port scanning. Example: `snake -p 53 -u`
+
+*   **-h**: Display the complete list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
+
+*   **-sp**: Initiate a scan using a predefined set of common ports with `ProcessPoolExecutor`. Example: `snake -sp`
+
+*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
+
+*   **-gs**: Retrieve the SSL/TLS certificate from a specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
+
+*   **-t**: Enable multi-threading for enhanced scan performance. Example: `snake -t`
+
+*   **-ch**: Scan a subnet to discover active IP addresses on the network. Example: `snake -ch`
+
+*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
+
+*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
+
+## 💻 Python Code Integration:
+
+### ⏱️  Watcher Class: Real-Time Port Status
+
+The `Watcher` class facilitates continuous monitoring of a specified port.
+
+python
+
+from SnakeScan import Watcher
+
+watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
+
+watcher.start()  # Begin monitoring!
+
+#### `Watcher` Methods:
+
+*   `Watcher.start()` - Initiate the port monitoring process.
+
+*   `Watcher.stop()` - Terminate the port monitoring process.
+
+---
+
+**Latest Update:** 1.7.6 (Introduced UDP port scanning)

{snakescan-1.7.5 → snakescan-1.7.7}/SnakeScan/CLI.py

@@ -11,6 +11,7 @@ from tqdm import tqdm
 from SnakeScan.Check_subnet import Check_network
 from SnakeScan.PoolExecutor import PoolProcessExecutor
 from SnakeScan.Get_ssl import Get_ssl
+from SnakeScan.Pool_UDP_Executor import PoolExecutorUDP
 
 
 def main():
@@ -23,96 +24,57 @@ OpenPorts = []
 threads = []
 portsopen = 0
 portsclosed = 0
-Bool = True
-boolsd = True
-boolean = 0
 ports = {
     20: "FTP-Data",
     21: "FTP-Control",
     22: "SSH",
     23: "Telnet",
-    24: "Priv-mail",
     25: "SMTP",
-    29: "MSG-ICP",
-    31: "MSG-AUTH",
-    33: "DSP",
-    35: "Priv-print",
-    41: "Graphics",
-    42: "WINS",
     43: "Whois",
-    48: "AUDITD",
-    57: "Priv-term",
-    59: "Priv-file",
-    63: "WHOISPP",
-    66: "SQL-NET",
-    75: "Priv-dial",
+    53: "DNS",
+    70: "Gopher",
+    79: "FINGER",
     80: "HTTP",
-    109: "POP2",
     110: "POP3",
+    111: "RPC",
     113: "ident",
     115: "SFTP",
-    118: "SQLServ",
-    119: "NNTP",
+    135: "MSRPC",
     139: "NetBIOS-SSN",
     143: "IMAP",
     179: "BGP",
     194: "IRC",
-    199: "SMUX",
-    200: "SRC",
-    220: "IMAP3",
-    311: "ASIP-WEBADMIN",
-    344: "PDAP",
-    345: "PAWSERV",
-    346: "ZSERV",
-    347: "FATSERV",
-    401: "UPS",
-    413: "SMSP",
-    427: "SVRLOC",
+    389: "LDAP",
     443: "HTTPS",
-    444: "SNPP",
-    606: "URM",
-    607: "NQS",
+    445: "SMB",
+    465: "SMTPS",
+    587: "SMTP Submission",
     631: "IPP",
     636: "LDAPS",
-    639: "MSDP",
-    646: "LDP",
-    647: "DHCP-FAILOVER",
-    648: "RRP",
-    753: "RRH",
-    830: "NETCONF-SSH",
-    831: "NETCONF-BEEP",
-    832: "NETCONFSOAPHTTP",
-    833: "NETCONFSOAPBEEP",
-    861: "OWAMP-CONTROL",
-    862: "TWAPM-CONTROL",
     873: "RSYNC",
-    989: "FTPS-DATA",
-    990: "FTPS",
+    993: "IMAPS",
     995: "POP3S",
-    1038: "MTQP",
     1080: "SOCKS",
-    1194: "OpenVPN",
-    1433: "SQL server",
-    1723: "PPTP",
+    1433: "SQL Server",
+    1521: "Oracle",
+    2082: "CPanel",
+    2083: "CPanel",
     2222: "SSH",
-    3128: "HTTP",
-    3268: "LDAP",
+    3128: "HTTP Proxy",
     3306: "MySQL",
     3389: "RDP",
-    3455: "RSVP",
-    3632: "Distributed compiler",
-    3689: "DAAP",
     5432: "PostgreSQL",
     5900: "VNC",
-    8000: "HTTP",
-    8080: "HTTP",
-    8443: "HTTPS",
-    8888: "HTTP",
+    8000: "HTTP Alternate",
+    8080: "HTTP Alternate",
+    8443: "HTTPS Alternate",
+    8888: "HTTP Alternate",
     10000: "Webmin",
+    27017: "MongoDB",
 }
 
 
-version = "1.7.5"
+version = "1.7.7"
 
 
 def is_port_open(host, port):
@@ -133,11 +95,15 @@ def is_port_open_threads(host, port):
             s.connect((host, port))
         except (OSError, socket.timeout):
             try:
-                print(f"Closed{colored('|X|','red')}-->{ports.get(port)}|{port}|")
-            except:
-                print(f"Closed{colored('|X|','red')}-->|{port}|")
+                print(
+                    f"Closed{colored('|X|','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')}"
+                )
+            except Exception as e:
+                print(f"Closed{colored('|X|','red')}-->{colored(f'|{port}|','red')}")
         else:
-            print(f"Open{colored('|√|','green')}-->{ports.get(port)}|{port}|")
+            print(
+                f"Open{colored('|√|','green')}-->{colored(ports.get(port),'light_green')}{colored(f'|{port}|','green')}"
+            )
 
 
 def Ports(str=""):
@@ -172,6 +138,9 @@ def SnakeArgs():
         description="SnakeScan - It's a command line library for scan and get information about ip."
     )
     parser.add_argument("host", nargs="?", default="None")
+    parser.add_argument(
+        "-u", "--udp", action="store_true", help="Use UDP ports for scanning"
+    )
     parser.add_argument(
         "-gs", "--getssl", action="store_true", help="Get official ssl certificate"
     )
@@ -225,24 +194,178 @@ for n in range(len(host)):
                 host[n] = host[n][0:i]
 if host[0] == "None":
     host[0] = "localhost"
+if SnakeArgs().udp:
+
+    def is_port_open(host, port, timeout=1):
+        try:
+            sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+            sock.settimeout(timeout)
+            message = b"Test UDP packet"
+            address = (host, port)
+
+            sock.sendto(message, address)
+
+            try:
+                data, server = sock.recvfrom(4096)
+                print(f"Response received: {data.decode()} from {server}")
+                is_open = True
+            except socket.timeout:
+                is_open = False
+            except ConnectionRefusedError:
+                is_open = False
+
+            sock.close()
+            return is_open
+
+        except socket.gaierror:
+            print("Error: Unable to resolve host name.")
+            return None
+        except socket.error as e:
+            print(f"Socket error: {e}")
+            return False
+
+    def is_port_open_threads(host, port, timeout=1):
+        try:
+            sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+            sock.settimeout(timeout)
+            message = b"Test UDP packet"
+            address = (host, port)
+
+            sock.sendto(message, address)
+
+            try:
+                data, server = sock.recvfrom(4096)
+                print(f"Response received: {data.decode()} from {server}")
+                print(
+                    f"Open{colored('[√]','green')}-->{colored(ports.get(port),'light_green')}{colored(f'|{port}|','green')} may be listening on host"
+                )
+            except socket.timeout:
+                print(
+                    f"Closed{colored('[X]','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')} is likely closed on host"
+                )
+            except ConnectionRefusedError:
+                print("An error occurred while scanning.")
+            sock.close()
+        except socket.gaierror:
+            print("Error: Unable to resolve host name.")
+        except socket.error as e:
+            print(f"Socket error: {e}")
+
+    ports = {
+        7: "ECHO",
+        9: "DISCARD",
+        13: "DAYTIME",
+        17: "QOTD (Quote of the Day)",
+        19: "CHARGEN (Character Generator)",
+        53: "DNS (Domain Name System)",
+        67: "DHCP Server",
+        68: "DHCP Client",
+        69: "TFTP (Trivial File Transfer Protocol)",
+        111: "RPC (Remote Procedure Call)",
+        123: "NTP (Network Time Protocol)",
+        137: "NetBIOS Name Service",
+        138: "NetBIOS Datagram Service",
+        161: "SNMP (Simple Network Management Protocol)",
+        162: "SNMP Trap",
+        443: "QUIC (Quick UDP Internet Connections)",
+        500: "ISAKMP (Internet Security Association and Key Management Protocol)",
+        520: "RIP (Routing Information Protocol)",
+        1434: "Microsoft SQL Server Dynamic Port Allocation",
+        4500: "IPsec NAT-Traversal (NAT-T)",
+        5353: "mDNS (Multicast DNS)",
+        5355: "LLMNR (Link-Local Multicast Name Resolution)",
+        1900: "SSDP (Simple Service Discovery Protocol)",
+        3478: "STUN (Session Traversal Utilities for NAT)",
+        5060: "SIP (Session Initiation Protocol)",
+        5061: "SIP (Session Initiation Protocol) (TLS)",
+        20777: "Garmin Training Center",
+        3074: "Xbox Live",
+        3479: "TURN (Traversal Using Relays around NAT)",
+        4126: "Muon",
+        50000: "Drone (Drone Protocol)",
+        60000: "RDP (Remote Desktop Protocol) over UDP",
+        5000: "fCoE (Fibre Channel over Ethernet)",
+        5001: "HP OpenView Operations Agent",
+        1719: "H.323 Gatekeeper RAS",
+        1720: "H.323 Call Signaling",
+        1812: "RADIUS authentication",
+        1813: "RADIUS accounting",
+        5222: "XMPP client connection",
+        5269: "XMPP server connection",
+    }
+
+else:
+    ports = {
+        20: "FTP-Data",
+        21: "FTP-Control",
+        22: "SSH",
+        23: "Telnet",
+        25: "SMTP",
+        43: "Whois",
+        53: "DNS",
+        70: "Gopher",
+        79: "FINGER",
+        80: "HTTP",
+        110: "POP3",
+        111: "RPC",
+        113: "ident",
+        115: "SFTP",
+        135: "MSRPC",
+        139: "NetBIOS-SSN",
+        143: "IMAP",
+        179: "BGP",
+        194: "IRC",
+        389: "LDAP",
+        443: "HTTPS",
+        445: "SMB",
+        465: "SMTPS",
+        587: "SMTP Submission",
+        631: "IPP",
+        636: "LDAPS",
+        873: "RSYNC",
+        993: "IMAPS",
+        995: "POP3S",
+        1080: "SOCKS",
+        1433: "SQL Server",
+        1521: "Oracle",
+        2082: "CPanel",
+        2083: "CPanel",
+        2222: "SSH",
+        3128: "HTTP Proxy",
+        3306: "MySQL",
+        3389: "RDP",
+        5432: "PostgreSQL",
+        5900: "VNC",
+        8000: "HTTP Alternate",
+        8080: "HTTP Alternate",
+        8443: "HTTPS Alternate",
+        8888: "HTTP Alternate",
+        10000: "Webmin",
+        27017: "MongoDB",
+    }
+
 if SnakeArgs().ports:
     rangeports, port_user = Ports(port_user)
     for i in range(len(port_user)):
-        port_user[i] = int(port_user[i])
+        try:
+            port_user[i] = int(port_user[i])
+        except Exception as e:
+            print(f"Incorrect input,please check the help documentation:{e}")
+            sys.exit()
     for n in range(len(host)):
         for port in range(len(port_user)):
             if is_port_open(host[n], port_user[port]):
                 print(
-                    f"Open{colored('|√|','green')}{host[n]}-->{ports[port_user[port]]}|{port_user[port]}|"
+                    f"Open{colored('|√|','green')}{host[n]}-->{colored(f'{str(ports.get(port_user[port],''))}','light_green')}{colored(f'|{port_user[port]}|','green')}"
                 )
             else:
                 try:
                     print(
-                        f"Closed{colored('|X|','red')}{host[n]}-->{ports[port_user[port]]}|{port_user[port]}|"
+                        f"Closed{colored('|X|','red')}{host[n]}-->{colored(str(ports.get(port_user[port],'')),'light_red')}{colored(f'|{port_user[port]}|','red')}"
                     )
                 except:
                     print(
-                        f"Closed{colored('|X|','red')}{host[n]}-->|{port_user[port]}|"
+                        f"Closed{colored('|X|','red')}{host[n]}-->{colored(f'|{port_user[port]}|','red')}"
                     )
         try:
             first = rangeports[::2]
@@ -390,6 +513,11 @@ if SnakeArgs().thread:
 if SnakeArgs().version:
     print(f"SnakeScan_Build_{version}")
 if SnakeArgs().speed:
+    if SnakeArgs().udp:
+        for n in range(len(host)):
+            print(f"{host[n]}".center(60, "—"))
+            PoolExecutorUDP(host[n])
+        sys.exit()
     for n in range(len(host)):
         print(f"{host[n]}".center(60, "—"))
         PoolProcessExecutor(host[n])

snakescan-1.7.7/SnakeScan/PoolExecutor.py

@@ -0,0 +1,80 @@
+import socket
+from termcolor import colored
+from concurrent.futures import ProcessPoolExecutor
+
+ports = {
+    20: "FTP-Data",
+    21: "FTP-Control",
+    22: "SSH",
+    23: "Telnet",
+    25: "SMTP",
+    43: "Whois",
+    53: "DNS",
+    70: "Gopher",
+    79: "FINGER",
+    80: "HTTP",
+    110: "POP3",
+    111: "RPC",
+    113: "ident",
+    115: "SFTP",
+    135: "MSRPC",
+    139: "NetBIOS-SSN",
+    143: "IMAP",
+    179: "BGP",
+    194: "IRC",
+    389: "LDAP",
+    443: "HTTPS",
+    445: "SMB",
+    465: "SMTPS",
+    587: "SMTP Submission",
+    631: "IPP",
+    636: "LDAPS",
+    873: "RSYNC",
+    993: "IMAPS",
+    995: "POP3S",
+    1080: "SOCKS",
+    1433: "SQL Server",
+    1521: "Oracle",
+    2082: "CPanel",
+    2083: "CPanel",
+    2222: "SSH",
+    3128: "HTTP Proxy",
+    3306: "MySQL",
+    3389: "RDP",
+    5432: "PostgreSQL",
+    5900: "VNC",
+    8000: "HTTP Alternate",
+    8080: "HTTP Alternate",
+    8443: "HTTPS Alternate",
+    8888: "HTTP Alternate",
+    10000: "Webmin",
+    27017: "MongoDB",
+}
+
+
+def is_port_open_threads(host, port):
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        try:
+            s.settimeout(1)
+            s.connect((host, port))
+        except (OSError, socket.timeout):
+            try:
+                print(
+                    f"Closed{colored('|X|','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')}"
+                )
+            except:
+                print(f"Closed{colored('|X|','red')}-->{colored(f'|{port}|','red')}")
+        else:
+            print(
+                f"Open{colored('|√|','green')}-->{colored(ports.get(port),'light_green')}{colored(f'|{port}|','green')}"
+            )
+
+
+def PoolProcessExecutor(host):
+    with ProcessPoolExecutor(max_workers=None) as executor:
+        try:
+            for port in ports.keys():
+                future = executor.submit(is_port_open_threads, host, port)
+
+        except Exception as e:
+            print(e)

snakescan-1.7.7/SnakeScan/Pool_UDP_Executor.py

@@ -0,0 +1,84 @@
+import socket
+from termcolor import colored
+from concurrent.futures import ProcessPoolExecutor
+
+ports = {
+    7: "ECHO",
+    9: "DISCARD",
+    13: "DAYTIME",
+    17: "QOTD (Quote of the Day)",
+    19: "CHARGEN (Character Generator)",
+    53: "DNS (Domain Name System)",
+    67: "DHCP Server",
+    68: "DHCP Client",
+    69: "TFTP (Trivial File Transfer Protocol)",
+    111: "RPC (Remote Procedure Call)",
+    123: "NTP (Network Time Protocol)",
+    137: "NetBIOS Name Service",
+    138: "NetBIOS Datagram Service",
+    161: "SNMP (Simple Network Management Protocol)",
+    162: "SNMP Trap",
+    443: "QUIC (Quick UDP Internet Connections)",
+    500: "ISAKMP (Internet Security Association and Key Management Protocol)",
+    520: "RIP (Routing Information Protocol)",
+    1434: "Microsoft SQL Server Dynamic Port Allocation",
+    4500: "IPsec NAT-Traversal (NAT-T)",
+    5353: "mDNS (Multicast DNS)",
+    5355: "LLMNR (Link-Local Multicast Name Resolution)",
+    1900: "SSDP (Simple Service Discovery Protocol)",
+    3478: "STUN (Session Traversal Utilities for NAT)",
+    5060: "SIP (Session Initiation Protocol)",
+    5061: "SIP (Session Initiation Protocol) (TLS)",
+    20777: "Garmin Training Center",
+    3074: "Xbox Live",
+    3479: "TURN (Traversal Using Relays around NAT)",
+    4126: "Muon",
+    50000: "Drone (Drone Protocol)",
+    60000: "RDP (Remote Desktop Protocol) over UDP",
+    5000: "fCoE (Fibre Channel over Ethernet)",
+    5001: "HP OpenView Operations Agent",
+    1719: "H.323 Gatekeeper RAS",
+    1720: "H.323 Call Signaling",
+    1812: "RADIUS authentication",
+    1813: "RADIUS accounting",
+    5222: "XMPP client connection",
+    5269: "XMPP server connection",
+}
+
+
+def is_port_open_threads(host, port, timeout=1):
+    try:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        sock.settimeout(timeout)
+        message = b"Test UDP packet"
+        address = (host, port)
+
+        sock.sendto(message, address)
+
+        try:
+            data, server = sock.recvfrom(4096)
+            print(f"Response received: {data.decode()} from {server}")
+            print(
+                f"Open{colored('[√]','green')}-->{colored(ports.get(port),'light_green')}{colored(f'|{port}|','green')} may be listening on host"
+            )
+        except socket.timeout:
+            print(
+                f"Closed{colored('[X]','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')} is likely closed on host"
+            )
+        except ConnectionRefusedError:
+            print("An error occurred while scanning.")
+        sock.close()
+    except socket.gaierror:
+        print("Error: Unable to resolve host name.")
+    except socket.error as e:
+        print(f"Socket error: {e}")
+
+
+def PoolExecutorUDP(host):
+    with ProcessPoolExecutor(max_workers=None) as executor:
+        try:
+            for port in ports.keys():
+                future = executor.submit(is_port_open_threads, host, port)
+
+        except Exception as e:
+            print(e)

{snakescan-1.7.5 → snakescan-1.7.7}/SnakeScan/__init__.py

@@ -1,6 +1,6 @@
 """IPv4 address scanner for collecting address information.Scan or get the IPv4 address from the IPv6 host"""
 
-__version__ = "1.7.5"
+__version__ = "1.7.7"
 import socket
 from time import sleep
 from termcolor import colored

snakescan-1.7.5/PKG-INFO

@@ -1,102 +0,0 @@
-Metadata-Version: 2.4
-Name: SnakeScan
-Version: 1.7.5
-Summary: IPv4 address scanner for collecting address information.Scan or get the IPv4 address from the IPv6 host
-Author: Den*Ram
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-Expression: MIT
-License-File: LICENSE
-Requires-Dist: art
-Requires-Dist: tqdm
-Requires-Dist: termcolor
-
-<!--
-
-This documentation was created with the assistance of the GeekBot language model and Den*Ram
-
--->
-
-# 🐍 SnakeScan: Your Go-To Python Port Scanner
-
-✨ A powerful and flexible Python library for all your port scanning needs. ✨
-
-[![PyPI](https://img.shields.io/pypi/v/SnakeScan?color=blue&label=PyPI)](https://pypi.org/project/SnakeScan/)
-
-[![MIT License](https://img.shields.io/badge/License-MIT-green)](https://opensource.org/licenses/MIT)
-
-[![Python 3.7+](https://img.shields.io/badge/Python-3.7+-brightgreen)](https://www.python.org/)
-
-[![Status: Beta](https://img.shields.io/badge/Status-Beta-yellow)](https://github.com/yourusername/SnakeScan/releases)  <!-- Replace yourusername with yours -->
-
-[![Platforms](https://img.shields.io/badge/Platforms-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)](https://www.python.org/)
-
-**SnakeScan** is designed to be both easy to use and incredibly versatile. Whether you're performing basic single port checks or diving into advanced subnet scans and real-time monitoring, SnakeScan has you covered.
-
-## 🌟 Key Features:
-
-*   **Unmatched Flexibility:** Scan single ports, defined ranges, or pre-configured sets with ease.
-
-*   **Blazing Fast Multithreading:** Leverage multithreading for significantly faster scanning speeds.
-
-*   **Get the Details:** Retrieve valuable information about IP addresses (supports both IPv4 and IPv6).
-
-*   **Real-time Monitoring with Watcher:** Keep a constant eye on critical ports and their statuses.
-
-*   **Intuitive Design:** Clean and simple command-line parameters and API for effortless use.
-
-## ⬇️ Installation:
-
-Get started with SnakeScan in seconds!
-
-bash
-
-pip install SnakeScan
-
-## ⚙️ Command Line Usage: Unleash the Power!
-
-### 💡 Mastering Attribute Usage:
-
-*   **-p**: Specify ports to scan (single or ranges).  **Important:** When specifying ranges, the beginning of the range is only included from the second time.  For example, to scan from 80 to 443, use `79-443`.  Examples: `snake -p 80,443`  or `snake -p 80,3437,8080,20-30,79-443`
-
-*   **-h**:  Display a complete list of available attributes and their descriptions. Example: `snake -h` or `snake -help`
-
-*   **-sp**: Use a predefined set of common ports for scanning with `ProcessPoolExecutor`.  Example: `snake -sp`
-
-*   **-v**: Show the current version of the SnakeScan library. Example: `snake -v`
-
-*   **-gs**:  Retrieve the SSL/TLS certificate from a specified website.  Example: `snake www.google.com -gs` (Without specifying a host, you’ll encounter a connection error).
-
-*   **-t**: Enable multithreading to speed up your port scans. Example: `snake -t`
-
-*   **-ch**: Scan a subnet to discover other IP addresses on the network. Example: `snake -ch`
-
-*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
-
-*   **-i**:  Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
-
-## 💻 Python Code Integration:
-
-### ⏱️  Watcher: The Real-Time Port Sentinel!
-
-`Watcher` allows you to continuously monitor the status of a designated port.
-
-python
-
-from SnakeScan import Watcher
-
-watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
-
-watcher.start()  # Begin monitoring!
-
-#### `Watcher` Command Set:
-
-*   `Watcher.start()` - Starts the port monitoring process.
-
-*   `Watcher.stop()` - Halts the port monitoring process.
-
----
-
-**Latest Update:** 1.7.5 (Enhanced port designations for even clearer understanding)
-
-

snakescan-1.7.5/README.md

@@ -1,88 +0,0 @@
-<!--
-
-This documentation was created with the assistance of the GeekBot language model and Den*Ram
-
--->
-
-# 🐍 SnakeScan: Your Go-To Python Port Scanner
-
-✨ A powerful and flexible Python library for all your port scanning needs. ✨
-
-[![PyPI](https://img.shields.io/pypi/v/SnakeScan?color=blue&label=PyPI)](https://pypi.org/project/SnakeScan/)
-
-[![MIT License](https://img.shields.io/badge/License-MIT-green)](https://opensource.org/licenses/MIT)
-
-[![Python 3.7+](https://img.shields.io/badge/Python-3.7+-brightgreen)](https://www.python.org/)
-
-[![Status: Beta](https://img.shields.io/badge/Status-Beta-yellow)](https://github.com/yourusername/SnakeScan/releases)  <!-- Replace yourusername with yours -->
-
-[![Platforms](https://img.shields.io/badge/Platforms-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)](https://www.python.org/)
-
-**SnakeScan** is designed to be both easy to use and incredibly versatile. Whether you're performing basic single port checks or diving into advanced subnet scans and real-time monitoring, SnakeScan has you covered.
-
-## 🌟 Key Features:
-
-*   **Unmatched Flexibility:** Scan single ports, defined ranges, or pre-configured sets with ease.
-
-*   **Blazing Fast Multithreading:** Leverage multithreading for significantly faster scanning speeds.
-
-*   **Get the Details:** Retrieve valuable information about IP addresses (supports both IPv4 and IPv6).
-
-*   **Real-time Monitoring with Watcher:** Keep a constant eye on critical ports and their statuses.
-
-*   **Intuitive Design:** Clean and simple command-line parameters and API for effortless use.
-
-## ⬇️ Installation:
-
-Get started with SnakeScan in seconds!
-
-bash
-
-pip install SnakeScan
-
-## ⚙️ Command Line Usage: Unleash the Power!
-
-### 💡 Mastering Attribute Usage:
-
-*   **-p**: Specify ports to scan (single or ranges).  **Important:** When specifying ranges, the beginning of the range is only included from the second time.  For example, to scan from 80 to 443, use `79-443`.  Examples: `snake -p 80,443`  or `snake -p 80,3437,8080,20-30,79-443`
-
-*   **-h**:  Display a complete list of available attributes and their descriptions. Example: `snake -h` or `snake -help`
-
-*   **-sp**: Use a predefined set of common ports for scanning with `ProcessPoolExecutor`.  Example: `snake -sp`
-
-*   **-v**: Show the current version of the SnakeScan library. Example: `snake -v`
-
-*   **-gs**:  Retrieve the SSL/TLS certificate from a specified website.  Example: `snake www.google.com -gs` (Without specifying a host, you’ll encounter a connection error).
-
-*   **-t**: Enable multithreading to speed up your port scans. Example: `snake -t`
-
-*   **-ch**: Scan a subnet to discover other IP addresses on the network. Example: `snake -ch`
-
-*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
-
-*   **-i**:  Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
-
-## 💻 Python Code Integration:
-
-### ⏱️  Watcher: The Real-Time Port Sentinel!
-
-`Watcher` allows you to continuously monitor the status of a designated port.
-
-python
-
-from SnakeScan import Watcher
-
-watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
-
-watcher.start()  # Begin monitoring!
-
-#### `Watcher` Command Set:
-
-*   `Watcher.start()` - Starts the port monitoring process.
-
-*   `Watcher.stop()` - Halts the port monitoring process.
-
----
-
-**Latest Update:** 1.7.5 (Enhanced port designations for even clearer understanding)
-

snakescan-1.7.5/SnakeScan/PoolExecutor.py

@@ -1,112 +0,0 @@
-import socket
-from termcolor import colored
-from concurrent.futures import ProcessPoolExecutor
-
-ports = {
-    20: "FTP-Data",
-    21: "FTP-Control",
-    22: "SSH",
-    23: "Telnet",
-    24: "Priv-mail",
-    25: "SMTP",
-    29: "MSG-ICP",
-    31: "MSG-AUTH",
-    33: "DSP",
-    35: "Priv-print",
-    41: "Graphics",
-    42: "WINS",
-    43: "Whois",
-    48: "AUDITD",
-    57: "Priv-term",
-    59: "Priv-file",
-    63: "WHOISPP",
-    66: "SQL-NET",
-    75: "Priv-dial",
-    80: "HTTP",
-    109: "POP2",
-    110: "POP3",
-    113: "ident",
-    115: "SFTP",
-    118: "SQLServ",
-    119: "NNTP",
-    139: "NetBIOS-SSN",
-    143: "IMAP",
-    179: "BGP",
-    194: "IRC",
-    199: "SMUX",
-    200: "SRC",
-    220: "IMAP3",
-    311: "ASIP-WEBADMIN",
-    344: "PDAP",
-    345: "PAWSERV",
-    346: "ZSERV",
-    347: "FATSERV",
-    401: "UPS",
-    413: "SMSP",
-    427: "SVRLOC",
-    443: "HTTPS",
-    444: "SNPP",
-    606: "URM",
-    607: "NQS",
-    631: "IPP",
-    636: "LDAPS",
-    639: "MSDP",
-    646: "LDP",
-    647: "DHCP-FAILOVER",
-    648: "RRP",
-    753: "RRH",
-    830: "NETCONF-SSH",
-    831: "NETCONF-BEEP",
-    832: "NETCONFSOAPHTTP",
-    833: "NETCONFSOAPBEEP",
-    861: "OWAMP-CONTROL",
-    862: "TWAPM-CONTROL",
-    873: "RSYNC",
-    989: "FTPS-DATA",
-    990: "FTPS",
-    995: "POP3S",
-    1038: "MTQP",
-    1080: "SOCKS",
-    1194: "OpenVPN",
-    1433: "SQL server",
-    1723: "PPTP",
-    2222: "SSH",
-    3128: "HTTP",
-    3268: "LDAP",
-    3306: "MySQL",
-    3389: "RDP",
-    3455: "RSVP",
-    3632: "Distributed compiler",
-    3689: "DAAP",
-    5432: "PostgreSQL",
-    5900: "VNC",
-    8000: "HTTP",
-    8080: "HTTP",
-    8443: "HTTPS",
-    8888: "HTTP",
-    10000: "Webmin",
-}
-
-
-def is_port_open_threads(host, port):
-    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-        try:
-            s.settimeout(1)
-            s.connect((host, port))
-        except (OSError, socket.timeout):
-            try:
-                print(f"Closed{colored('|X|','red')}-->{ports.get(port)}|{port}|")
-            except:
-                print(f"Closed{colored('|X|','red')}-->|{port}|")
-        else:
-            print(f"Open{colored('|√|','green')}-->{ports.get(port)}|{port}|")
-
-
-def PoolProcessExecutor(host):
-    with ProcessPoolExecutor(max_workers=None) as executor:
-        try:
-            for port in ports.keys():
-                future = executor.submit(is_port_open_threads, host, port)
-
-        except Exception as e:
-            print(e)