Package: wireless
# Warning: This project is currently unmaintained! Please reach out if you are interested in helping to maintain this project.[![Build Status](https://travis-ci.org/joshvillbrandt/wireless.svg?branch=master)](https://travis-ci.org/joshvillbrandt/wireless) [![Documentation Status](https://readthedocs.org/projects/wireless/badge/?version=latest)](http://wireless.readthedocs.org/en/latest/)# wirelessA dead simple, cross-platform Python library to connect to wireless networks.## DescriptionThis library can control a computer’s wireless adapter to connect to a network. Environments currently supported include (in order of preference):Network Manager | Operating Systems | Tested Adapters
— | — | —
nmcli | Ubuntu 12.04, 14.04 | Linksys AE3000, Intel Centrino 6250
wpa_supplicant | Ubuntu 12.04, 14.04 | Intel Centrino 6250
networksetup | Mac OS 10.10 | Macbook Pro## Setup`bash sudo pip install wireless `## UsageA typical usage looks like this:`python from wireless import Wireless wireless = Wireless()wireless.connect(ssid='ssid',password='password')`Note: To usenmclion Ubuntu 14.04, the right permissions must be in place. A few options are listed [here](https://wiki.archlinux.org/index.php/NetworkManager#Set_up_PolicyKit_permissions).Note: To usewpa_supplicant,network-manager(the backend fornmcli) must not be running. This is becausenetwork-managerruns an instance ofwpa_supplicantbehind the scenes which will conflict with thewpa_supplicantinstance that this library would create. If you have anetwork-manageron your machine but would prefer to usewpa_supplicant(not recommended), runsudo service network-manager stopbefore usingwireless.## APIWireless([interface])- initialize the wireless driverconnect(ssid, password)- attempts to connect to a network and returns True on successcurrent()- returns the name of the current network or None otherwiseinterfaces()- list the available interfacesinterface([interface])- get or set the current interfacepower([True||False])- get or set the power status of the adapterdriver()- return the name of driver being used for wireless control## Change HistoryThis project uses [semantic versioning](http://semver.org/).### v0.3.3 - 2019/06/27Fix version comparison for python3.5 ([pschmitt](https://github.com/pschmitt))Update iwconfig current() to handle Nickname field ([jminardi](https://github.com/jminardi))### v0.3.2 - 2016/03/06Added a few tests and fixed a py34 bug ([XayOn](https://github.com/XayOn))### v0.3.1 - 2015/04/24Added version check for nmcli ([Silarn](https://github.com/Silarn))### v0.3.0 - 2015/01/13Added support forwpa_supplicantAdded thedriver()method### v0.2.1 - 2014/12/01remove dependency onpandoc### v0.2.0 - 2014/11/25Added support for multiple network adapters withinterface()andinterfaces()methodsThecurrent()method actually asks the wireless driver for the current SSID instead of returning the name of the most recently connected networkAdded thepower()method### v0.1.1 - 2014/11/24Better documentation formatting for PyPI### v0.1.0 - 2014/11/22Initial release## ContributionsPull requests to thedevelopbranch are welcomed!## PublishingFirst, installpandocso that setup.py can auto-convert Markdown syntax into reStructuredText:`bash sudoapt-getinstall pandoc sudo pip install pypandoc `Then, following [this guide](http://peterdowns.com/posts/first-time-with-pypi.html), push the project to PyPI:`bash sudo python setup.py sdist upload-rpypi `