File: README.rst

package info (click to toggle)
python-smstrade 0.2.4-5
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 228 kB
  • ctags: 123
  • sloc: python: 748; makefile: 11
file content (83 lines) | stat: -rw-r--r-- 2,340 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
About smstrade
==============

Smstrade is a `Python <http://www.python.org/>`_ library that can be used to
send SMS via the service of `smstrade.eu <http://www.smstrade.eu>`_.

The http(s) API is documented at
http://www.smstrade.eu/pdf/SMS-Gateway_HTTP_API_v2_en.pdf.

Installation
------------

You can either install smstrade from the `Python Package Index`_ PyPI or from
the `Git repository`_.

To install from PyPI you may use `pip`_::

    pip install smstrade

To install from Git you need to clone the repository and run setup.py::

    git clone https://git.gitorious.org/python-smstrade/python-smstrade.git
    cd python-smstrade
    python setup.py develop

.. note:: Be aware that you need write access to you Python installation to
    perform the last step above. You may also use a `virtualenv`_ environment
    to run a sandboxed version of smstrade.

.. _Python Package Index: https://pypi.python.org/pypi/smstrade/
.. _Git Repository: https://gitorious.org/python-smstrade/python-smstrade
.. _pip: https://pypi.python.org/pypi/pip/
.. _virtualenv: https://pypi.python.org/pypi/virtualenv/

Usage
-----

Sending SMS
...........

You may either use the API for SMS sending::

    import smstrade

    api = smstrade.SMSTrade()
    api.key = 'yourkey'
    api.send_sms(['00491701234567'], 'Test message')

or do the same with the command line tool::

    smstrade_send --key yourkey 00491701234567 'Test message'

You get help for the command line tool by running::

    smstrade_send -h

.. note::

    You can place all the configuration values into an ini file. See
    examples/smstrade.ini for an example. Before you really send SMS messages
    you need to put ``debug = False`` in your smstrade.ini.

    The file smstrade.ini is searched in system dependent paths as well as in
    the current directory. The search path is printed when invoking
    :literal:`smstrade_send -h` together with the description of the
    ``--config`` parameter.

    The smstrade.ini file is shared with the smstrade_balance tool.

Getting the account balance
...........................

Use the API for getting your account balance::

    import smstrade

    api = smstrade.SMSTradeBalanceAPI()
    api.key = 'yourkey'
    balance = api.get_balance()

or do the same with the command line tool::

    smstrade_balance --key yourkey