Python wrapper over sms.sluzba.cz HTTP API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
smssluzbacz_api
.gitignore
LICENSE
MANIFEST.in
README.rst
integration_test_lite.py
integration_test_post.py
setup.py
test.py

README.rst

smssluzbacz-api

smssluzba-api is API for sending SMS via sms.sluzba.cz HTTP service. It allows you to send SMS (short text messages) from python applications. In order to use this API you have to register to http://sms.sluzba.cz/ service. There is restriction on sms.sluzba.cz that will block your account after several invalid login attempts. Length of one SMS is restricted to 459 characters.

Note

There is known bug in authentication in post API making it unable to authenticate properly. sms.sluzba.cz service is working on resolving this issue.

Requirements

  • python 2.7+

Installation

Install via pip or copy this module into your project or into your PYTHON_PATH.

$ pip install smssluzbacz-api

Examples

Example 1

Using lite API

from smssluzbacz_api.lite import SmsGateApi

api = SmsGateApi('login', 'password', timeout=2, use_ssl=True)
api.send('123456789', 'my SMS message', use_post=True)

Example 2

Using post API

from smssluzbacz_api.post import SmsGateApi

api = SmsGateApi('login', 'password', timeout=2, use_ssl=True)
api.send('123456789', 'my SMS message')

Tests

Tested on environment

  • Xubuntu Linux 12.04.02 LTS precise 64-bit
  • python 2.7.3
  • python unittest
  • mock

Running tests

To run the unit tests, first install tests_require dependencies from setup.py, then run command:

$ python test.py
$ python setup.py test

Running integration tests for lite API

To run integration tests for lite API run command:

$ python integration_test_lite.py <login> <password> <tel_number>

To list all command line options run command:

$ python integration_test_lite.py --help

Running integration tests for post API

To run integration tests for post API run command:

$ python integration_test_post.py <login> <password> <tel_number>

To list all command line options run command:

$ python integration_test_post.py --help

Authors

Jozef Sevcik, CodeScale s.r.o.
char0n (Vladimir Gorej, CodeScale s.r.o.)

References