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) # 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. 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 ## Project Structure
* `src/cli.py`: Main execution script for the terminal interface. * `src/cli.py`: Main execution script for the terminal interface.
* `devices_example.csv`: Template file for targets input. * `devices_example.csv`: Template file for targets input.
## How to Run ## 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. 1. Ensure you have Python installed and your virtual environment active.
2. Install dependencies: `pip install -r requirements.txt` 2. Install the required dependencies:
3. Execute the tool providing your CSV file:
```bash ```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 name,hostname,port
Test,false,192.168.1.81,502,true,true Test1,192.168.1.81,502
Test2,true,192.168.1.82,502,false,false Test2,192.168.1.82,502
Test3,false,192.168.1.83,502,true,true Test3,192.168.1.83,502
Test3r,false,192.168.1.84,502,true,true 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