SnakeScan 1.8.6__tar.gz → 1.8.7__tar.gz

snakescan-1.8.7/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: SnakeScan
+Version: 1.8.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
+
+<!--
+This documentation was created with GeekBot Language Model and Den*Ram
+
+-->
+
+# 🐍 SnakeScan: A Reliable 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: 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.
+
+## ⚙️ Key Features:
+
+*   **Flexible Port Specification:** Define target ports as individual values, ranges, or through preconfigured sets.
+
+*   **Multi-Threaded Architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
+
+*   **IP Address 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 the status of critical ports.
+
+*   **Concise Command-Line Interface and API:** Easily integrate SnakeScan into workflows via command-line or programmatic access.
+
+*   **UDP Port Scanning:** Built-in support for scanning UDP ports.
+
+*   **Customizable Port Dictionaries:** Add your own port descriptions from JSON files and easily revert to the default set.
+
+*   **Automatic Home Directory Detection:** Uses `pathlib` to automatically detect the user's home directory, storing configuration files in a dedicated folder. **All configuration files are now located in this dedicated directory, ensuring that changes to SnakeScan's configuration do not affect the installed library files. This provides a secure and resilient setup.**
+
+## ⬇️ 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.
+
+**Note:** Installing from the archive requires the **Flit** package to be installed. After downloading the archive, you need to unpack it and navigate to the directory containing the unpacked files. The command to unpack the archive depends on the archive format and the operating system being used.
+
+bash
+
+pip install flit
+
+cd [directory where the archive was unpacked]
+
+flit install
+
+## ⌨️ Command Line Usage:
+
+### 💡 Attribute Reference:
+
+*   **-p**: Specify target ports to scan (single port or range). Note: Range excludes the lower bound in the first entry. For example: To scan from port 80 through 443, specify the range as `79-443`. Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+
+*   **-u**: Enable scanning of UDP ports. Example: `snake -p 53 -u`
+
+*   **-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.)
+
+*   **-t**: Enable multithreading for improved scanning performance. Example: `snake -t`
+
+*   **-ch**: Scan the subnet for active IP addresses within 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`
+
+*   **-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`)
+
+    **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)
+
+    **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`
+
+*   **-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`
+
+*   **-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`
+
+## 💻 Python Code Integration:
+
+### ⏱️ Watcher Class: Real-Time Port Status
+
+The `Watcher` class allows you to continuously monitor a specified port.
+
+python
+
+from SnakeScan import Watcher
+
+watcher = Watcher("localhost", 53, 2)  # Host, Port, Check Interval (in seconds)
+
+watcher.start()  # Start monitoring!
+
+#### `Watcher` Methods:
+
+*   `Watcher.start()` - Start the port monitoring process.
+
+*   `Watcher.stop()` - Terminate the port monitoring process.
+
+---
+
+**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.)
+
+

snakescan-1.8.7/README.md

@@ -0,0 +1,141 @@
+<!--
+This documentation was created with GeekBot Language Model and Den*Ram
+
+-->
+
+# 🐍 SnakeScan: A Reliable 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: 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.
+
+## ⚙️ Key Features:
+
+*   **Flexible Port Specification:** Define target ports as individual values, ranges, or through preconfigured sets.
+
+*   **Multi-Threaded Architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
+
+*   **IP Address 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 the status of critical ports.
+
+*   **Concise Command-Line Interface and API:** Easily integrate SnakeScan into workflows via command-line or programmatic access.
+
+*   **UDP Port Scanning:** Built-in support for scanning UDP ports.
+
+*   **Customizable Port Dictionaries:** Add your own port descriptions from JSON files and easily revert to the default set.
+
+*   **Automatic Home Directory Detection:** Uses `pathlib` to automatically detect the user's home directory, storing configuration files in a dedicated folder. **All configuration files are now located in this dedicated directory, ensuring that changes to SnakeScan's configuration do not affect the installed library files. This provides a secure and resilient setup.**
+
+## ⬇️ 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.
+
+**Note:** Installing from the archive requires the **Flit** package to be installed. After downloading the archive, you need to unpack it and navigate to the directory containing the unpacked files. The command to unpack the archive depends on the archive format and the operating system being used.
+
+bash
+
+pip install flit
+
+cd [directory where the archive was unpacked]
+
+flit install
+
+## ⌨️ Command Line Usage:
+
+### 💡 Attribute Reference:
+
+*   **-p**: Specify target ports to scan (single port or range). Note: Range excludes the lower bound in the first entry. For example: To scan from port 80 through 443, specify the range as `79-443`. Examples: `snake -p 80,443` or `snake -p 80,3437,8080,20-30,79-443`
+
+*   **-u**: Enable scanning of UDP ports. Example: `snake -p 53 -u`
+
+*   **-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.)
+
+*   **-t**: Enable multithreading for improved scanning performance. Example: `snake -t`
+
+*   **-ch**: Scan the subnet for active IP addresses within 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`
+
+*   **-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`)
+
+    **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)
+
+    **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`
+
+*   **-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`
+
+*   **-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`
+
+## 💻 Python Code Integration:
+
+### ⏱️ Watcher Class: Real-Time Port Status
+
+The `Watcher` class allows you to continuously monitor a specified port.
+
+python
+
+from SnakeScan import Watcher
+
+watcher = Watcher("localhost", 53, 2)  # Host, Port, Check Interval (in seconds)
+
+watcher.start()  # Start monitoring!
+
+#### `Watcher` Methods:
+
+*   `Watcher.start()` - Start the port monitoring process.
+
+*   `Watcher.stop()` - Terminate the port monitoring process.
+
+---
+
+**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.)
+

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

