Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Simple library for controlling PPP connections with pppd.

Project description

Simple library for controlling PPP connections with pppd. Under the hood it uses the subprocess module to interact with pppd to create and disconnect PPP connections. Positional and keyword arguments are passed to the pppd command- line although there is protection for shell exploits.

This library has been production tested connecting daily to 280+ remote locations via dial-up PPP connection for over a year. I have simply packaged and cleaned up the module as some may find it useful.

Anyone wanting to do something similar in a Windows environment should probably take a look at win32ras.

Requirements

You will require pppd, the PPP daemon and PPP kernel modules.

Installation

To install simply:

pip install python-pppd

Alternatively, install from the repository:

git clone https://github.com/cour4g3/python-pppd cd python-pppd python setup.py install

Getting Started

You can connect to an existing configured PPP connection:

>>> from pppd import PPPConnection
>>> ppp = PPPConnection(call='work') # blocks until connected
>>> ppp.connected() # check if connected, raises error if connection error
True
>>> ppp.laddr # address of local host
'10.0.0.1'
>>> ppp.raddr # address of remote client
'10.0.0.2'

You can specify any positional or keyword arguments:

PPPConnection('/dev/ttyS0', connect='/usr/bin/chat -v -f /etc/chatscripts/A1')

Which is equivalent to the following:

sudo pppd /dev/ttyS0 connect “/usr/bin/chat -v -f /etc/chatscripts/A1”

Normally you require sudo to use pppd, if you don’t have it and have setup the pppd binary with setuid-root or are running as root you can use:

PPPConnection(sudo=False)

You can also specify an alternate paths to pppd or sudo if the libary cannot find them:

PPPConnection(sudo_path='/usr/local/bin/sudo', pppd_path='/usr/local/sbin/pppd')

License

Distributed under the MIT license.

Project details


Release history Release notifications

This version
History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
python-pppd-1.0.3.tar.gz (3.6 kB) Copy SHA256 hash SHA256 Source None Dec 21, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page