https://github.com/m8sec/ipparser
Python support package to parse IP and host inputs from network based tooling
https://github.com/m8sec/ipparser
argument-parser enumeration ipv4 iteration python-module python3
Last synced: 3 months ago
JSON representation
Python support package to parse IP and host inputs from network based tooling
- Host: GitHub
- URL: https://github.com/m8sec/ipparser
- Owner: m8sec
- License: bsd-3-clause
- Created: 2019-04-03T18:19:00.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-21T00:32:53.000Z (over 1 year ago)
- Last Synced: 2025-03-22T06:41:39.713Z (3 months ago)
- Topics: argument-parser, enumeration, ipv4, iteration, python-module, python3
- Language: Python
- Homepage:
- Size: 14.6 KB
- Stars: 11
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IPParser
The IPParser Python library was created to simplify accepting IP addresses, DNS names, and target / host information in security or network based tooling.
User inputs are parsed to provide an iterable list for further action. If called with ```resolve=True```, ipparser will attempt to perform an "A" record lookup and return the first resolved address associated with the host.
#### Inputs:
IPParser currently accepts the following user inputs:
* Single IP (192.168.1.10)
* IP ranges (192.168.1.1-55)
* Multiple IP's (192.168.1.3,192.168.1.7,m8sec.dev)
* CIDR Ranges /8-/32 (192.168.1.0/24)
* URL's (https://m8sec.dev)
* IP:Port (192.168.1.1:8080)
* DNS Names (m8sec.dev)
* TXT files (Containing any of the items listed)
* Nmap XML Reports
* Read from STDIN
## Install
```bash
pip3 install ipparser
```
OR
```bash
git clone https://github.com/m8sec/ipparser
cd ipparser
python3 setup.py install
```
## (Primary) Usage:
The IPParser function can be called with the following arguments (shown with their default values):
* ```open_ports=False``` - Return IP:Port notation for all open ports found (Nmap XML only)
* ```exit_on_error=True``` - Exit on error while parsing user input.
* ```resolve=False``` - Resolve any DNS names identified, to IPv4 addresses, and append to output.
* ```ns=[]``` - Define name servers for DNS lookups.
## Examples
#### Standard Usage
```python
>>> from ipparser import ipparser
>>> ipparser('192.168.1.3-5')
['192.168.1.3', '192.168.1.4', '192.168.1.5']
>>> ipparser('yahoo.com',resolve=True)
['74.6.143.26']
>>> ipparser('192.168.1.1,yahoo.com')
['192.168.1.1', 'yahoo.com']
```
#### Argparse Integration - Required Positional Argument:
```python
from ipparser import ipparser
from argparse import ArgumentParser
args = ArgumentParser(description='ipparser integration with argparse')
args.add_argument(dest='positional_host', nargs='+', type=lambda x: ipparser(x, resolve=False), help='Host Input')
args = args.parse_args()
```
```
Namespace(positional_host=[['192.168.1.1']])
```