https://github.com/python-smpplib/python-smpplib

SMPP library for Python
https://github.com/python-smpplib/python-smpplib

python2 python3 smpp smpp-client smpp-library smpp-protocol sms

Last synced: 2 days ago
JSON representation

SMPP library for Python

• Host: GitHub
• URL: https://github.com/python-smpplib/python-smpplib
• Owner: python-smpplib
• License: lgpl-3.0
• Created: 2013-04-15T05:27:14.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-03-25T07:11:26.000Z (6 months ago)
• Last Synced: 2024-09-29T16:21:49.199Z (4 days ago)
• Topics: python2, python3, smpp, smpp-client, smpp-library, smpp-protocol, sms
• Language: Python
• Homepage:
• Size: 193 KB
• Stars: 172
• Watchers: 16
• Forks: 138
• Open Issues: 31
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        
`python-smpplib`

================

[![Version](https://img.shields.io/pypi/v/smpplib.svg?style=flat)](https://pypi.org/project/smpplib/#history)

[![Python versions](https://img.shields.io/pypi/pyversions/smpplib.svg?style=flat)](https://pypi.org/project/smpplib/)

[![PyPI downloads](https://img.shields.io/pypi/dm/smpplib.svg?style=flat)](https://pypi.org/project/smpplib/#files)

![License](https://img.shields.io/pypi/l/smpplib.svg?style=flat)

[![CircleCI](https://circleci.com/gh/python-smpplib/python-smpplib.svg?style=svg)](https://circleci.com/gh/python-smpplib/python-smpplib)

SMPP library for Python. Forked from [Google Code](https://code.google.com/p/smpplib/).

Example:

```python

import logging

import sys

import smpplib.gsm

import smpplib.client

import smpplib.consts

# if you want to know what's happening

logging.basicConfig(level='DEBUG')

# Two parts, UCS2, SMS with UDH

parts, encoding_flag, msg_type_flag = smpplib.gsm.make_parts(u'Привет мир!\n'*10)

client = smpplib.client.Client('example.com', SOMEPORTNUMBER, allow_unknown_opt_params=True)

# Print when obtain message_id

client.set_message_sent_handler(

    lambda pdu: sys.stdout.write('sent {} {}\n'.format(pdu.sequence, pdu.message_id)))

client.set_message_received_handler(

    lambda pdu: sys.stdout.write('delivered {}\n'.format(pdu.receipted_message_id)))

client.connect()

client.bind_transceiver(system_id='login', password='secret')

for part in parts:

    pdu = client.send_message(

        source_addr_ton=smpplib.consts.SMPP_TON_INTL,

        #source_addr_npi=smpplib.consts.SMPP_NPI_ISDN,

        # Make sure it is a byte string, not unicode:

        source_addr='SENDERPHONENUM',

        dest_addr_ton=smpplib.consts.SMPP_TON_INTL,

        #dest_addr_npi=smpplib.consts.SMPP_NPI_ISDN,

        # Make sure thease two params are byte strings, not unicode:

        destination_addr='PHONENUMBER',

        short_message=part,

        data_coding=encoding_flag,

        esm_class=msg_type_flag,

        registered_delivery=True,

    )

    print(pdu.sequence)

    

# Enters a loop, waiting for incoming PDUs

client.listen()

```

You also may want to listen in a thread:

```python

from threading import Thread

t = Thread(target=client.listen)

t.start()

```

**Note:** When listening, the client will automatically send an `enquire_link` command when the socket timeouts. You may override that behavior by passing `auto_send_enquire_link=False` as an argument to `listen()`. In that case, `socket.timeout` exceptions will bubble up.

The client supports setting a custom generator that produces sequence numbers for the PDU packages. Per default a simple in memory generator is used which in conclusion is reset on (re)instantiation of the client, e.g. by an application restart. If you want to keep the sequence number to be persisted across restarts you can implement your own storage backed generator.

Example:

```python

import smpplib.client

import mymodule

generator = mymodule.PersistentSequenceGenerator()

client = smpplib.client.Client('example.com', SOMEPORTNUMBER, sequence_generator=generator)

...

```