SnakeScan 1.9.4__tar.gz → 1.9.7__tar.gz

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

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.9.4
+Version: 1.9.7
 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
 
@@ -27,6 +26,8 @@ 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.
@@ -72,34 +73,38 @@ flit install
 ## ⌨️ Command Line Usage:
 
 ### 💡 Attribute Reference:
+	
+* * Commands for individual actions (Updating 1.9.6): scan, info, dict, save
+
+*   **-time**: Sets a timeout for each port.   Examples: `snake scan -time 4`
 
-*   **-p**: Specify target ports to scan (single port or range).  Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+*   **-p**: Specify target ports to scan (single port or range).  Examples: `snake scan -p 80,443` or `snake scan -p 80,3437,8080,20-30,79-443`
 
-*   **-u**: Enable scanning of UDP ports. Example: `snake -p 53 -u`
+*   **-u**: Enable scanning of UDP ports. Example: `snake scan -p 53 -u`
 
 *   **-h**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
 
-*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
+*   **-v**: Display the current version of the SnakeScan library. Example: `snake info -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.)
+*   **-gs**: Retrieve an SSL/TLS certificate from a specified web server. Example: `snake www.google.com info -gs` (Requires a valid hostname to avoid connection errors.)
 
-*   **-t**: Enable multithreading for improved scanning performance. Example: `snake -t`
+*   **-t**: Enable multithreading for improved scanning performance. Example: `snake scan -t`
 
-*   **-ch**: Scan the subnet for active IP addresses within the network. Example: `snake -ch`
+*   **-ch**: Scan the subnet for active IP addresses within the network. Example: `snake info -ch`
 
-*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
+*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake info -l`
 
-*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
+*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com info -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.
+*   **-a --asynchronous**: Uses all ports from the predefined dictionary for asynchronous port scanning. Example: `snake scan -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`)
+    Example: `snake dict -d /path/to/tcp_ports.json,/path/to/udp_ports.json` (if you want to specify both TCP and UDP, if only TCP: `snake dict -d /path/to/tcp_ports.json`)
 
     **Subsequent Use**: After the initial setup, you can simply use the `-d` flag without the file paths, and SnakeScan can utilize the previously defined JSON files.
 
-    Example (after initial setup): `snake -d` (may use previously stored paths)
+    Example (after initial setup): `snake dict -d` (may use previously stored paths)
 
     **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.
 
@@ -111,11 +116,11 @@ flit install
     }
     ```
 
-*   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake -dr`
+*   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake dict -dr`
 
-*   **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful for verifying which custom definitions are loaded. Example: `snake -ds`
+*   **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful for verifying which custom definitions are loaded. Example: `snake dict -ds`
 
-*   **-home --homedir**: Display the user's home directory and the location of the `config.ini` file. The home directory is determined automatically using the `pathlib` library. Example: `snake -home`, `snake --homedir`
+*   **-home --homedir**: Display the user's home directory and the location of the `config.ini` file. The home directory is determined automatically using the `pathlib` library. Example: `snake info -home`, `snake info --homedir`
 
 ## 💻 Python Code Integration:
 
@@ -139,5 +144,5 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.4 (Bugs fix)
+**Last Updated:** 1.9.7 (Added a new argument -time, --timeout, and also added commands for individual actions: scan, info, dict, save)
 

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

@@ -14,6 +14,8 @@ 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,34 +61,38 @@ flit install
 ## ⌨️ Command Line Usage:
 
 ### 💡 Attribute Reference:
+	
+* * Commands for individual actions (Updating 1.9.6): scan, info, dict, save
+
+*   **-time**: Sets a timeout for each port.   Examples: `snake scan -time 4`
 
-*   **-p**: Specify target ports to scan (single port or range).  Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+*   **-p**: Specify target ports to scan (single port or range).  Examples: `snake scan -p 80,443` or `snake scan -p 80,3437,8080,20-30,79-443`
 
-*   **-u**: Enable scanning of UDP ports. Example: `snake -p 53 -u`
+*   **-u**: Enable scanning of UDP ports. Example: `snake scan -p 53 -u`
 
 *   **-h**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
 
-*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
+*   **-v**: Display the current version of the SnakeScan library. Example: `snake info -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.)
+*   **-gs**: Retrieve an SSL/TLS certificate from a specified web server. Example: `snake www.google.com info -gs` (Requires a valid hostname to avoid connection errors.)
 
-*   **-t**: Enable multithreading for improved scanning performance. Example: `snake -t`
+*   **-t**: Enable multithreading for improved scanning performance. Example: `snake scan -t`
 
-*   **-ch**: Scan the subnet for active IP addresses within the network. Example: `snake -ch`
+*   **-ch**: Scan the subnet for active IP addresses within the network. Example: `snake info -ch`
 
-*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake -l`
+*   **-l**: Display your public IP address (requires an active internet connection). Example: `snake info -l`
 
-*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com -i`
+*   **-i**: Show detailed information about a specific IP address (supports both IPv4 and IPv6). Example: `snake www.google.com info -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.
+*   **-a --asynchronous**: Uses all ports from the predefined dictionary for asynchronous port scanning. Example: `snake scan -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`)
+    Example: `snake dict -d /path/to/tcp_ports.json,/path/to/udp_ports.json` (if you want to specify both TCP and UDP, if only TCP: `snake dict -d /path/to/tcp_ports.json`)
 
     **Subsequent Use**: After the initial setup, you can simply use the `-d` flag without the file paths, and SnakeScan can utilize the previously defined JSON files.
 
-    Example (after initial setup): `snake -d` (may use previously stored paths)
+    Example (after initial setup): `snake dict -d` (may use previously stored paths)
 
     **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.
 
@@ -98,11 +104,11 @@ flit install
     }
     ```
 
-*   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake -dr`
+*   **-dr**: Reset custom port dictionaries to their default state and revert to standard SnakeScan port definitions. Example: `snake dict -dr`
 
-*   **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful for verifying which custom definitions are loaded. Example: `snake -ds`
+*   **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful for verifying which custom definitions are loaded. Example: `snake dict -ds`
 
-*   **-home --homedir**: Display the user's home directory and the location of the `config.ini` file. The home directory is determined automatically using the `pathlib` library. Example: `snake -home`, `snake --homedir`
+*   **-home --homedir**: Display the user's home directory and the location of the `config.ini` file. The home directory is determined automatically using the `pathlib` library. Example: `snake info -home`, `snake info --homedir`
 
 ## 💻 Python Code Integration:
 
@@ -126,4 +132,4 @@ watcher.start()  # Start monitoring!
 
 ---
 
-**Last Updated:** 1.9.4 (Bugs fix)
+**Last Updated:** 1.9.7 (Added a new argument -time, --timeout, and also added commands for individual actions: scan, info, dict, save)