No project description provided
Project description
ipmap is an easy-to-use ip geolocation and mapping tool written in Python
IPMap geolocates a given ip address/addresses from a file, then generates a leaflet map pin-pointing the location of each ip address on it (with the right argument).
Features
- Looks up ip address(es) and returns the associated information.
- Looks up an ip address(es) and returns the associated information then pin points the location of the ip address(es) on a generated leaflet.
- Opens Google Earth on the specified coordinates (format: latitude longitude).
- Generated maps are saved to the
maps
directory which is created on runtime if it does not exist. - Does not use external dependencies for the map, instead uses an already written html .
Installation
PyPI
IPMap can be installed from PyPI by running the folloing command in terminal/command prompt
pip install ipmap
GitHub
Or if you prefer to install it from source, you can run the following command
pip install git+https://github.com/rly0nheart/ipmap.git
Build from source
# install poetry
pip install poetry
# clone the project
git clone https://github.com/rly0nheart/ipmap
# move to the ipmap directory
cd ipmap
# build the wheel file
poetry build
# install the built wheel (Linux)
pip install dist/*.whl
# install built wheel (Windows)
pip install .\dist\generated-wheel-file-name.whl
Usage
To see the usage, you can simply run
ipmap --help
The output should look like the following
usage:
Geolocate IP Address(es) (with an interactive map)
--------------------------------------------------
ipmap map --ip <ip/file_containing_ip_addresses>
Open Google Earth on the given coordinates
--------------------------------------------
ipmap earth --coordinates <latitude> <longitude>
Lookup IP Address(es) (same as map but without an interactive map)
------------------------------------------------------------------
ipmap lookup --ip <ip/file_containing_ip_addresses>
modes:
map - creates an interactive map and pin points the locations of the specified ip address(es) on it.
earth - opens google earth on the specified coordinates
lookup - looks up the specified ip address(es)' information.
IPMap (IP Mapper) — by Richard Mwewa (https://about.me/rly0nheart)
positional arguments:
{earth,lookup,map} init mode
options:
-h, --help show this help message and exit
-i IP, --ip IP an ip address or a file containing ip addresses
-o OUTPUT, --output OUTPUT
map output name
-c COORDINATES COORDINATES, --coordinates COORDINATES COORDINATES
space separated latitude and longitude
-v, --version show program's version number and exit
A cross-platform easy-to-use ip geolocation & mapping tool.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ipmap-1.0.0.tar.gz
(8.5 kB
view hashes)
Built Distribution
ipmap-1.0.0-py3-none-any.whl
(10.8 kB
view hashes)