Obelus: Asterisk’s best friend

Overview

Obelus is a MIT-licensed Python library providing support for communication with the Asterisk telephony server. It supports the Asterisk Manager Interface (AMI) and the Asterisk Gateway Interface (AGI).

Quick links

• Project page: https://pypi.python.org/pypi/obelus/
• Source code, issue tracker: https://bitbucket.org/optiflowsrd/obelus
• Documentation (incomplete): https://obelus.readthedocs.org

Features

• Python 2 and Python 3 support.
• AMI, FastAGI and Async AGI support.
• Event-driven API friendly towards non-blocking (“async”) network programming styles.
• PEP 3156-style protocol implementations.
• Framework-agnostic.
• Adapters for the Tornado, Twisted, Tulip network programming frameworks.
• Unit-tested.

Limitations

• The API is currently low-level: it abstracts away protocol syntax and communication sequences, but doesn’t try to expose Asterisk concepts in a particular way.

Requirements

• Python 2.7, 3.2 or later.

Optional requirements

• Tornado, Twisted or Tulip, if you want to use one of the corresponding adapters.

Documentation

• User’s Guide
  • Philosophy
    • Bytes and strings
    • Futures, promises... handlers
    • Protocols and transports
    • Writing an adapter
  • Asterisk Management Interface
    • Making calls
  • Asterisk Gateway Interface
• API documentation
  • AGIProtocol
  • AMIProtocol
  • AsyncAGIExecutor
  • CallManager and Call
  • Handler
  • TornadoAdapter
  • TwistedAdapter

Indices and tables

• Index
• Module Index
• Search Page