Django-twilio

General Release notes
- major support for twilio 6.x
- compatibility for django 1.8-2.0.

Community Contributions
- boardman for extra tests to support django 1.10.6
- wbt for getting the bones of the project able to work with twilio 6.x
- km-pg for increasing our support for integrating against twilio 6.x
- rdegges for keeping the project going despite not maintaining full time (and opening the floor to new maintainers)

Backwards incompatibilities
- For twilio 5.x, please see the 0.8 version.
- We have dropped support for python2.6, because we now support django 1.8+, which also does not support python2.6.

Release 0.9.0a1 intends to fully support general usage of twilio 6.x and django 2.0.

This release does still support django version 1.8+, and also python2.7 and the respective versions of python3, according to the django version FAQ.

Although this is a pre-release, we encourage the community to integrate this version into their system. As always, please (re-)open any issues or put up any PRs that may help further the release and the project.

This alpha build is not intended to be long-running; it needs some tests out in the wild before we can officially unwrap it.

About

Version 0.8 brings along a new feature - `decompose`, that will help Django developers to use the POST parameters sent to your Twilio applications.

Changes
- New `decompose` feature in django_twilio.requests

Example usage:


from django_twilio.request import decompose
from django_twilio.decorators import twilio_view

twilio_view
def my_view(request):
Generate a new TwilioRequest object:
twilio_request = decompose(request)


See the POST parameters as attributes on the new class:
twilio_request.to
>>> '+44123456789'

Discover the type of Twilio request:
if twilio_request.type is 'message'
return message_view(request)


See more about the decompose feature in the [documentation](http://django-twilio.readthedocs.org/en/latest/requests.html)

Upgrading

Django-twilio can be upgraded to 0.8 with pip:


pip install --upgrade django_twilio


No migrations are required in this release.

About

This version brings MMS webhook support to Django-twilio, adds a new view and adds deprecation warnings to an older view.

Changes
- MMS support

This adds a new default view, `django_twilio.views.message`, which will replace `django.views.sms`, and adds [MMS support](https://www.twilio.com/docs/api/rest/sending-messages#post-parameters-required) to the view using a new `media` parameter.

An example MMS message can be sent using the [normal REST API found in the Twilio-python library here](https://twilio-python.readthedocs.org/en/latest/usage/messages.html#sending-a-picture-message), but you can now reply with an MMS message in Django-twilio like so:


urls.py
urlpatterns = patterns('',
...
url(r'^sms/$', 'django_twilio.views.message', {
'message': 'Oh my glob, amazing!',
'media': 'http://i.imgur.com/UMlp0iK.jpg'
}),
...
)


Upgrading

Upgrading is nice and simple with pip:


pip install --upgrade django_twilio

About

This fix makes some small changes to how the decorator works. There should be no need to change or modify any existing code.

Changes
- Removal of the optional `methods` parameter as only HTTP POST and GET requests are allowed by the Twilio service, so there is redundancy in the option to use other methods.
- Removed the optional `blacklist` parameter as this was ambiguous: the parameter should have been named `check_for_potential_blacklisted_caller` or similar. On further investigation, a setting in Django-Twilio called [`DJANGO_TWILIO_BLACKLIST_CHECK`][1] determined the exact same thing. By default, the caller is always checked. As this is good practice and there was already a manual way of deciding on blacklist checking, I believe we do not need it at this point.

Further to this, the decorator was absorbing the arguments _anyway_, so this change should not affect any current users, as they wouldn't be able to actually use the functionality beforehand!

Upgrading

Django-twilio can be easily upgraded with pip:


$ pip install --upgrade django-twilio

About

Version 0.7 brings Python 3 support to django-twilio

Changes
- Django-twilio now supports Python 3! This is due to a gigantic [pull request](https://github.com/rdegges/django-twilio/pull/58) from [Daniel Hawkins](https://github.com/hwkns). Thanks Daniel.
- Documentation grammar and spelling fixes.

Upgrading

Upgrade to django-twilio 0.7 with the following pip command:


$ pip install --upgrade django-twilio