Skip to main content

Public IP address checker.

Project description

Discovers your public IP address using pre-defined checkers (external services).

Installation

Install with latest stable version from PyPI

pip install pif

or install the latest stable version from source

pip install -e hg+https://bitbucket.org/barseghyanartur/pif@stable#egg=pif

or install into python path

python setup.py install

That’s all. See the Usage and examples section for more.

Usage and examples

Basic usage

Get public IP

from pif import get_public_ip
get_public_ip()

Get public IP using preferred checker

get_public_ip('whatismyip.com')

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):
        # TODO: Implement your logic

# Register the checker
registry.register(MyPublicIPChecker)

# Get public IP using the preferred checker
get_public_ip('mypublicipchecker')

Command line usage

It’s possible to get your public IP address from command line using the pif.commands.get_public_ip module.

optional arguments:
  -h, --help            show this help message and exit
  -c PREFERRED_CHECKER, --checker PREFERRED_CHECKER
                        `preferred_checker` value
  -v VERBOSE, --verbose VERBOSE
                    `verbose` value
Example:

(simple)

get-public-ip
Example:

(with preferred checked and verbose output)

get-public-ip -c whatismyip.com -v 1

License

GPL 2.0/LGPL 2.1

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>

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

pif-0.7.3.tar.gz (23.3 kB view hashes)

Uploaded Source

Built Distribution

pif-0.7.3-py2-none-any.whl (15.7 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page