SnakeScan 1.9.7__tar.gz → 1.9.9__tar.gz

{snakescan-1.9.7 → snakescan-1.9.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.9.7
+Version: 1.9.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
@@ -11,7 +11,7 @@ Requires-Dist: tqdm
 Requires-Dist: termcolor
 
 <!--
-This documentation was created with GeekBot Language Model and Den*Ram
+This documentation was created using the Language Model Geekbot and DEN-RAM. All code provided in the Python package is created exclusively by the author.
 
 -->
 
@@ -26,8 +26,6 @@ A versatile and efficient Python library designed for comprehensive network port
 
 **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.
 
-Attention: A large number of bugs were found, so the use of several subcommands is not possible at the moment, and this will be corrected after 3 days. Because of this, it is recommended to use version 1.9.5 and below. Version 1.9.7 must be fixed.
-
 ## ⚙️ Key Features:
 
 *   **Flexible Port Specification:** Define target ports as individual values, ranges, or through preconfigured sets.
@@ -71,10 +69,24 @@ cd [directory where the archive was unpacked]
 flit install
 
 ## ⌨️ Command Line Usage:
+	
+ * Commands for individual actions (Updating 1.9.8): scan{save}, info, dict.
+
+ * Commands cannot be used in one line: Snake scan -t info -i dict -d ~ cause an error due to incorrect command input.
+
+ * The optional "save" command was added to the "scan" command.
+
+ * "save" ~ Attributes - 
+"-s", "--save", help= Gives permission to save the file.
+"-n", "--name", help= The name of the file to be saved.
+"-p", "--path", help= Specify your own file save path.
+"-a", "--append", help= Add an existing file with data. **WARNING: By default, the file is overwritten every time you save it using this argument, the file will be supplemented without overwriting the content.
 
 ### 💡 Attribute Reference:
-	
-* * Commands for individual actions (Updating 1.9.6): scan, info, dict, save
+
+*   **-hf --hostfile**: Allows you to use a file with pre-known hosts. **Example: snake -hf myPath/hosts.json,myPath/home/hosts_to_scan.json. **Format: JSON. **WARNING: Can take multiple host file paths or one as an argument value. If this argument is applied, the -hs[host] argument will not be applied.`
+				
+*   **-hs --host**: Provides the ability to enter a host. **WARNING: If value and argument are not specified, the default value will be used. **Default value: localhost.`
 
 *   **-time**: Sets a timeout for each port.   Examples: `snake scan -time 4`
 
@@ -144,5 +156,5 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.7 (Added a new argument -time, --timeout, and also added commands for individual actions: scan, info, dict, save)
+**Last Updated:** 1.9.9 (Fix bugs, added the -hf argument, --hostfile.)
 

{snakescan-1.9.7 → snakescan-1.9.9}/README.md

@@ -1,5 +1,5 @@
 <!--
-This documentation was created with GeekBot Language Model and Den*Ram
+This documentation was created using the Language Model Geekbot and DEN-RAM. All code provided in the Python package is created exclusively by the author.
 
 -->
 
@@ -14,8 +14,6 @@ A versatile and efficient Python library designed for comprehensive network port
 
 **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.
 
-Attention: A large number of bugs were found, so the use of several subcommands is not possible at the moment, and this will be corrected after 3 days. Because of this, it is recommended to use version 1.9.5 and below. Version 1.9.7 must be fixed.
-
 ## ⚙️ Key Features:
 
 *   **Flexible Port Specification:** Define target ports as individual values, ranges, or through preconfigured sets.
@@ -59,10 +57,24 @@ cd [directory where the archive was unpacked]
 flit install
 
 ## ⌨️ Command Line Usage:
+	
+ * Commands for individual actions (Updating 1.9.8): scan{save}, info, dict.
+
+ * Commands cannot be used in one line: Snake scan -t info -i dict -d ~ cause an error due to incorrect command input.
+
+ * The optional "save" command was added to the "scan" command.
+
+ * "save" ~ Attributes - 
+"-s", "--save", help= Gives permission to save the file.
+"-n", "--name", help= The name of the file to be saved.
+"-p", "--path", help= Specify your own file save path.
+"-a", "--append", help= Add an existing file with data. **WARNING: By default, the file is overwritten every time you save it using this argument, the file will be supplemented without overwriting the content.
 
 ### 💡 Attribute Reference:
-	
-* * Commands for individual actions (Updating 1.9.6): scan, info, dict, save
+
+*   **-hf --hostfile**: Allows you to use a file with pre-known hosts. **Example: snake -hf myPath/hosts.json,myPath/home/hosts_to_scan.json. **Format: JSON. **WARNING: Can take multiple host file paths or one as an argument value. If this argument is applied, the -hs[host] argument will not be applied.`
+				
+*   **-hs --host**: Provides the ability to enter a host. **WARNING: If value and argument are not specified, the default value will be used. **Default value: localhost.`
 
 *   **-time**: Sets a timeout for each port.   Examples: `snake scan -time 4`
 
@@ -132,4 +144,4 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.7 (Added a new argument -time, --timeout, and also added commands for individual actions: scan, info, dict, save)
+**Last Updated:** 1.9.9 (Fix bugs, added the -hf argument, --hostfile.)

{snakescan-1.9.7 → snakescan-1.9.9}/SnakeScan/CLI.py

@@ -176,7 +176,7 @@ async def is_port_open_async(host, port, timeout=1):
             print(f"[!] WARNING: Error - {e}")
 
 
-async def is_port_run_threads(host, ports):
+async def is_port_run_threads(host, ports, timeout=1):
     for n in range(len(host)):
         try:
             loop = asyncio.get_event_loop()
@@ -296,7 +296,7 @@ else:
 if __name__ == "__main__":
     main()
 
-version = "1.9.7"
+version = "1.9.9"
 
 
 def is_port_open(host, port, argument=None, protocol=socket.SOCK_STREAM, timeout=1):
@@ -430,37 +430,20 @@ def SnakeArgs():
         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",
+        "-hs",
+        "--host",
         nargs="?",
         default="None",
+        help="Provides the ability to enter a host. **WARNING: If the value is not specified, the default value will be used. **Default value: localhost.",
     )
