pif¶

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('v4.ident.me')

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 v4.ident.me -v 1

Testing¶

Simply type:

./runtests.py

or use tox:

tox

or use tox to check specific env:

tox -e py35

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>