Source Code for Package mms

 1  #!/usr/bin/env python 
 2  # 
 3  # This library is free software, distributed under the terms of 
 4  # the GNU Lesser General Public License Version 2. 
 5  # See the COPYING file included in this archive 
 6  # 
 7  # Copyright (C) 2007 Francois Aucamp <faucamp@csir.co.za> 
 8  # 
 9  # The docstrings in this module contain epytext markup; API documentation 
10  # may be created by processing this file with epydoc: http://epydoc.sf.net 
11   
12  """ 
13  Python Multimedia Messaging Service (MMS) library 
14   
15  The C{mms} module provides several classes for the creation and manipulation of 
16  MMS messages (multimedia messages) used in mobile devices such as cellular 
17  telephones. 
18   
19  Multimedia Messaging Service (MMS) is a messaging service for the mobile 
20  environment standardized by the WAP Forum and 3GPP. To the end-user MMS is 
21  very similar to the text-based Short Message Service (SMS): it provides 
22  automatic immediate delivery for user-created content from device to device. 
23   
24  In addition to text, however, MMS messages can contain multimedia content such 
25  as still images, audio clips and video clips, which are binded together 
26  into a "mini presentation" (or slideshow) that controls for example, the order 
27  in which images are to appear on the screen, how long they will be displayed, 
28  when an audio clip should be played, etc. Furthermore, MMS messages do not have 
29  the 160-character limit of SMS messages. 
30   
31  An MMS message is a multimedia presentation in one entity; it is not a text 
32  file with attachments. 
33    
34  This library enables the creation of MMS messages with full support for 
35  presentation layout, and multimedia data parts such as JPEG, GIF, AMR, MIDI, 
36  3GP, etc. It also allows the decoding and unpacking of received MMS messages. 
37   
38  @version: 0.1 
39  @author: Francois Aucamp C{<faucamp@csir.co.za>} 
40  @license: GNU Lesser General Public License, version 2.1 
41  @note: References used in the code and this document: 
42      1. MMS Conformance Document version 2.0.0, 6 February 2002 
43      U{www.bogor.net/idkf/bio2/mobile-docs/mms_conformance_v2_0_0.pdf} 
44   
45      2. Forum Nokia, "How To Create MMS Services, Version 4.0" 
46      U{http://forum.nokia.com/info/sw.nokia.com/id/a57a4f20-b7f2-475b-b426-19eff18a5afb/How_To_Create_MMS_Services_v4_0_en2.pdf.html} 
47   
48      3. Wap Forum/Open Mobile ALliance, "WAP-206 MMS Client Transactions" 
49      U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-206-mmsctr-20020115-a.pdf} 
50   
51      4. Wap Forum/Open Mobile Alliance, "WAP-209 MMS Encapsulation Protocol" 
52      U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-209-mmsencapsulation-20020105-a.pdf} 
53   
54      5. Wap Forum/Open Mobile Alliance, "WAP-230 Wireless Session Protocol Specification" 
55      U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-230-wsp-20010705-a.pdf} 
56   
57      6. IANA: "Character Sets" 
58      U{http://www.iana.org/assignments/character-sets} 
59  """ 
60   
61  # Expose the high-level classes directly 
62  from message import MMSMessage, MMSMessagePage, DataPart 
63  # ...as well as the high-level decoder 
64  from mms_pdu import MMSDecoder 
65