Compare commits

2 Commits
v1.0.0 ... main

Author SHA1 Message Date
Emmanuel HC
5db7477492 Readme file corrected for run .exe file from terminal 2026-07-08 11:59:38 -05:00
Emmanuel HC
2f42f32a02 Updated README.md file 2026-07-08 11:54:30 -05:00
2 changed files with 24 additions and 11 deletions

View File

@@ -1,15 +1,28 @@
# Network Connection Tester (v1.0.0)
Developed by Emmanuel Hernandez | Automation Engineering
Developed by Emmanuel Hernandez | Automation Specialist II
A high-performance CLI tool designed to monitor network devices in real-time using parallel processing (up to 30 workers). It verifies ICMP reachability (Ping) and TCP port status, exporting a historical log to a timestamped CSV on exit.
## Project Structure
* `src/cli.py`: Main execution script for the terminal interface.
* `devices_example.csv`: Template file for targets input.
## How to Run
1. Download the latest version from the **Releases** section.
2. Use `devices_example.csv` as a template to create a list of devices to be tested.
3. Using **File Explorer**, drag and drop your CSV file onto `Network_Scanner.exe` to execute the tool.
4. Once the tool opens, you will see a live table updating the status of your devices in real-time.
5. Press `Ctrl + C` to stop the execution and automatically generate the results report.
6. Press `Enter` to close the window.
## How to Run .exe from Terminal (PowerShell / CMD)
If you prefer to run the executable using command lines instead of dragging files:
1. Open PowerShell or CMD and navigate to the folder where `Network_Scanner.exe` and your CSV file are located.
2. Execute the `.exe` by passing your CSV file as an argument:
```powershell
.\Network_Scanner.exe your_devices_file.csv
## How to Run from Terminal (Development)
1. Ensure you have Python installed and your virtual environment active.
2. Install dependencies: `pip install -r requirements.txt`
3. Execute the tool providing your CSV file:
2. Install the required dependencies:
```bash
python src/cli.py devices_example.csv
pip install -r requirements.txt
3. Execute the tool by providing your target CSV file:
```Bash
python src/cli.py csv_file_name.csv

View File

@@ -1,5 +1,5 @@
name,enabled,hostname,port,reverseWordOrder,zeroBasedAddressing
Test,false,192.168.1.81,502,true,true
Test2,true,192.168.1.82,502,false,false
Test3,false,192.168.1.83,502,true,true
Test3r,false,192.168.1.84,502,true,true
name,hostname,port
Test1,192.168.1.81,502
Test2,192.168.1.82,502
Test3,192.168.1.83,502
Test4,192.168.1.84,502
1 name enabled hostname port reverseWordOrder zeroBasedAddressing
2 Test Test1 false 192.168.1.81 502 true true
3 Test2 true 192.168.1.82 502 false false
4 Test3 false 192.168.1.83 502 true true
5 Test3r Test4 false 192.168.1.84 502 true true