e.cruz/Network-Connection-Tester
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Updated README.md file

Browse Source
This commit is contained in:
Emmanuel HC
2026-07-08 11:54:30 -05:00
parent 470c868c15
commit 2f42f32a02
2 changed files with 26 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@@ -1,5 +1,5 @@
# 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.
@@ -8,8 +8,24 @@ A high-performance CLI tool designed to monitor network devices in real-time usi
* `devices_example.csv`: Template file for targets input.
## How to Run
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:
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
1. Navigate to the folder where the `Network_Scanner.exe` and the CSV files are located.
2. Run the file
```bash
python src/cli.py devices_example.csv
python cli.py csv_file_name.csv
## How to Run from Terminal (Development)
1. Ensure you have Python installed and your virtual environment active.
2. Install the required dependencies:
```bash
pip install -r requirements.txt
3. Execute the tool by providing your target CSV file:
```Bash
python src/cli.py csv_file_name.csv

10
devices.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