A dead simple, cross-platform Python library to connect to wireless networks.
Project description
[](https://travis-ci.org/joshvillbrandt/wireless) [](https://readthedocs.org/projects/wireless/?badge=latest)
wireless
A dead simple, cross-platform Python library to connect to wireless networks.
## Description
This library can control a computer’s wireless adapter to connect to a network. Environments currently supported include:
Mac OS 10.10
Ubuntu 12.04
## Setup
`bash sudo pip install wireless `
To use the nmcli on Ubuntu, one must have the right permissions in place. A few options are listed [here](https://wiki.archlinux.org/index.php/NetworkManager#Set_up_PolicyKit_permissions).
## Usage
A typical usage looks like this:
`python from wireless import Wireless wireless = Wireless() wireless.connect(ssid='ssid', password='password') `
## API
Wireless() - initialize the wifi driver
connect(ssid, password) - attempts to connect to a network and returns True on success
current() - returns the name of the current network or None otherwise
## Change History
This project uses [semantic versioning](http://semver.org/).
### v0.1.0 - 2014/11/22
Initial release
## Contributions
Pull requests to the develop branch are welcomed!
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
](https://travis-ci.org/joshvillbrandt/wireless){kind=link}