SnakeScan 1.9.4__tar.gz → 1.9.5__tar.gz

{snakescan-1.9.4 → snakescan-1.9.5}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.9.4
+Version: 1.9.5
 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
 Description-Content-Type: text/markdown
 License-Expression: MIT
 License-File: LICENSE
-Requires-Dist: art
 Requires-Dist: tqdm
 Requires-Dist: termcolor
 
@@ -139,5 +138,5 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.4 (Bugs fix)
+**Last Updated:** 1.9.5 (Added more detailed documentation when using the -h, --help argument, and an update will soon be available that will allow saving port information to a json file.)
 

{snakescan-1.9.4 → snakescan-1.9.5}/README.md

@@ -126,4 +126,4 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.4 (Bugs fix)
+**Last Updated:** 1.9.5 (Added more detailed documentation when using the -h, --help argument, and an update will soon be available that will allow saving port information to a json file.)

{snakescan-1.9.4 → snakescan-1.9.5}/SnakeScan/CLI.py

@@ -1,26 +1,32 @@
 import os
-import asyncio
-import configparser
-from pathlib import Path
-import json
 import sys
+import json
 import string
-import argparse
 import socket
+import asyncio
+import argparse
 import ipaddress
-from art import tprint
+import configparser
+from re import compile
+from tqdm import tqdm
+from pathlib import Path
+from threading import Thread
 from termcolor import colored
 from concurrent.futures import ThreadPoolExecutor
-from threading import Thread
-from tqdm import tqdm
 from SnakeScan.Check_subnet import Check_network
 from SnakeScan.Get_ssl import Get_ssl
 
+save_port_stats = []
+save = False
+
+hosts = compile(r"http://|https://|http:|https:")
+
 excepthost = []
 OpenPorts = []
 threads = []
 portsopen = 0
 portsclosed = 0
