This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

NyarukaSMS

NyarumaSMS aims to provide a quick start for a basic python based SMS app using the tools Nyaruka uses to build its systems. This includes setting up rapidsms, rapidsms-httprouter, smartmin and our parsing and localization libraries.

Getting Started

To get started, follow these steps:

% virtualenv env
% source env/bin/activate
% pip install nsms
% start-nsms [project-name]
% pip install -r pip-requires.txt
% cd [project-name]
% python manage.py syncdb
% python manage.py migrate
% python manage.py runserver

Sample Application

NSMS comes with a simple SMS application to track the mileage on vehicles. The SMS format for the application is as follows.

Registering Cars

Each user of the system much register the car they are using, they do so by sending:

car [license plate]

This register a car to the phone. From now on all mileage reports will be associated with the car with the passed in license plate. The license plate must be 8 characters.

Adding Mileage Reports

Once a user has registered their car, they can report mileage by sending the message:

miles [mileage (integer)]

This records a new mileage report for the car associated with this connection. If the connetion has not registered a car then this will be an error.

Best Practices

This application aims to demonstrate the following best practices:

  • Comprehensive unit coverage. We aim for 100% unit test coverage of our apps, and so should you. This app shows you how easily that can be done
  • DRY. We use Smartmin to allow us to add a lot of functionality without adding much code
  • Language Templates. We let our customers edit the translations for all our messages through a web UI, including using standard Django templates for formatting.
  • Tolerant Parsing. Though still a work in progress, our rapidsms_parser module provides an easy way to programmatically parse SMS messages and give good error messaging in the process.
  • User Management. We provide our customers with basic user management, using groups and SmartMin permissions to easily manage these.
Release History

Release History

1.0.4

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
nsms-1.0.4.tar.gz (17.2 kB) Copy SHA256 Checksum SHA256 Source Mar 21, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting