Software

Python Asterisk
pbx_config_mgr
Improved cdr_mysql

Resources

Berlios Project Page
voip-info.org
Asterisk.org
Python.org

Mailing Lists

Developer Discussion
Subversion Commits

Asterisk & Python Links

PyAstre
PyST
ATAsterisk

Python Asterisk Bindings

Introduction

Are you a py-Asterisk user that would like to keep the project alive?

I am presently unable to work much on py-Asterisk much due to work and life pressures in general. However, I would very much like to see py-Asterisk continue to track the current state of Asterisk, and be useful to the community as a whole.

I have moved the project to Berlios in order to allow for easier participation from users and developers. Please contact the developer list if you would like access to this new project.

The Python Asterisk package (codenamed py-Asterisk) is an attempt to produce high quality, well documented Python bindings for the Asterisk Manager API.

The eventual goal of the package is to allow rich specification of the Asterisk configuration in Python rather than in the quirky, unstructured, undocumented mess that we call the Asterisk configuration files.

Working Functionality

• Python package implementing a manager client and event dispatcher.
• User-oriented command line interface to manager API.

Work In Progress

• Introductary documentation for developers.
• Asterisk module allowing dialplan configuration via the manager API (see my pbx_config_mgr page).
• Objects to represent the standard applications, for specification of dialplan configuration in a friendlier Python syntax.

Documentation

Very little hand-written documentation is available yet for the package or it's commands, however pydoc documentation for the HEAD revision can be found at the link below. So far, only the beginnings of a developer's guide are available. Although there is little content, it may help give you an overview of programming with py-Asterisk.

• Asterisk package documentation for py-Asterisk HEAD
• Developer's guide documentation from intro_docs branch

Aims

• Provide a Python 2.3/2.4 package implementing an Asterisk Manager API client (done).
• Provide command-line tools to ease day-to-day Asterisk management and debugging (done).

• Provide an objects for controlling and configuring Asterisk:

  • Provide a granular and intuitive event interface (done).
  • Provide all functionality encapsulated in flexible classes that may be mixed and reused easily (done).
  • Possibly provide rich data types for manipulation of Asterisk objects, for example 'some_channel.hangup()' (done).
• Extend the manager API to encapsulate functionality only accessible through the Asterisk console and configuration files (in progress).
• Provide an IAX2 implementation, allowing for voice data to be generated from within Python (protocol bridge, IvR, experimentation, custom apps).
• Provide an enhanced and updated AGI module, and possible provide an EAGI module.

If you have any ideas for this package, please contact me using the e-mail address found on the main page of this site.

Revision Control

Currently py-Asterisk does not exist in a stable packaged form. If you would like to play with what is currently on offer, please check out a copy of the Subversion repository using a command similar to the one shown below, or alternatively use a snapshot provided in the "Downloadables" section below.

• View repository using WebSVN

Downloadables