netcheck-osint 0.1.0__tar.gz

netcheck_osint-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dhruv Rathod
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

netcheck_osint-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include requirements.txt
+include README.md
+include LICENSE
+recursive-include config *.json

netcheck_osint-0.1.0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: netcheck-osint
+Version: 0.1.0
+Summary: A high-performance, asynchronous digital identity validation and network endpoint auditing tool.
+Author: Dhruv Rathod
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp==3.11.11
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: colorama==0.4.6
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# NetCheck-CLI
+
+A high-performance, asynchronous digital identity validation and network endpoint auditing tool engineered in Python. 
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Architecture](https://img.shields.io/badge/architecture-AsyncIO--EventLoop-orange.svg)](https://docs.python.org/3/library/asyncio.html)
+
+## 📋 Description
+
+**NetCheck-CLI** is a modular command-line utility designed for Security Engineers, Penetration Testers, and Site Reliability Engineers (SREs). It optimizes the discovery and auditing of digital footprints across enterprise systems, developer registries, and cloud infrastructure. 
+
+Traditional footprinting and status-checking tools execute requests sequentially, spending significant CPU idle time waiting for network I/O operations to resolve. **NetCheck-CLI** solves this bottleneck by utilizing Python's `asyncio` framework and `aiohttp` client engine to achieve non-blocking concurrency over a single-threaded architecture. This cuts execution windows down from minutes to seconds under scale.
+
+---
+
+## 🛠️ Core Features
+
+* **Asynchronous Concurrency:** Leverages a single-threaded Event Loop to manage hundreds of parallel network requests efficiently, eliminating thread context-switching overhead.
+* **Persistent Connection Pooling:** Instantiates a unified `aiohttp.ClientSession` connection pool, preserving TCP sockets and mitigating the overhead of repeated TCP 3-way handshakes and TLS negotiations.
+* **Strict Separation of Concerns (SoC):** Decouples target signature definitions entirely from execution logic using an external JSON configuration layer for seamless, zero-code target expanding.
+* **Resilient Fault Isolation:** Encapsulates network exception handlers directly within individual execution workers, preventing localized connection drops or timeouts from halting the global queue.
+* **Structured Telemetry Logs:** Generates highly deterministic, machine-readable JSON reports mapping aggregate performance statistics alongside detailed response criteria for downstream SIEM integration.
+* **Cross-Platform UX:** Styled with cross-platform terminal auto-reset escape codes using `colorama` for unified formatting on both Windows PowerShell and Linux terminals.
+
+---
+
+## 📐 Architectural Design
+
+```
+[CLI Flags: --target / --output]
+               │
+               ▼
+ [Parse JSON Target Registry]
+               │
+               ▼
+  [Async Event Loop Initiated]
+               │
+ ┌─────────────┼─────────────┐
+ ▼             ▼             ▼
+[Worker Task] [Worker Task] [Worker Task]  <-- Managed concurrently by Event Loop
+│             │             │
+└─────────────┼─────────────┘
+              ▼
+ [Data Aggregator Module]
+            │
+  ┌─────────┴─────────┐
+  ▼                   ▼
+[Terminal UI Log]   [Structured JSON Export]
+```
+
+---
+
+## 🚀 Installation & Setup
+
+### Prerequisites
+* Python 3.8 or higher
+* Git
+
+### 1. Clone the Repository
+```bash
+git clone https://github.com/dhruvrathod68/NetCheck-CLI.git
+
+cd NetCheck-CLI
+```
+
+### 2. Environment Isolation & Package Setup
+
+#### On Windows (PowerShell):
+```powershell
+# Initialize virtual environment
+python -m venv venv
+
+# Activate virtual environment
+.\venv\Scripts\Activate.ps1
+
+# Install package in editable development mode
+pip install -e .
+```
+
+#### On Linux / Kali Linux (Bash):
+```bash
+# Initialize virtual environment
+python3 -m venv venv
+
+# Activate virtual environment
+source venv/bin/activate
+
+# Install package in editable development mode
+pip install -e .
+```
+
+---
+
+## 💻 Usage & Examples
+
+The tool evaluates targets by reading signatures from `config/endpoints.json` and injecting runtime target values into string placeholder paths dynamically. Once installed, invoke using `netcheckcli` (or the shortcut `netcheck`).
+
+### Basic Application Execution
+Run a validation check against the default endpoint registry and export logs to the default `results.json` matrix:
+
+```bash
+netcheckcli --target "developer_handle"
+```
+
+### Custom Document Report Redirection
+Target a specific system identifier and route the production JSON telemetry matrix directly to a custom file path:
+
+```bash
+netcheckcli --target "audit-target-handle" --output telemetry_report.json
+```
+
+### Extending Target Databases
+To add target networks without altering the source code, append entries directly to the database file at `config/endpoints.json`:
+
+```json
+{
+  "name": "Custom_Platform_Service",
+  "url": "https://api.example.com/users/{}",
+  "validation_type": "status_code",
+  "expected_value": 200
+}
+```
+
+---
+
+## 📂 Project Directory Structure
+
+```plaintext
+NetCheck-CLI/
+│
+├── config/
+│   └── endpoints.json       # Decoupled Target Data Layer
+├── main.py                  # Core Asynchronous Execution Loop & CLI Entrypoint
+├── requirements.txt         # Pinned Package Metadata Dependency List
+├── setup.py                 # Setuptools Package Configuration & Console Scripts
+├── LICENSE                  # MIT Operational License
+└── README.md                # Enterprise Documentation Module
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are highly valued for optimizing throughput and expansion. For sweeping architecture updates, please open an execution issue first to discuss structural modifications.
+
+1. Fork the Repository
+2. Instantiate a Feature Branch (`git checkout -b feature/Optimization`)
+3. Commit Changes (`git commit -m 'Optimized event loop chunk management'`)
+4. Push to the Branch (`git push origin feature/Optimization`)
+5. Open a Pull Request
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for further operational legal documentation.

netcheck_osint-0.1.0/README.md

@@ -0,0 +1,157 @@
+# NetCheck-CLI
+
+A high-performance, asynchronous digital identity validation and network endpoint auditing tool engineered in Python. 
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Architecture](https://img.shields.io/badge/architecture-AsyncIO--EventLoop-orange.svg)](https://docs.python.org/3/library/asyncio.html)
+
+## 📋 Description
+
+**NetCheck-CLI** is a modular command-line utility designed for Security Engineers, Penetration Testers, and Site Reliability Engineers (SREs). It optimizes the discovery and auditing of digital footprints across enterprise systems, developer registries, and cloud infrastructure. 
+
+Traditional footprinting and status-checking tools execute requests sequentially, spending significant CPU idle time waiting for network I/O operations to resolve. **NetCheck-CLI** solves this bottleneck by utilizing Python's `asyncio` framework and `aiohttp` client engine to achieve non-blocking concurrency over a single-threaded architecture. This cuts execution windows down from minutes to seconds under scale.
+
+---
+
+## 🛠️ Core Features
+
+* **Asynchronous Concurrency:** Leverages a single-threaded Event Loop to manage hundreds of parallel network requests efficiently, eliminating thread context-switching overhead.
+* **Persistent Connection Pooling:** Instantiates a unified `aiohttp.ClientSession` connection pool, preserving TCP sockets and mitigating the overhead of repeated TCP 3-way handshakes and TLS negotiations.
+* **Strict Separation of Concerns (SoC):** Decouples target signature definitions entirely from execution logic using an external JSON configuration layer for seamless, zero-code target expanding.
+* **Resilient Fault Isolation:** Encapsulates network exception handlers directly within individual execution workers, preventing localized connection drops or timeouts from halting the global queue.
+* **Structured Telemetry Logs:** Generates highly deterministic, machine-readable JSON reports mapping aggregate performance statistics alongside detailed response criteria for downstream SIEM integration.
+* **Cross-Platform UX:** Styled with cross-platform terminal auto-reset escape codes using `colorama` for unified formatting on both Windows PowerShell and Linux terminals.
+
+---
+
+## 📐 Architectural Design
+
+```
+[CLI Flags: --target / --output]
+               │
+               ▼
+ [Parse JSON Target Registry]
+               │
+               ▼
+  [Async Event Loop Initiated]
+               │
+ ┌─────────────┼─────────────┐
+ ▼             ▼             ▼
+[Worker Task] [Worker Task] [Worker Task]  <-- Managed concurrently by Event Loop
+│             │             │
+└─────────────┼─────────────┘
+              ▼
+ [Data Aggregator Module]
+            │
+  ┌─────────┴─────────┐
+  ▼                   ▼
+[Terminal UI Log]   [Structured JSON Export]
+```
+
+---
+
+## 🚀 Installation & Setup
+
+### Prerequisites
+* Python 3.8 or higher
+* Git
+
+### 1. Clone the Repository
+```bash
+git clone https://github.com/dhruvrathod68/NetCheck-CLI.git
+
+cd NetCheck-CLI
+```
+
+### 2. Environment Isolation & Package Setup
+
+#### On Windows (PowerShell):
+```powershell
+# Initialize virtual environment
+python -m venv venv
+
+# Activate virtual environment
+.\venv\Scripts\Activate.ps1
+
+# Install package in editable development mode
+pip install -e .
+```
+
+#### On Linux / Kali Linux (Bash):
+```bash
+# Initialize virtual environment
+python3 -m venv venv
+
+# Activate virtual environment
+source venv/bin/activate
+
+# Install package in editable development mode
+pip install -e .
+```
+
+---
+
+## 💻 Usage & Examples
+
+The tool evaluates targets by reading signatures from `config/endpoints.json` and injecting runtime target values into string placeholder paths dynamically. Once installed, invoke using `netcheckcli` (or the shortcut `netcheck`).
+
+### Basic Application Execution
+Run a validation check against the default endpoint registry and export logs to the default `results.json` matrix:
+
+```bash
+netcheckcli --target "developer_handle"
+```
+
+### Custom Document Report Redirection
+Target a specific system identifier and route the production JSON telemetry matrix directly to a custom file path:
+
+```bash
+netcheckcli --target "audit-target-handle" --output telemetry_report.json
+```
+
+### Extending Target Databases
+To add target networks without altering the source code, append entries directly to the database file at `config/endpoints.json`:
+
+```json
+{
+  "name": "Custom_Platform_Service",
+  "url": "https://api.example.com/users/{}",
+  "validation_type": "status_code",
+  "expected_value": 200
+}
+```
+
+---
+
+## 📂 Project Directory Structure
+
+```plaintext
+NetCheck-CLI/
+│
+├── config/
+│   └── endpoints.json       # Decoupled Target Data Layer
+├── main.py                  # Core Asynchronous Execution Loop & CLI Entrypoint
+├── requirements.txt         # Pinned Package Metadata Dependency List
+├── setup.py                 # Setuptools Package Configuration & Console Scripts
+├── LICENSE                  # MIT Operational License
+└── README.md                # Enterprise Documentation Module
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are highly valued for optimizing throughput and expansion. For sweeping architecture updates, please open an execution issue first to discuss structural modifications.
+
+1. Fork the Repository
+2. Instantiate a Feature Branch (`git checkout -b feature/Optimization`)
+3. Commit Changes (`git commit -m 'Optimized event loop chunk management'`)
+4. Push to the Branch (`git push origin feature/Optimization`)
+5. Open a Pull Request
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for further operational legal documentation.

netcheck_osint-0.1.0/config/endpoints.json

@@ -0,0 +1,76 @@
+{
+  "endpoints": [
+    {
+      "name": "GitHub",
+      "url": "https://github.com/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "DockerHub",
+      "url": "https://hub.docker.com/v2/users/{}/",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "GitLab",
+      "url": "https://gitlab.com/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "PyPI (Python Packages)",
+      "url": "https://pypi.org/user/{}/",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "NPM Registry",
+      "url": "https://www.npmjs.com/~{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Dev.to",
+      "url": "https://dev.to/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Hashnode",
+      "url": "https://hashnode.com/@{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Reddit",
+      "url": "https://www.reddit.com/user/{}/",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Vimeo",
+      "url": "https://vimeo.com/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Pinterest",
+      "url": "https://www.pinterest.com/{}/",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "BuyMeACoffee",
+      "url": "https://www.buymeacoffee.com/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    },
+    {
+      "name": "Bitbucket API",
+      "url": "https://api.bitbucket.org/2.0/users/{}",
+      "validation_type": "status_code",
+      "expected_value": 200
+    }
+  ]
+}

netcheck_osint-0.1.0/main.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""
+NetCheck-CLI: A high-performance, asynchronous digital identity validation 
+and network endpoint auditing utility.
+"""
+
+import asyncio
+import json
+import argparse
+import sys
+import os
+import aiohttp
+from typing import List, Dict, Any
+from colorama import Fore, Style, init
+
+# Initialize colorama for cross-platform auto-resetting terminal colors
+init(autoreset=True)
+
+def load_endpoints(filepath: str = "config/endpoints.json", target: str = None) -> List[Dict[str, Any]]:
+    """
+    Reads the configuration file, returns the list of target endpoints,
+    and dynamically formats placeholder URLs if a target value is provided.
+    """
+    try:
+        resolved_path = filepath
+        if not os.path.isabs(filepath) and not os.path.exists(filepath):
+            module_dir = os.path.dirname(os.path.abspath(__file__))
+            alt_path = os.path.join(module_dir, filepath)
+            if os.path.exists(alt_path):
+                resolved_path = alt_path
+
+        with open(resolved_path, "r", encoding="utf-8") as f:
+            data: Dict[str, Any] = json.load(f)
+            endpoints: List[Dict[str, Any]] = data.get("endpoints", [])
+            
+            if target:
+                for ep in endpoints:
+                    url: str = ep.get("url", "")
+                    if "{}" in url:
+                        ep["url"] = url.format(target)
+            return endpoints
+    except (FileNotFoundError, json.JSONDecodeError) as e:
+        print(f"{Fore.RED}[CONFIG ERROR] Failed to load configuration: {e}{Style.RESET_ALL}")
+        return []
+
+async def check_endpoint(session: aiohttp.ClientSession, endpoint_data: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Executes an explicit status check on a target endpoint using an active ClientSession.
+    Returns a structured dictionary matching the telemetry logging schema.
+    """
+    name: str = endpoint_data.get("name", "Unknown Service")
+    url: str = endpoint_data.get("url", "")
+    expected: int = endpoint_data.get("expected_value", 200)
+
+    record: Dict[str, Any] = {
+        "service_name": name,
+        "target_url": url,
+        "expected_value": expected,
+        "status_code": None,
+        "match_status": False
+    }
+
+    if not url:
+        print(f"{Fore.RED}[ERROR] Service '{name}' is missing a target URL.{Style.RESET_ALL}")
+        record["status_code"] = "MISSING_URL"
+        return record
+
+    timeout = aiohttp.ClientTimeout(total=5.0)
+
+    try:
+        async with session.get(url, timeout=timeout) as response:
+            status: int = response.status
+            matched: bool = (status == expected)
+            record["status_code"] = status
+            record["match_status"] = matched
+            if matched:
+                print(f"{Fore.GREEN}[PASS] {name} ({url}) | Expected: {expected} | Got: {status}{Style.RESET_ALL}")
+            else:
+                print(f"{Fore.RED}[FAIL] {name} ({url}) | Expected: {expected} | Got: {status}{Style.RESET_ALL}")
+    except asyncio.TimeoutError:
+        print(f"{Fore.RED}[TIMEOUT] {name} ({url}) | Expected: {expected} | Timeout of 5.0s exceeded{Style.RESET_ALL}")
+        record["status_code"] = "TIMEOUT"
+    except aiohttp.ClientError as e:
+        print(f"{Fore.RED}[ERROR] {name} ({url}) | Expected: {expected} | Connection/DNS Error: {e}{Style.RESET_ALL}")
+        record["status_code"] = "CLIENT_ERROR"
+        
+    return record
+
+def save_report(filepath: str, records: List[Dict[str, Any]]) -> None:
+    """
+    Writes the audit telemetry records to a structured JSON file on disk.
+    """
+    try:
+        report: Dict[str, Any] = {
+            "total_checks": len(records),
+            "successful_checks": sum(1 for r in records if r["match_status"]),
+            "failed_checks": sum(1 for r in records if not r["match_status"]),
+            "results": records
+        }
+        with open(filepath, "w", encoding="utf-8") as f:
+            json.dump(report, f, indent=4)
+        print(f"\n{Fore.GREEN}[REPORT] Uptime report successfully written to '{filepath}'.{Style.RESET_ALL}")
+    except IOError as e:
+        print(f"{Fore.RED}[REPORT ERROR] Failed to write report to '{filepath}': {e}{Style.RESET_ALL}")
+
+async def main() -> None:
+    """
+    Main asynchronous coordinator function. Handles argument parsing, session pooling,
+    and workflow scheduling.
+    """
+    parser = argparse.ArgumentParser(description="NetCheck-CLI: Concurrent endpoint status checks and monitoring.")
+    parser.add_argument("--target", type=str, help="The string identifier to dynamically inject into endpoints with '{}' placeholders.")
+    parser.add_argument("--output", type=str, default="results.json", help="File path to export JSON results (default: results.json).")
+    args = parser.parse_args()
+
+    endpoints: List[Dict[str, Any]] = load_endpoints(target=args.target)
+    if not endpoints:
+        print(f"{Fore.YELLOW}[WARN] No endpoints configured. Exiting...{Style.RESET_ALL}")
+        return
+
+    print(f"{Fore.CYAN}Starting NetCheck-CLI on {len(endpoints)} endpoints...{Style.RESET_ALL}")
+    if args.target:
+        print(f"{Fore.CYAN}Target identifier: '{args.target}'{Style.RESET_ALL}")
+    print()
+
+    async with aiohttp.ClientSession() as session:
+        tasks = [check_endpoint(session, endpoint) for endpoint in endpoints]
+        records: List[Dict[str, Any]] = await asyncio.gather(*tasks)
+
+    save_report(args.output, records)
+
+def cli() -> None:
+    """CLI entrypoint for console_scripts."""
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print(f"\n{Fore.YELLOW}Audit interrupted by user.{Style.RESET_ALL}")
+        sys.exit(0)
+
+if __name__ == "__main__":
+    cli()

netcheck_osint-0.1.0/netcheck_osint.egg-info/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: netcheck-osint
+Version: 0.1.0
+Summary: A high-performance, asynchronous digital identity validation and network endpoint auditing tool.
+Author: Dhruv Rathod
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp==3.11.11
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: colorama==0.4.6
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# NetCheck-CLI
+
+A high-performance, asynchronous digital identity validation and network endpoint auditing tool engineered in Python. 
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Architecture](https://img.shields.io/badge/architecture-AsyncIO--EventLoop-orange.svg)](https://docs.python.org/3/library/asyncio.html)
+
+## 📋 Description
+
+**NetCheck-CLI** is a modular command-line utility designed for Security Engineers, Penetration Testers, and Site Reliability Engineers (SREs). It optimizes the discovery and auditing of digital footprints across enterprise systems, developer registries, and cloud infrastructure. 
+
+Traditional footprinting and status-checking tools execute requests sequentially, spending significant CPU idle time waiting for network I/O operations to resolve. **NetCheck-CLI** solves this bottleneck by utilizing Python's `asyncio` framework and `aiohttp` client engine to achieve non-blocking concurrency over a single-threaded architecture. This cuts execution windows down from minutes to seconds under scale.
+
+---
+
+## 🛠️ Core Features
+
+* **Asynchronous Concurrency:** Leverages a single-threaded Event Loop to manage hundreds of parallel network requests efficiently, eliminating thread context-switching overhead.
+* **Persistent Connection Pooling:** Instantiates a unified `aiohttp.ClientSession` connection pool, preserving TCP sockets and mitigating the overhead of repeated TCP 3-way handshakes and TLS negotiations.
+* **Strict Separation of Concerns (SoC):** Decouples target signature definitions entirely from execution logic using an external JSON configuration layer for seamless, zero-code target expanding.
+* **Resilient Fault Isolation:** Encapsulates network exception handlers directly within individual execution workers, preventing localized connection drops or timeouts from halting the global queue.
+* **Structured Telemetry Logs:** Generates highly deterministic, machine-readable JSON reports mapping aggregate performance statistics alongside detailed response criteria for downstream SIEM integration.
+* **Cross-Platform UX:** Styled with cross-platform terminal auto-reset escape codes using `colorama` for unified formatting on both Windows PowerShell and Linux terminals.
+
+---
+
+## 📐 Architectural Design
+
+```
+[CLI Flags: --target / --output]
+               │
+               ▼
+ [Parse JSON Target Registry]
+               │
+               ▼
+  [Async Event Loop Initiated]
+               │
+ ┌─────────────┼─────────────┐
+ ▼             ▼             ▼
+[Worker Task] [Worker Task] [Worker Task]  <-- Managed concurrently by Event Loop
+│             │             │
+└─────────────┼─────────────┘
+              ▼
+ [Data Aggregator Module]
+            │
+  ┌─────────┴─────────┐
+  ▼                   ▼
+[Terminal UI Log]   [Structured JSON Export]
+```
+
+---
+
+## 🚀 Installation & Setup
+
+### Prerequisites
+* Python 3.8 or higher
+* Git
+
+### 1. Clone the Repository
+```bash
+git clone https://github.com/dhruvrathod68/NetCheck-CLI.git
+
+cd NetCheck-CLI
+```
+
+### 2. Environment Isolation & Package Setup
+
+#### On Windows (PowerShell):
+```powershell
+# Initialize virtual environment
+python -m venv venv
+
+# Activate virtual environment
+.\venv\Scripts\Activate.ps1
+
+# Install package in editable development mode
+pip install -e .
+```
+
+#### On Linux / Kali Linux (Bash):
+```bash
+# Initialize virtual environment
+python3 -m venv venv
+
+# Activate virtual environment
+source venv/bin/activate
+
+# Install package in editable development mode
+pip install -e .
+```
+
+---
+
+## 💻 Usage & Examples
+
+The tool evaluates targets by reading signatures from `config/endpoints.json` and injecting runtime target values into string placeholder paths dynamically. Once installed, invoke using `netcheckcli` (or the shortcut `netcheck`).
+
+### Basic Application Execution
+Run a validation check against the default endpoint registry and export logs to the default `results.json` matrix:
+
+```bash
+netcheckcli --target "developer_handle"
+```
+
+### Custom Document Report Redirection
+Target a specific system identifier and route the production JSON telemetry matrix directly to a custom file path:
+
+```bash
+netcheckcli --target "audit-target-handle" --output telemetry_report.json
+```
+
+### Extending Target Databases
+To add target networks without altering the source code, append entries directly to the database file at `config/endpoints.json`:
+
+```json
+{
+  "name": "Custom_Platform_Service",
+  "url": "https://api.example.com/users/{}",
+  "validation_type": "status_code",
+  "expected_value": 200
+}
+```
+
+---
+
+## 📂 Project Directory Structure
+
+```plaintext
+NetCheck-CLI/
+│
+├── config/
+│   └── endpoints.json       # Decoupled Target Data Layer
+├── main.py                  # Core Asynchronous Execution Loop & CLI Entrypoint
+├── requirements.txt         # Pinned Package Metadata Dependency List
+├── setup.py                 # Setuptools Package Configuration & Console Scripts
+├── LICENSE                  # MIT Operational License
+└── README.md                # Enterprise Documentation Module
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are highly valued for optimizing throughput and expansion. For sweeping architecture updates, please open an execution issue first to discuss structural modifications.
+
+1. Fork the Repository
+2. Instantiate a Feature Branch (`git checkout -b feature/Optimization`)
+3. Commit Changes (`git commit -m 'Optimized event loop chunk management'`)
+4. Push to the Branch (`git push origin feature/Optimization`)
+5. Open a Pull Request
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for further operational legal documentation.

netcheck_osint-0.1.0/netcheck_osint.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+main.py
+requirements.txt
+setup.py
+config/endpoints.json
+netcheck_osint.egg-info/PKG-INFO
+netcheck_osint.egg-info/SOURCES.txt
+netcheck_osint.egg-info/dependency_links.txt
+netcheck_osint.egg-info/entry_points.txt
+netcheck_osint.egg-info/requires.txt
+netcheck_osint.egg-info/top_level.txt

netcheck_osint-0.1.0/netcheck_osint.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

netcheck_osint-0.1.0/netcheck_osint.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+netcheck = main:cli
+netcheckcli = main:cli

netcheck_osint-0.1.0/netcheck_osint.egg-info/requires.txt

@@ -0,0 +1,3 @@
+aiohttp==3.11.11
+python-dotenv==1.0.1
+colorama==0.4.6

netcheck_osint-0.1.0/netcheck_osint.egg-info/top_level.txt

@@ -0,0 +1 @@
+main

netcheck_osint-0.1.0/requirements.txt

@@ -0,0 +1,3 @@
+aiohttp==3.11.11
+python-dotenv==1.0.1
+colorama==0.4.6

netcheck_osint-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

netcheck_osint-0.1.0/setup.py

@@ -0,0 +1,58 @@
+from setuptools import setup
+import os
+
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+
+readme_path = os.path.join(BASE_DIR, "README.md")
+with open(readme_path, "r", encoding="utf-8") as f:
+    long_description = f.read()
+
+req_path = os.path.join(BASE_DIR, "requirements.txt")
+if os.path.exists(req_path):
+    with open(req_path, "r", encoding="utf-8") as f:
+        install_requires = [
+            line.strip() for line in f if line.strip() and not line.startswith("#")
+        ]
+else:
+    install_requires = [
+        "aiohttp==3.11.11",
+        "python-dotenv==1.0.1",
+        "colorama==0.4.6",
+    ]
+
+setup(
+    name="netcheck-osint",
+    version="0.1.0",
+    description="A high-performance, asynchronous digital identity validation and network endpoint auditing tool.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="Dhruv Rathod",
+    py_modules=["main"],
+    package_data={"": ["config/*.json"]},
+    include_package_data=True,
+    install_requires=install_requires,
+    entry_points={
+        "console_scripts": [
+            "netcheck=main:cli",
+            "netcheckcli=main:cli",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Information Technology",
+        "Intended Audience :: System Administrators",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Security",
+        "Topic :: System :: Networking :: Monitoring",
+        "Environment :: Console",
+    ],
+    python_requires=">=3.8",
+)
+