@@ -1,5 +1,6 @@
 import os
 import configparser
+from pathlib import Path
 import json
 import sys
 import string
@@ -80,12 +81,23 @@ ports = {
 def Load_config(ports):
     try:
         config = configparser.ConfigParser()
-        package_dir = os.path.dirname(__file__)
+        package_dir = Path.home() / "SnakeScan"
 
-        config_path = os.path.join(package_dir, "config.ini")
+        config_path = package_dir / "config.ini"
 
         config.read(config_path)
-
+        if package_dir.exists() and config_path.is_file():
+            pass
+        else:
+            try:
+                package_dir.mkdir(parents=True, exist_ok=True)
+                config = configparser.ConfigParser()
+                config["Settings"] = {"path_tcp": "", "path_udp": ""}
+                with open(config_path, "w") as configfile:
+                    config.write(configfile)
+            except Exception as e:
+                print(e)
+                sys.exit()
         if "Settings" in config and ports in config["Settings"]:
             return config["Settings"][ports]
     except Exception as e:
@@ -112,9 +124,9 @@ def Save_config(path_tcp, path_udp):
         path_udp = ""
     try:
         config = configparser.ConfigParser()
-        package_dir = os.path.dirname(__file__)
+        package_dir = Path.home() / "SnakeScan"
 
-        config_path = os.path.join(package_dir, "config.ini")
+        config_path = package_dir / "config.ini"
         config["Settings"] = {"path_tcp": path_tcp, "path_udp": path_udp}
         with open(config_path, "w") as configfile:
             config.write(configfile)
@@ -171,7 +183,7 @@ else:
 if __name__ == "__main__":
     main()
 
-version = "1.8.6"
+version = "1.8.7"
 
 
 def is_port_open(host, port):
@@ -235,6 +247,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(
+        "-home",
+        "--homedir",
+        action="store_true",
+        help="Show path to SnakeScan home directory",
+    )
     parser.add_argument(
         "-d",
         "--dictonary",
@@ -481,8 +499,8 @@ else:
 if SnakeArgs().dictremove:
     try:
         config = configparser.ConfigParser()
-        package_dir = os.path.dirname(__file__)
-        config_path = os.path.join(package_dir, "config.ini")
+        package_dir = Path.home() / "SnakeScan"
+        config_path = package_dir / "config.ini"
         config["Settings"] = {"path_tcp": "", "path_udp": ""}
         with open(config_path, "w") as configfile:
             config.write(configfile)
@@ -665,6 +683,12 @@ if SnakeArgs().version:
     print("|Version|".center(60, "—"))
     print(f"SnakeScan_Build_{version}")
     print("".center(60, "—"))
+if SnakeArgs().homedir:
+    try:
+        home = Path.home() / "SnakeScan"
+        print(f"SnakeScan home directory: {home}")
+    except Exception as e:
+        print(e)
 
 if SnakeArgs().speed:
     if SnakeArgs().udp:

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

snakescan-1.8.6/PKG-INFO

@@ -1,141 +0,0 @@
-Metadata-Version: 2.4
-Name: SnakeScan
-Version: 1.8.6
-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
-
-<!--
-This documentation was created with the assistance of the GeekBot language model and Den*Ram
--->
-# 🐍 SnakeScan: Reliable Port Scanner in Python
-
-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 robust port scanning capabilities. From basic port checking to advanced, multi-threaded subnet analysis, SnakeScan provides the tools you need for effective network assessment.
-
-**Important Note:** *The following documentation describes potential features that are **partially implemented** in SnakeScan. Functionality related to custom port dictionaries is available, but has **narrowly specialized** implementations in its current state. Descriptions here are intended to demonstrate a more complete implementation and **may not fully match the library's current narrowly specialized capabilities**.*
-
-## ⚙️ Key features:
-
-*   **Flexible port specification:** Define target ports as individual values, ranges, or via pre-configured sets.
-
-*   **Multi-threaded architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
-
-*   **IP address information retrieval:** Obtain detailed information about target IP addresses, supporting both IPv4 and IPv6.
-
-*   **Real-time port monitoring:** Use the `Watcher` class to continuously monitor the status of important ports.
-
-*   **Concise command-line interface and API:** Easily integrate SnakeScan into workflows via command-line or programmatic access.
-
-*   **UDP port scanning:** Built-in support for scanning UDP ports.
-
-*   **Customizable port dictionaries:** Add your own port descriptions from JSON files and easily revert to the default set. *(Functionality is present, has narrowly specialized implementations. See details below).*
-
-## ⬇️ Installation:
-
-Install SnakeScan using pip:
-
-
-
-bash
-
-pip install SnakeScan
-
-## ⌨️ Command-line usage:
-
-### 💡 Attribute reference:
-
-*   **-p**: Specify target ports to scan (single port or range). Note: Range excludes the lower bound in the first entry. For example: To scan from port 80 to 443 specify 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**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
-
-*   **-sp**: Start scanning using the predefined common port set with `ProcessPoolExecutor`. Example: `snake -sp`
-
-*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
-
-*   **-gs**: Retrieve the SSL/TLS certificate from the specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
-
-*   **-t**: Enable multi-threading to improve scanning 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 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`
-
-*   **-d**: Specify the path to a JSON file containing TCP port definitions, and optionally a path to a second JSON file containing UDP port definitions. **Note:** When using this argument *for the first* time, the paths to the JSON files must be specified with each command execution, separated by a comma. After the first use, SnakeScan *may* remember these paths for subsequent scans. Functionality is present, has narrowly specialized implementations. See details below.
-
-    Example: `snake -d /путь/к/tcp_ports.json,/путь/к/udp_ports.json` (if you want to specify both TCP and UDP, if TCP only: `snake -d /путь/к/tcp_ports.json`)
-
-    **Subsequent Use**: After initial use, you can simply use the `-d` flag *without* file paths and SnakeScan *may* use previously defined JSON files. Functionality is present, has narrowly specialized implementations. See details below.
-
-    Example (after initial setup): `snake -d` (may use previously saved paths)
-
-    **JSON file format:** The JSON file must 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 the standard SnakeScan port definitions. This functionality relies on internal mechanisms that are still under development. Functionality is present, has narrowly specialized implementations. See details below. Example: `snake -dr`
-
-    **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful to verify which custom definitions are loaded. Example: `snake -ds`
-
-## 💻 Python Code Integration:
-
-### ⏱️ Watcher class: Real-time port status
-
-The `Watcher` class allows you to continuously monitor the specified port.
-
-python
-
-from SnakeScan import Watcher
-
-watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
-
-watcher.start()  # Start monitoring!
-
-#### `Watcher` Methods:
-
-*   `Watcher.start()` - Start the port monitoring process.
-
-*   `Watcher.stop()` - End the port monitoring process.
-
----
-
-**Last updated:** 1.8.6 (Minor bug fixes and style changes) *Functionality is present, has narrowly specialized implementations. See details below.*
-
-***
-
-**Details on the narrowly specialized functionality of custom port dictionaries:**
-
-*   The `-d` flag can load port definitions from a JSON file.
-*   The `-ds` flag can show where the current `-d` is pointed.
-*   The `-dr` flag attempts to revert to the default port definitions.

snakescan-1.8.6/README.md

@@ -1,128 +0,0 @@
-<!--
-This documentation was created with the assistance of the GeekBot language model and Den*Ram
--->
-# 🐍 SnakeScan: Reliable Port Scanner in Python
-
-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 robust port scanning capabilities. From basic port checking to advanced, multi-threaded subnet analysis, SnakeScan provides the tools you need for effective network assessment.
-
-**Important Note:** *The following documentation describes potential features that are **partially implemented** in SnakeScan. Functionality related to custom port dictionaries is available, but has **narrowly specialized** implementations in its current state. Descriptions here are intended to demonstrate a more complete implementation and **may not fully match the library's current narrowly specialized capabilities**.*
-
-## ⚙️ Key features:
-
-*   **Flexible port specification:** Define target ports as individual values, ranges, or via pre-configured sets.
-
-*   **Multi-threaded architecture:** Accelerate scanning operations with parallel processing for rapid analysis.
-
-*   **IP address information retrieval:** Obtain detailed information about target IP addresses, supporting both IPv4 and IPv6.
-
-*   **Real-time port monitoring:** Use the `Watcher` class to continuously monitor the status of important ports.
-
-*   **Concise command-line interface and API:** Easily integrate SnakeScan into workflows via command-line or programmatic access.
-
-*   **UDP port scanning:** Built-in support for scanning UDP ports.
-
-*   **Customizable port dictionaries:** Add your own port descriptions from JSON files and easily revert to the default set. *(Functionality is present, has narrowly specialized implementations. See details below).*
-
-## ⬇️ Installation:
-
-Install SnakeScan using pip:
-
-
-
-bash
-
-pip install SnakeScan
-
-## ⌨️ Command-line usage:
-
-### 💡 Attribute reference:
-
-*   **-p**: Specify target ports to scan (single port or range). Note: Range excludes the lower bound in the first entry. For example: To scan from port 80 to 443 specify 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**: Show the full list of available command-line attributes and their descriptions. Example: `snake -h` or `snake -help`
-
-*   **-sp**: Start scanning using the predefined common port set with `ProcessPoolExecutor`. Example: `snake -sp`
-
-*   **-v**: Display the current version of the SnakeScan library. Example: `snake -v`
-
-*   **-gs**: Retrieve the SSL/TLS certificate from the specified web server. Example: `snake www.google.com -gs` (Requires a valid hostname to avoid connection errors.)
-
-*   **-t**: Enable multi-threading to improve scanning 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 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`
-
-*   **-d**: Specify the path to a JSON file containing TCP port definitions, and optionally a path to a second JSON file containing UDP port definitions. **Note:** When using this argument *for the first* time, the paths to the JSON files must be specified with each command execution, separated by a comma. After the first use, SnakeScan *may* remember these paths for subsequent scans. Functionality is present, has narrowly specialized implementations. See details below.
-
-    Example: `snake -d /путь/к/tcp_ports.json,/путь/к/udp_ports.json` (if you want to specify both TCP and UDP, if TCP only: `snake -d /путь/к/tcp_ports.json`)
-
-    **Subsequent Use**: After initial use, you can simply use the `-d` flag *without* file paths and SnakeScan *may* use previously defined JSON files. Functionality is present, has narrowly specialized implementations. See details below.
-
-    Example (after initial setup): `snake -d` (may use previously saved paths)
-
-    **JSON file format:** The JSON file must 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 the standard SnakeScan port definitions. This functionality relies on internal mechanisms that are still under development. Functionality is present, has narrowly specialized implementations. See details below. Example: `snake -dr`
-
-    **-ds**: Display the paths to the currently used custom port dictionaries (TCP and UDP). This is useful to verify which custom definitions are loaded. Example: `snake -ds`
-
-## 💻 Python Code Integration:
-
-### ⏱️ Watcher class: Real-time port status
-
-The `Watcher` class allows you to continuously monitor the specified port.
-
-python
-
-from SnakeScan import Watcher
-
-watcher = Watcher("localhost", 53, 2)  # Host, port, check interval (in seconds)
-
-watcher.start()  # Start monitoring!
-
-#### `Watcher` Methods:
-
-*   `Watcher.start()` - Start the port monitoring process.
-
-*   `Watcher.stop()` - End the port monitoring process.
-
----
-
-**Last updated:** 1.8.6 (Minor bug fixes and style changes) *Functionality is present, has narrowly specialized implementations. See details below.*
-
-***
-
-**Details on the narrowly specialized functionality of custom port dictionaries:**
-
-*   The `-d` flag can load port definitions from a JSON file.
-*   The `-ds` flag can show where the current `-d` is pointed.
-*   The `-dr` flag attempts to revert to the default port definitions.

snakescan-1.8.6/SnakeScan/config.ini

@@ -1,3 +0,0 @@
-[Settings]
-path_tcp = ""
-path_udp = ""