SnakeScan 1.8.7__tar.gz → 1.8.9__tar.gz

{snakescan-1.8.7 → snakescan-1.8.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.8.7
+Version: 1.8.9
 Summary: Unlock the potential of your network with this powerful IPv4 address scanner. Easily scan IP address ranges, identify active hosts, and even extract IPv4 addresses from IPv6 environments. Enhance your network monitoring, troubleshooting, and security analysis!
 Author: Den*Ram
 Requires-Python: >=3.7
@@ -21,11 +21,8 @@ This documentation was created with GeekBot Language Model and Den*Ram
 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: Stable](https://img.shields.io/badge/Status-Stable-green)](https://img.shields.io/badge/Status-Stable-green)
 
 **SnakeScan** provides a flexible and powerful solution for network administrators, security professionals, and developers who need reliable port scanning capabilities. From simple port checks to advanced, multi-threaded subnet analysis, SnakeScan provides the tools necessary for effective network assessment.
@@ -50,16 +47,14 @@ A versatile and efficient Python library designed for comprehensive network port
 
 ## ⬇️ Installation:
 
-**It is strongly recommended to install this specific version of SnakeScan (1.8.7) as it includes significant enhancements and bug fixes that improve reliability and operational stability. The updates are aimed at ensuring optimal performance and eliminating issues encountered in previous versions.**
-
 **Installation via pip (recommended):**
 
-            
 
 bash
 
 pip install SnakeScan
 
+
 **Alternative Installation from Source Code Archive:**
 
 SnakeScan is distributed with open source code. This means you can download the code archive, examine it, make necessary changes, and fix any errors that occur during use.
@@ -84,8 +79,6 @@ flit install
 
 *   **-h**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
 
-*   **-sp**: Initiate a scan using a predefined common port set with `ProcessPoolExecutor`. Example: `snake -sp`
-
 *   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
 
 *   **-gs**: Retrieve an SSL/TLS certificate from a specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
@@ -98,6 +91,8 @@ flit install
 
 *   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
 
+*   **-a --asynchronous**: Uses all ports from the predefined dictionary for asynchronous port scanning. Example: `snake -a`. If you want to scan all ports using your own port file, use the `-d` argument to specify the path to that file.
+
 *   **-d**: Specify the path to a JSON file containing TCP port definitions and optionally, a second JSON file containing UDP port definitions. **Note:** Upon the first use of this argument, the paths to the JSON files must be provided with each command execution and separated by a comma. After the initial use, SnakeScan can remember these paths for subsequent scans.
 
     Example: `snake -d /path/to/tcp_ports.json,/path/to/udp_ports.json` (if you want to specify both TCP and UDP, if only TCP: `snake -d /path/to/tcp_ports.json`)
@@ -109,17 +104,11 @@ flit install
     **JSON File Format:** The JSON file should be formatted as a dictionary where the keys are port numbers (as strings), and the values are the corresponding service names or descriptions.
 
     ```json
-
     {
-
         "53": "DNS",
-
         "80": "HTTP",
-
         "443": "HTTPS"
-
     }
-
     ```
 
 *   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake -dr`
@@ -150,6 +139,5 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.8.7 (Automatic Home Directory Detection, Added `-home` and `--homedir` arguments. All config files are stored outside the installed library for permanent and secure customization.)
-
+**Last Updated:** 1.8.9 (Automatic Home Directory Detection, Added `-home` and `--homedir` arguments. Added `-a` or `--asynchronous` arguments for scan allports from dictionaries. All config files are stored outside the installed library for permanent and secure customization.)
 

{snakescan-1.8.7 → snakescan-1.8.9}/README.md

@@ -8,11 +8,8 @@ This documentation was created with GeekBot Language Model and Den*Ram
 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: Stable](https://img.shields.io/badge/Status-Stable-green)](https://img.shields.io/badge/Status-Stable-green)
 
 **SnakeScan** provides a flexible and powerful solution for network administrators, security professionals, and developers who need reliable port scanning capabilities. From simple port checks to advanced, multi-threaded subnet analysis, SnakeScan provides the tools necessary for effective network assessment.
@@ -37,16 +34,14 @@ A versatile and efficient Python library designed for comprehensive network port
 
 ## ⬇️ Installation:
 
-**It is strongly recommended to install this specific version of SnakeScan (1.8.7) as it includes significant enhancements and bug fixes that improve reliability and operational stability. The updates are aimed at ensuring optimal performance and eliminating issues encountered in previous versions.**
-
 **Installation via pip (recommended):**
 
-            
 
 bash
 
 pip install SnakeScan
 
+
 **Alternative Installation from Source Code Archive:**
 
 SnakeScan is distributed with open source code. This means you can download the code archive, examine it, make necessary changes, and fix any errors that occur during use.
@@ -71,8 +66,6 @@ flit install
 
 *   **-h**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
 
-*   **-sp**: Initiate a scan using a predefined common port set with `ProcessPoolExecutor`. Example: `snake -sp`
-
 *   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
 
 *   **-gs**: Retrieve an SSL/TLS certificate from a specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
@@ -85,6 +78,8 @@ flit install
 
 *   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
 
+*   **-a --asynchronous**: Uses all ports from the predefined dictionary for asynchronous port scanning. Example: `snake -a`. If you want to scan all ports using your own port file, use the `-d` argument to specify the path to that file.
+
 *   **-d**: Specify the path to a JSON file containing TCP port definitions and optionally, a second JSON file containing UDP port definitions. **Note:** Upon the first use of this argument, the paths to the JSON files must be provided with each command execution and separated by a comma. After the initial use, SnakeScan can remember these paths for subsequent scans.
 
     Example: `snake -d /path/to/tcp_ports.json,/path/to/udp_ports.json` (if you want to specify both TCP and UDP, if only TCP: `snake -d /path/to/tcp_ports.json`)
@@ -96,17 +91,11 @@ flit install
     **JSON File Format:** The JSON file should be formatted as a dictionary where the keys are port numbers (as strings), and the values are the corresponding service names or descriptions.
 
     ```json
-
     {
-
         "53": "DNS",
-
         "80": "HTTP",
-
         "443": "HTTPS"
-
     }
-
     ```
 
 *   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake -dr`
@@ -137,5 +126,4 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.8.7 (Automatic Home Directory Detection, Added `-home` and `--homedir` arguments. All config files are stored outside the installed library for permanent and secure customization.)
-
+**Last Updated:** 1.8.9 (Automatic Home Directory Detection, Added `-home` and `--homedir` arguments. Added `-a` or `--asynchronous` arguments for scan allports from dictionaries. All config files are stored outside the installed library for permanent and secure customization.)

{snakescan-1.8.7 → snakescan-1.8.9}/SnakeScan/CLI.py

@@ -1,4 +1,5 @@
 import os
+import asyncio
 import configparser
 from pathlib import Path
 import json
@@ -8,14 +9,12 @@ import argparse
 import socket
 import ipaddress
 from art import tprint
-from concurrent.futures import ProcessPoolExecutor
 from termcolor import colored
 from threading import Thread
 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
+
 
 OpenPorts = []
 threads = []
@@ -78,6 +77,40 @@ ports = {
 }
 
 
+async def is_port_open_async(host, port):
+    try:
+        reader, writer = await asyncio.wait_for(
+            asyncio.open_connection(host, port), timeout=1
+        )
+    except (OSError, asyncio.TimeoutError):
+        try:
+            print(
+                f"Closed\033[31m|X|\033[0m-->\033[91m{ports.get(port)}\033[0m\033[31m|{port}|\033[0m"
+            )
+        except Exception:
+            print(f"Closed\033[31m|X|\033[0m-->\033[31m|{port}|\033[0m")
+    else:
+        print(
+            f"Open\033[32m|√|\033[0m-->\033[92m{ports.get(port)}\033[0m\033[32m|{port}|\033[0m"
+        )
+        writer.close()
+        await writer.wait_closed()
+
+
+async def is_port_run_threads(host, ports):
+    for n in range(len(host)):
+        try:
+            loop = asyncio.get_event_loop()
+            await loop.run_in_executor(None, socket.gethostbyname, host[n])
+            print(f"|{host[n]}|".center(60, "—"))
+            tasks = [is_port_open_async(host[n], port) for port in ports.keys()]
+            await asyncio.gather(*tasks)
+        except Exception as e:
+            print(f"|{host[n]}|".center(60, "—"))
+            print(e)
+            print("".center(60, "—"))
+
+
 def Load_config(ports):
     try:
         config = configparser.ConfigParser()
@@ -183,7 +216,7 @@ else:
 if __name__ == "__main__":
     main()
 
-version = "1.8.7"
+version = "1.8.9"
 
 
 def is_port_open(host, port):
@@ -247,6 +280,12 @@ 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(
+        "-a",
+        "--asynchrous",
+        action="store_true",
+        help="Use scan with asyncio",
+    )
     parser.add_argument(
         "-home",
         "--homedir",
@@ -278,12 +317,6 @@ def SnakeArgs():
     parser.add_argument(
         "-gs", "--getssl", action="store_true", help="Get official ssl certificate"
     )
-    parser.add_argument(
-        "-sp",
-        "--speed",
-        action="store_true",
-        help="Scan with using PoolProcessExecutor",
-    )
     parser.add_argument("-v", "--version", action="store_true", help="Library version")
     parser.add_argument(
         "-i", "--info", action="store_true", help="IP information about host"
@@ -495,7 +528,8 @@ else:
             10000: "Webmin",
             27017: "MongoDB",
         }
-
+if SnakeArgs().asynchrous:
+    asyncio.run(is_port_run_threads(host, ports))
 if SnakeArgs().dictremove:
     try:
         config = configparser.ConfigParser()
@@ -566,6 +600,7 @@ if SnakeArgs().ports:
                     print("—" * 60)
         except Exception as e:
             print(e)
+            print("".center(60, "—"))
             sys.exit()
 if SnakeArgs().check:
     for n in range(len(host)):
@@ -605,6 +640,7 @@ if SnakeArgs().info:
                     hostname, list, iplist = socket.gethostbyaddr(host[n])
                 except Exception as e:
                     print(e)
+                    print("".center(60, "—"))
                     sys.exit()
 
         hosting = ""
@@ -638,6 +674,7 @@ if SnakeArgs().info:
                         pass
         except Exception as e:
             print(e)
+            print("".center(60, "—"))
         print(f"Type IP: {type(ip_obj)}")
         print(f"Version IP: {ip_obj.version}")
         network_obj = ipaddress.ip_network(network)
@@ -678,6 +715,7 @@ if SnakeArgs().thread:
         except Exception as e:
             print(f"|{host[n]}|".center(60, "—"))
             print(e)
+            print("".center(60, "—"))
 
 if SnakeArgs().version:
     print("|Version|".center(60, "—"))
@@ -690,26 +728,6 @@ if SnakeArgs().homedir:
     except Exception as e:
         print(e)
 
-if SnakeArgs().speed:
-    if SnakeArgs().udp:
-        for n in range(len(host)):
-            try:
-                socket.gethostbyname(host[n])
-                print(f"|{host[n]}|".center(60, "—"))
-                PoolExecutorUDP(host[n], ports)
-            except Exception as e:
-                print(f"|{host[n]}|".center(60, "—"))
-                print(e)
-    else:
-        for n in range(len(host)):
-            try:
-                socket.gethostbyname(host[n])
-                print(f"|{host[n]}|".center(60, "—"))
-                PoolProcessExecutor(host[n], ports)
-            except Exception as e:
-                print(f"|{host[n]}|".center(60, "—"))
-                print(e)
-
 
 if SnakeArgs().getssl:
     for n in range(len(host)):

{snakescan-1.8.7 → snakescan-1.8.9}/SnakeScan/__init__.py

@@ -1,6 +1,6 @@
 """Unlock the potential of your network with this powerful IPv4 address scanner. Easily scan IP address ranges, identify active hosts, and even extract IPv4 addresses from IPv6 environments. Enhance your network monitoring, troubleshooting, and security analysis!"""
 
-__version__ = "1.8.7"
+__version__ = "1.8.9"
 import socket
 from time import sleep
 from termcolor import colored

snakescan-1.8.7/SnakeScan/PoolExecutor.py

@@ -1,31 +0,0 @@
-import socket
-from termcolor import colored
-from concurrent.futures import ProcessPoolExecutor
-
-
-def is_port_open_threads(host, port, ports):
-    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, ports):
-    with ProcessPoolExecutor(max_workers=None) as executor:
-        try:
-            for port in ports.keys():
-                future = executor.submit(is_port_open_threads, host, port, ports)
-
-        except Exception as e:
-            print(e)

snakescan-1.8.7/SnakeScan/Pool_UDP_Executor.py

@@ -1,40 +0,0 @@
-import socket
-from termcolor import colored
-from concurrent.futures import ProcessPoolExecutor
-
-
-def is_port_open_threads(host, port, ports, 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')}"
-            )
-        except socket.timeout:
-            print(
-                f"Closed{colored('[X]','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')}"
-            )
-        except ConnectionRefusedError:
-            sock.close()
-    except socket.gaierror:
-        pass
-    except socket.error as e:
-        pass
-
-
-def PoolExecutorUDP(host, ports):
-    with ProcessPoolExecutor(max_workers=None) as executor:
-        try:
-            for port in ports.keys():
-                future = executor.submit(is_port_open_threads, host, port, ports)
-
-        except Exception as e:
-            print(e)