Skip to main content

Python library for accessing the Internet in Peking University.

Project description


A library for accessing the Internet through Peking University's Internet service.


The recommended way is to use pip to install

pip3 install --user libpkuipgw


First, initialize an IPGWClientobject:

import libpkuipgw
cli = libpkuipgw.IPGWClient(username, password)

If you are on Windows or macOS, you'll need to manually provide your MAC address:

import libpkuipgw
cli = libpkuipgw.IPGWClient(username, password, MAC) # MAC is a string, formatted like 5C:CF:7F:08:11:17

This is because I haven't found a way of portably getting the device's MAC address.

To connect to the Internet, call cli.connect()

To disconnect this device, call cli.disconnect()

To disconnect device with specific IP, make the call like cli.disconnect("")

To disconnect all devices, call cli.disconnect_all()

To get all the connections available: cli.get_connections(). Returns a list:

[{'ip': '', 'location': '22楼', 'login_time': '2018-08-08T22:22:22+08'}, {'ip': '', 'location': '33楼', 'login_time': '2018-08-08T11:11:11+08'}]

The time format is ISO8601 complient.

Error Handling

Apart from get_connections, returns nothing when everything is all right. If an error occurs, an IPGWError would be raised.

Project details

Download files

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

Files for libpkuipgw, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size libpkuipgw-0.1.3-py3-none-any.whl (3.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size libpkuipgw-0.1.3.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page