Metadata-Version: 2.2
Name: pingsweeper
Version: 0.1.2
Summary: A script for pinging subnets.
Home-page: https://github.com/jzmack/pingsweep
Author: Jacob Mackin
Author-email: mackinjz412@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >3.6
Description-Content-Type: text/markdown
License-File: License
Requires-Dist: tqdm
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# PingSweeper

A Python script that runs pings to determine how many hosts are up on a specified subnet. This script will also run a DNS lookup to find host names if they are available.

## Installation

Script can be installed using `pip install pingsweeper`

### Requirements

- Python - https://www.python.org
> Note: the script will need to be in the PATH environment variable to work as demonstrated here

![Demo](docs/install_demo.gif)

## Usage

Running the script:
```sh
pingsweeper
```
To show available arguments:
```sh
pingsweeper -h
```
Example with all available arguments:
```sh
pingsweeper -s 192.168.1.0/24 -t 0.5 -c 3
```
 - `-s` â†’ Specifies the subnet in CIDR notation.
 - `-r` â†’ Prompt for a range instead of entire subnet.
 - `-t` â†’ Sets the timeout per ping (in seconds).
 - `-c` â†’ Specifies the number of packets to send per host.

Once the script completes, the console will print a summary including the number of hosts ping, hosts that responded, and the results of all the hosts that were UP. A text file with the results will be generated at `sweep_results/` and opened (assuming the system has a GUI).

## Upgrading

To upgrade to the latest version:
```shell
python -m pip install --upgrade pingsweeper
```
To install a specific version:
```shell
python pip install pingsweeper==0.1.1
```
## Possible issues

There have been cases where the following warning may be shown after installing the package which will not allow you to run `pingsweeper` as intended. If this is the case, then the file path highlighted will need added to the system PATH environment variable.

![img.png](docs/img.png)

## License

This project is licensed under the MIT License - see the LICENSE file for details.
