GSM modem module for Python
python-gsmmodem is a module that allows easy control of a GSM modem attached to the system. It also includes a couple of useful commandline utilities for interacting with a GSM modem.
Its features include:
Bundled utilities:
There are two ways to install python-gsmmodem
:
Automatic installation
::
pip install python-gsmmodem
`pip <http://www.pip-installer.org>`_ will automatically download and install
all dependencies, as required. You can also utilise ``easy_install`` in the
same manner as using ``pip`` above.
If you are utilising ``python-gsmmodem`` as part of another project,
add it to your ``install_requires`` section of your ``setup.py`` file and
upon your project's installation, it will be pulled in automatically.
Manual installation
Download and extract the python-gsmmodem
archive from PyPI <https://pypi.python.org/pypi/python-gsmmodem>
for the current release
version, or clone from GitHub <https://github.com/faucamp/python-gsmmodem>
.
Next, do this::
python setup.py install
Note that python-gsmmodem
relies on pyserial
for serial communications:
http://pyserial.sourceforge.net
.. |Build Status| image:: https://travis-ci.org/faucamp/python-gsmmodem.png?branch=master .. _Build Status: https://travis-ci.org/faucamp/python-gsmmodem
.. |Coverage Status| image:: https://coveralls.io/repos/faucamp/python-gsmmodem/badge.png?branch=master .. _Coverage Status: https://coveralls.io/r/faucamp/python-gsmmodem
|Build Status| |Coverage Status|
To run all unit tests, do::
python setup.py test
Unit test code coverage information may be generated by using coverage <https://pypi.python.org/pypi/coverage/>
_. You can execute it directly from
setup.py by doing::
python setup.py coverage
This will run all unit tests and report on code coverage statistics.
This package contains Sphinx <http://sphinx-doc.org>
_-based documentation.
To manually build or test the documentation locally, do the following::
git clone https://github.com/faucamp/python-gsmmodem.git cd python-gsmmodem pip install .[doc] cd doc make html
For true isolation, you may wish to run the above commands within a
virtualenv <http://www.virtualenv.org/>
_, which will help you manage
this development installation.
Copyright (C) 2013 Francois Aucamp
See AUTHORS for all authors and contact information.
License: GNU Lesser General Public License, version 3 or later; see COPYING included in this archive for details.