Discovers your public IP address using pre-defined checkers (external services).
Install with latest stable version from PyPI
or install the latest stable version from source
or install into python path
That's all. See the Usage and examples section for more.
Usage and examples
Get public IP
from pif import get_public_ip get_public_ip()
Get public IP using preferred checker
List available checkers
from pif.utils import list_checkers list_checkers()
Registering a custom IP checker
pif ships with a number of pre-defined public IP checkers. But you may extend it by defining your own ones as follows.
from pif.base import BaseIPChecker, registry class MyPublicIPChecker(BaseIPChecker): uid = 'mypublicipchecker' # UID of the checker def get_public_ip(self): # Implement your logic registry.register(MyPublicIPChecker) # Register the checker get_public_ip('mypublicipchecker') # Get public IP using the preferred checker
Command line usage
It's possible to get your public IP address from command line using the pif.commands.get_public_ip module.
|Example:||(with preferred checked and verbose output)|
GPL 2.0/LGPL 2.1
For any issues contact me at the e-mail given in the Author section.