Metadata-Version: 2.1
Name: nimbasms
Version: 1.0.2
Summary: Python Client Nimba SMS API
Home-page: https://github.com/nimbasms/nimbasms-python
Author: Nimba SMS
Author-email: open-source@nimbasms.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# nimbasms-python
A Python module for communicating with Nimba SMS API.

## Installation
```sh
pip install nimbasms
```

## Usage
```python
import logging
from nimbasms import Client

ACCOUNT_SID = 'XXXX'
AUTH_TOKEN = 'XXXX'
client = Client(ACCOUNT_SID, AUTH_TOKEN)
logging.basicConfig()
logging.basicConfig(filename='./log.txt') # or loging in file
client.http_client.logger.setLevel(logging.INFO)

# Get your account balance
response = client.accounts.get()
if response.ok:
    my_account = response.data
    print('My Account balance : {}'.format(my_account['balance']))


# Get groups
response = client.groups.list()
if response.ok:
    all_groups = response.data
    print('There are {} groupes'.format(len(all_messages)))


# Get Sendernames
response = client.sendernames.list()
if response.ok:
    all_sendernames = response.data
    for item in all_sendernames:
        print(item)


# Get Contact
response = client.contacts.list()
if response.ok:
    all_contacts = response.data
    for item in all_contacts:
        print(item)


# Create Contact
# This contact will be added to the default contact list
response = client.contacts.create(numero='224XXXXXXXXX')
if response.ok:
    contact = response.data
# Create with groups and name - name and groups are optional.
response = client.contacts.create(numero='224XXXXXXXXX', name='Foo', groups=['API', 'Facebook Client'])
if response.ok:
    contact = response.data


# Get All messages
response = client.messages.list()
if response.ok:
    all_messages = response.data
    print('There are {} messages in your account.'.format(len(all_messages)))

# Get only last 10 messages
response = client.messages.list(limit=10)
if response.ok:
    some_messages = some_messages.data
    print('Here are the last 10 messages in your account:')
    for m in some_messages:
        print(m)

# send message...
print('Sending a message...')
response = client.messages.create(to=['XXXX'],
            sender_name='YYYY', message='Hi Nimba!')
if response.ok:
    print('message response : {}'.format(response.data))


# Retrieve message
response = client.messages.retrieve(messageid='XXXXXXXXXXXXXXXXXXXXX')
if response.ok:
    print("Message retrieve : {}".format(response.data))
```

## Credit
Nimba SMS