-    command = parser.add_subparsers(dest="command", help="List of commands")
-    save = command.add_parser(
-        name="save", help="Allows you to create a log with port data to a file."
-    )
-    save.add_argument(
-        "-s",
-        "--save",
-        help="Gives permission to save the file.",
-        action="store_true",
-        required="true",
-    )
-    save.add_argument(
-        "-n",
-        "--name",
-        help="The name of the file to be saved.",
+    parser.add_argument(
+        "-hf",
+        "--hostfile",
         nargs="?",
-        default="saved_backup_ports_01.json",
-    )
-    save.add_argument(
-        "-p", "--path", help="Specify your own file save path.", nargs="?"
-    )
-    save.add_argument(
-        "-a",
-        "--append",
-        help="Add an existing file with data. **WARNING: By default, the file is overwritten every time you save it using this argument, the file will be supplemented without overwriting the content.",
-        action="store_true",
+        default=False,
+        help="Allows you to use a file with pre-known hosts. **Example: snake -hf myPath/hosts.json,myPath/home/hosts_to_scan.json. **Format: JSON. **WARNING: Can take multiple host file paths or one as an argument value. If this argument is applied, the -hs[host] argument will not be applied.",
     )
+    command = parser.add_subparsers(dest="command", help="List of commands")
     scan = command.add_parser(name="scan", help="Allows you to use scanning.")
     scan.add_argument(
         "-a",
@@ -492,6 +475,35 @@ def SnakeArgs():
         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.",
     )
+    save_command = scan.add_subparsers(
+        dest="save", help="Allows you to create a log with port data to a file."
+    )
+    save = save_command.add_parser(
+        name="save", help="Use to save data to a file. **Format: JSON."
+    )
+    save.add_argument(
+        "-s",
+        "--save",
+        help="Gives permission to save the file.",
+        action="store_true",
+        required="true",
+    )
+    save.add_argument(
+        "-n",
+        "--name",
+        help="The name of the file to be saved.",
+        nargs="?",
+        default="saved_backup_ports_01.json",
+    )
+    save.add_argument(
+        "-p", "--path", help="Specify your own file save path.", nargs="?"
+    )
+    save.add_argument(
+        "-a",
+        "--append",
+        help="Add an existing file with data. **WARNING: By default, the file is overwritten every time you save it using this argument, the file will be supplemented without overwriting the content.",
+        action="store_true",
+    )
     info = command.add_parser(
         name="info", help="Allows you to get the information you need."
     )
@@ -560,6 +572,26 @@ for n in range(len(host)):
 if host[0] == "None":
     host[0] = "localhost"
 
+if SnakeArgs().hostfile:
+    host = []
+    hosting = []
+    hostfiles = SnakeArgs().hostfile.split(",")
+    for h in hostfiles:
+        try:
+            host.append(load_json_config(h))
+        except Exception as e:
+            print(f"[!] WARNING: Error - {e}")
+            continue
+    try:
+        for n in host:
+            for i in n.values():
+                hosting.append(i)
+        host = hosting
+    except Exception as e:
+        print(
+            f"[!] Warning: Error - syntax error has been made when entering the file path to the file(s)."
+        )
+
 if SnakeArgs().command == "scan":
     scan_protocol = socket.SOCK_DGRAM if SnakeArgs().udp else socket.SOCK_STREAM
 
@@ -587,34 +619,37 @@ if SnakeArgs().command == "dict":
                 ports_tcp = load_json_config(filepath[0])
                 Save_config(filepath[0], "")
 
-if SnakeArgs().command == "save":
-    save = True
+if SnakeArgs().command == "scan":
+    if SnakeArgs().save:
+        save = True
 
-    def Save(data):
-        if SnakeArgs().path:
+        def Save(data):
+            if SnakeArgs().path:
+                try:
+                    path = Path(str(SnakeArgs().path)).expanduser()
+                except Exception as e:
+                    print(f"[!] WARNING: Error - {e}")
+                    sys.exit()
+            else:
+                path = Path.home() / "SnakeScan"
+
+            if SnakeArgs().name:
+                name = str(SnakeArgs().name)
+            else:
+                name = "saved_backup_ports_01.json"
             try:
-                path = Path(str(SnakeArgs().path)).expanduser()
+                name = str(name)
+                if name.endswith(".json"):
+                    pass
+                else:
+                    name = name + ".json"
+                with open(
+                    path / name, "w" if SnakeArgs().append != True else "a"
+                ) as path:
+                    json.dump(data, path, ensure_ascii=False, indent=4)
             except Exception as e:
                 print(f"[!] WARNING: Error - {e}")
                 sys.exit()
-        else:
-            path = Path.home() / "SnakeScan"
-
-        if SnakeArgs().name:
-            name = str(SnakeArgs().name)
-        else:
-            name = "saved_backup_ports_01.json"
-        try:
-            name = str(name)
-            if name.endswith(".json"):
-                pass
-            else:
-                name = name + ".json"
-            with open(path / name, "w" if SnakeArgs().append != True else "a") as path:
-                json.dump(data, path, ensure_ascii=False, indent=4)
-        except Exception as e:
-            print(f"[!] WARNING: Error - {e}")
-            sys.exit()
 
 
 if SnakeArgs().command == "scan":
@@ -632,7 +667,7 @@ if SnakeArgs().command == "scan":
 
 if SnakeArgs().command == "scan":
     if SnakeArgs().asynchronous:
-        asyncio.run(is_port_run_threads(host, ports, timeout))
+        asyncio.run(is_port_run_threads(host, ports))
 
 
 if SnakeArgs().command == "dict":
@@ -671,6 +706,7 @@ if SnakeArgs().command == "scan":
         excepthost = []
         for n in range(len(host)):
             OpenPorts = []
+            print(f"|{host[n]}|".center(60, "—"))
             for port in range(len(port_user)):
                 if is_port_open(host[n], port_user[port], None, scan_protocol, timeout):
                     print(
@@ -690,6 +726,7 @@ if SnakeArgs().command == "scan":
                         print(
                             f"{colored(f'{port_user[port]}','red')}-->{colored(f'|X|','red')}"
                         )
+                print("".center(60, "—"))
             try:
                 first = rangeports[::2]
                 second = rangeports[1::2]
@@ -837,7 +874,7 @@ if SnakeArgs().command == "scan":
                         )
                         future.result()
                 except Exception as e:
-                    print("".center(60, "—"))
+                    print(f"|{host[n]}|".center(60, "—"))
                     print(e)
                     print("".center(60, "—"))
 

{snakescan-1.9.7 → snakescan-1.9.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.9.7"
+__version__ = "1.9.9"
 import socket
 from time import sleep
 from termcolor import colored