Version Python versions PyPI downloads License CircleCI
SMPP library for Python. Forked from Google Code.
Example:
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:
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:
import smpplib.client import mymodule generator = mymodule.PersistentSequenceGenerator() client = smpplib.client.Client('example.com', SOMEPORTNUMBER, sequence_generator=generator) ...