+
 ports = {
     7: "ECHO",
     9: "DISCARD",
@@ -79,21 +85,26 @@ ports = {
 
 
 async def is_port_open_async(host, port):
+    if save:
+        port_stats = {"ip": "", "port": "", "service": "", "status": "", "type": "tcp"}
+        port_stats.update({"ip": host, "port": 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"
-            )
+            print(f"{ports.get(port)} -> {colored('|X|','red')} -> {f'{port}'}")
         except Exception:
-            print(f"Closed\033[31m|X|\033[0m-->\033[31m|{port}|\033[0m")
+            print(f"{colored(f'{port}','red')}-->{colored(f'|X|','red')}")
+        if save:
+            port_stats.update({"status": "Close", "service": ports.get(port)})
+            save_port_stats.append(port_stats)
     else:
-        print(
-            f"Open\033[32m|√|\033[0m-->\033[92m{ports.get(port)}\033[0m\033[32m|{port}|\033[0m"
-        )
+        print(f"{ports.get(port)} -> {colored('|√|','green')} -> {f'{port}'}")
+        if save:
+            port_stats.update({"status": "Open", "service": ports.get(port)})
+            save_port_stats.append(port_stats)
         writer.close()
         await writer.wait_closed()
 
@@ -217,36 +228,50 @@ else:
 if __name__ == "__main__":
     main()
 
-version = "1.9.4"
+version = "1.9.5"
 
 
 def is_port_open(host, port):
+    if save:
+        port_stats = {"ip": "", "port": "", "service": "", "status": "", "type": "tcp"}
+        port_stats.update({"ip": host, "port": port})
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         try:
             s.settimeout(1)
             s.connect((host, port))
         except (OSError, socket.timeout):
+            if save:
+                port_stats.update({"status": "Close", "service": ports.get(port)})
+                save_port_stats.append(port_stats)
             return False
         else:
+            if save:
+                port_stats.update({"status": "Open", "service": ports.get(port)})
+            save_port_stats.append(port_stats)
             return True
 
 
 def is_port_open_threads(host, port):
+    if save:
+        port_stats = {"ip": "", "port": "", "service": "", "status": "", "type": "tcp"}
+        port_stats.update({"ip": host, "port": port})
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         try:
             s.settimeout(1)
             s.connect((host, port))
         except (OSError, socket.timeout):
+            if save:
+                port_stats.update({"status": "Close", "service": ports.get(port)})
+                save_port_stats.append(port_stats)
             try:
-                print(
-                    f"Closed{colored('|X|','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')}"
-                )
+                print(f"{ports.get(port)} -> {colored('|X|','red')} -> {f'{port}'}")
             except Exception as e:
-                print(f"Closed{colored('|X|','red')}-->{colored(f'|{port}|','red')}")
+                print(f"{colored(f'{port}','red')}-->{colored(f'|X|','red')}")
         else:
-            print(
-                f"Open{colored('|√|','green')}-->{colored(ports.get(port),'light_green')}{colored(f'|{port}|','green')}"
-            )
+            if save:
+                port_stats.update({"status": "Open", "service": ports.get(port)})
+            save_port_stats.append(port_stats)
+            print(f"{ports.get(port)} -> {colored('|√|','green')} -> {f'{port}'}")
 
 
 def Ports(str=""):
@@ -278,60 +303,83 @@ def Ports(str=""):
 
 def SnakeArgs():
     parser = argparse.ArgumentParser(
-        description="SnakeScan - It's a command line library for scan and get information about ip."
+        description="SnakeScan is a command library / tool for performing port monitoring and maintenance tasks on the target system, it provides the ability to provide reliable protection against any threatening factors that can harm the user's system."
     )
     parser.add_argument("host", nargs="?", default="None")
     parser.add_argument(
         "-a",
         "--asynchrous",
         action="store_true",
-        help="Use scan with asyncio",
+        help="Use only for Asynchronous scanning. **WARNING: uses only TCP type of ports.",
     )
     parser.add_argument(
         "-home",
         "--homedir",
         action="store_true",
-        help="Show path to SnakeScan home directory",
+        help="Shows the path to the program folder that is used to store and use your own data. **Even after deleting, this folder will be created again. You can only transfer the data that it can read and use to the folder.",
     )
     parser.add_argument(
         "-d",
         "--dictonary",
         required=False,
         default="None",
-        help="Use custom port dictionaries",
+        help="Specify the path to your own custom dictionaries with ports designations. **JSON format. Example: -d myFolder/tcp_ports.json,myFolder/udp_ports **Order: 1(TCP ports), 2(UDP ports). **WARNING: do not change the order, because this will lead to confusing the program and its incorrect operation. **Way to solve the problem: Use the -dr command to clear the paths you specified earlier.",
     )
     parser.add_argument(
-        "-u", "--udp", action="store_true", help="Use UDP ports for scanning"
+        "-u",
+        "--udp",
+        action="store_true",
+        help="Changes the port type for all types of scanning to UDP. **WARNING: Does not change the port type for such scanning types: -A(Asynchronous), since only TCP port type is used.",
     )
     parser.add_argument(
         "-ds",
         "--dictshow",
         action="store_true",
-        help="Shows paths to port dictionaries",
+        help="Displays paths to custom port dictionaries. **WARNING: Use if you need paths to your dictionaries.",
     )
     parser.add_argument(
         "-dr",
         "--dictremove",
         action="store_true",
-        help="Removes user port dictionaries",
+        help="Removes custom port dictionaries from the program. **WARNING: Does not remove custom port dictionaries. **If you need to remove it, remove it manually.",
+    )
+    parser.add_argument(
+        "-gs",
+        "--getssl",
+        action="store_true",
+        help="Use to obtain an official SSL site certificate. **WARNING: Use to find the SSL certificate of the site you want.",
+    )
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="store_true",
+        help="Use to find out the library version.",
     )
     parser.add_argument(
-        "-gs", "--getssl", action="store_true", help="Get official ssl certificate"
+        "-i",
+        "--info",
+        action="store_true",
+        help="Use to collect host IP information. **Type, Version, Network, Subnet mask, Host, IP-address.",
+    )
+    parser.add_argument(
+        "-p",
+        "--ports",
+        help="Use to enter a range of ports. **Example: -p 10-20, -p 20-30,40-60, -p 100.",
     )
-    parser.add_argument("-v", "--version", action="store_true", help="Library version")
     parser.add_argument(
-        "-i", "--info", action="store_true", help="IP information about host"
+        "-t",
+        "--thread",
+        action="store_true",
+        help="Use to scan only with using ThreadPoolExecutor. **WARNING: If you use it in a place with the -u argument, then this will change the type of scanned ports to UDP.",
     )
-    parser.add_argument("-p", "--ports", help="Range ports to scan host")
     parser.add_argument(
-        "-t", "--thread", action="store_true", help="Scan with using ThreadPoolExecutor"
+        "-ch", "--check", action="store_true", help="Use to scan the IP subnet."
     )
-    parser.add_argument("-ch", "--check", action="store_true", help="Scan ip subnet")
     parser.add_argument(
         "-l",
         "--local",
         action="store_true",
-        help="View you public ip - need internet",
+        help="Use to view your current public IP address. **WARNING: To use this argument, you need to connect to the network to accurately determine the public address.",
     )
     args = parser.parse_args()
     return args
@@ -341,25 +389,7 @@ port_user = SnakeArgs().ports
 host = SnakeArgs().host.split(",")
 filepath = SnakeArgs().dictonary.split(",")
 for n in range(len(host)):
-    if host[n].startswith("http://"):
-        host[n] = host[n].strip()
-        host[n] = host[n].split("http:")
-        host[n] = host[n][1].strip("//")
-        host[n] = host[n].split("/")
-        host[n] = host[n][0]
-        for i in range(len(host)):
-            if host[n][i] == "/":
-                host[n] = host[n][0:i]
-for n in range(len(host)):
-    if host[n].startswith("https://"):
-        host[n] = host[n].strip()
-        host[n] = host[n].split("https:")
-        host[n] = host[n][1].strip("//")
-        host[n] = host[n].split("/")
-        host[n] = host[n][0]
-        for i in range(len(host)):
-            if host[n][i] == "/":
-                host[n] = host[n][0:i]
+    host[n] = hosts.sub("", host[n])
 if host[0] == "None":
     host[0] = "localhost"
 if filepath[0] != "None":
@@ -373,6 +403,15 @@ if filepath[0] != "None":
 if SnakeArgs().udp:
 
     def is_port_open(host, port, timeout=1):
+        if save:
+            port_stats = {
+                "ip": "",
+                "port": "",
+                "service": "",
+                "status": "",
+                "type": "udp",
+            }
+            port_stats.update({"ip": host, "port": port})
         try:
             sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
             sock.settimeout(timeout)
@@ -384,10 +423,19 @@ if SnakeArgs().udp:
             try:
                 data, server = sock.recvfrom(4096)
                 print(f"Response received: {data.decode()} from {server}")
+                if save:
+                    port_stats.update({"status": "Open", "service": ports.get(port)})
+                    save_port_stats.append(port_stats)
                 is_open = True
             except socket.timeout:
+                if save:
+                    port_stats.update({"status": "Close", "service": ports.get(port)})
+                    save_port_stats.append(port_stats)
                 is_open = False
             except ConnectionRefusedError:
+                if save:
+                    port_stats.update({"status": "Close", "service": ports.get(port)})
+                    save_port_stats.append(port_stats)
                 is_open = False
 
             sock.close()
@@ -397,8 +445,21 @@ if SnakeArgs().udp:
             return None
         except socket.error as e:
             return False
+        else:
+            if save:
+                port_stats.update({"status": "Close", "service": ports.get(port)})
+                save_port_stats.append(port_stats)
 
     def is_port_open_threads(host, port, timeout=1):
+        if save:
+            port_stats = {
+                "ip": "",
+                "port": "",
+                "service": "",
+                "status": "",
+                "type": "udp",
+            }
+            port_stats.update({"ip": host, "port": port})
         try:
             sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
             sock.settimeout(timeout)
@@ -410,19 +471,26 @@ if SnakeArgs().udp:
             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')}"
-                )
+                print(f"{ports.get(port)} -> {colored('|√|','green')} -> {f'{port}'}")
+                if save:
+                    port_stats.update({"status": "Open", "service": ports.get(port)})
+                    save_port_stats.append(port_stats)
             except socket.timeout:
-                print(
-                    f"Closed{colored('[X]','red')}-->{colored(ports.get(port),'light_red')}{colored(f'|{port}|','red')}"
-                )
+                print(f"{ports.get(port)} -> {colored('|X|','red')} -> {f'{port}'}")
             except ConnectionRefusedError:
                 sock.close()
+            else:
+                if save:
+                    port_stats.update({"status": "Close", "service": ports.get(port)})
+                    save_port_stats.append(port_stats)
         except socket.gaierror:
             pass
         except socket.error as e:
             pass
+        else:
+            if save:
+                port_stats.update({"status": "Close", "service": ports.get(port)})
+                save_port_stats.append(port_stats)
 
     if ports_udp:
         ports = ports_udp
@@ -566,18 +634,12 @@ if SnakeArgs().ports:
         OpenPorts = []
         for port in range(len(port_user)):
             if is_port_open(host[n], port_user[port]):
-                print(
-                    f"Open{colored('|√|','green')}{host[n]}-->{colored(f'{str(ports.get(port_user[port],''))}','light_green')}{colored(f'|{port_user[port]}|','green')}"
-                )
+                print(f"{ports.get(port)} -> {colored('|√|','green')} -> {f'{port}'}")
             else:
                 try:
-                    print(
-                        f"Closed{colored('|X|','red')}{host[n]}-->{colored(str(ports.get(port_user[port],'')),'light_red')}{colored(f'|{port_user[port]}|','red')}"
-                    )
+                    print(f"{ports.get(port)} -> {colored('|X|','red')} -> {f'{port}'}")
                 except:
-                    print(
-                        f"Closed{colored('|X|','red')}{host[n]}-->{colored(f'|{port_user[port]}|','red')}"
-                    )
+                    print(f"{colored(f'{port}','red')}-->{colored(f'|X|','red')}")
         try:
             first = rangeports[::2]
             second = rangeports[1::2]
@@ -598,7 +660,7 @@ if SnakeArgs().ports:
                         portsclosed += 1
                 if OpenPorts:
                     for i in OpenPorts:
-                        print(f"Open{colored('|√|','green')}-->{ports[i]}|{i}|")
+                        print(f"{ports[i]} -> {colored('|√|','green')} -> {f'{i}'}")
                 print(f"Closed{colored('|X|','red')}:{max(0,portsclosed - 1)}")
                 print(f"Open{colored('|√|','green')}:{portsopen}")
                 portsopen = 0
@@ -726,6 +788,7 @@ if SnakeArgs().version:
 if SnakeArgs().homedir:
     try:
         home = Path.home() / "SnakeScan"
+        home = home.expanduser()
         print(f"SnakeScan home directory: {home}")
     except Exception as e:
         print(e)

{snakescan-1.9.4 → snakescan-1.9.5}/SnakeScan/Check_subnet.py

@@ -20,10 +20,10 @@ def Check_network(host):
                 command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True
             )
             if result.returncode == 0:
-                print(f"{ip}-->{colored('|√|','green')}")
+                print(f"{ip}-->{colored(f'{result.stdout}','green')}")
                 return True
             else:
-                print(f"{ip}-->{colored('|X|','red')}")
+                print(f"{ip}-->{colored(f'{result.stdout}','red')}")
                 return False
         except Exception as e:
             print(f"Check error {ip}: {e}")

{snakescan-1.9.4 → snakescan-1.9.5}/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.9.4"
+__version__ = "1.9.5"
 import socket
 from time import sleep
 from termcolor import colored

{snakescan-1.9.4 → snakescan-1.9.5}/pyproject.toml

@@ -12,7 +12,6 @@ license = "MIT"
 license-files = ["LICENSE"]
 dynamic = ["version","description"]
 dependencies = [
-        "art",
         "tqdm",
         "termcolor",
     ]