ip-fetcher 0.3.3

A Python library to fetch public and private IP addresses.

IP Fetcher

ip_fetcher is a Python library for retrieving public and private IP addresses, checking IP types, and detecting proxies or VPNs. It also provides a command-line interface (CLI) for ease of use.

Features

• Fetches Public IP Address: Retrieves the public IP address of the user.
• Retrieves Private IP Address: Retrieves the private IP address of the user.
• Checks IP Type: Determines if a given IP address is IPv4 or IPv6.
• Detects Proxy or VPN: Checks if a given IP address is associated with a known proxy or VPN.
• Command-Line Interface: Provides a CLI for quick access to the library's functionalities.

Installation

To install the package, use:

pip install ip_fetcher

Changelog

0.3.3 (2024-09-15)

• Updated setup.py Requirements: Changed Python version requirement to >=3.9.7.
• Improved CLI: Enhanced error handling and command functionality; fixed issues from versions 0.3.2 and 0.3.2.9.
• Created Changelog Section: Added a changelog.

Usage

Here are some examples of how to use the ip_fetcher library:

Fetching the Public IP

To get your public IP address:

from ip_fetcher import get_public_ip

public_ip = get_public_ip()
print(f"Public IP: {public_ip}")

Fetching the Private IP

To get your private IP address:

from ip_fetcher import get_private_ip

private_ip = get_private_ip()
print(f"Private IP: {private_ip}")

Checking IP Type

To check if an IP address is IPv4 or IPv6:

from ip_fetcher import is_ipv4, is_ipv6

ip_address = "192.168.1.1"

if is_ipv4(ip_address):
    print(f"{ip_address} is an IPv4 address.")
elif is_ipv6(ip_address):
    print(f"{ip_address} is an IPv6 address.")
else:
    print(f"{ip_address} is not a valid IP address.")

Checking for Proxy or VPN

To check if an IP address is associated with a proxy or VPN:

from ip_fetcher import check_ip_proxy_vpn

ip_address = "8.8.8.8"

if check_ip_proxy_vpn(ip_address):
    print(f"{ip_address} is associated with a proxy or VPN.")
else:
    print(f"{ip_address} is not associated with a proxy or VPN.")

Command-Line Interface (CLI)

After installing the package, you can use the command-line interface to access the library's functionalities directly from the terminal.

Fetch Public IP

ip-fetcher --public

Fetch Private IP

ip-fetcher --private

Fetch Both Public and Private IPs

ip-fetcher --public --private