# Panoramisk. The Asterisk’s druid

Panoramisk is a library based on python’s AsyncIO to play with Asterisk’s manager.

It uses the TCP manager server to listen to events and send actions.

For basic usage, you have some examples in examples/ folder.

You can find some help on IRC: irc://irc.freenode.net/panoramisk (www)

Source code is available at https://github.com/gawel/panoramisk/

Check the full documentation

I’ve spent hours writing this software, with love. Please consider tiping if you like it:

BTC: 1PruQAwByDndFZ7vTeJhyWefAghaZx9RZg

ETH: 0xb6418036d8E06c60C4D91c17d72Df6e1e5b15CE6

LTC: LY6CdZcDbxnBX9GFBJ45TqVj8NykBBqsmT

# Installation

Install, upgrade and uninstall panoramisk with these commands:

    $ pip install panoramisk
    $ pip install --upgrade panoramisk
    $ pip uninstall panoramisk

# Detailed Documentation

- `panoramisk` - AMI
- `panoramisk.fast_agi` - Fast AGI
- `panoramisk.testing` - Writing tests

# Who use Panoramisk on production ?

For now, mainly Eyepea and ALLOcloud.

You shouldn’t know theses companies, however, Eyepea is a provider of several famous European companies and governments organizations. You can check their references on their website:

- http://www.eyepea.eu/customers

- http://www.eyepea.eu/company/news

Moreover, ALLOcloud is a cloud solution for SMEs, it handles several millions of calls by month.

If you also use Panoramisk on production, don’t hesitate to open a pull request to add your company’s name with some details.

# CHANGES

## 1.4 (2021-08-05)

- py38 support

- no longer use yield from syntaxe.

- Added custom options for connect method: run_forever, on_startup, on_shutdown, reconnect_timeout

- Make ping interval and ping delay more configurable. Callbacks on_login, on_connect and on_disconnect added for use in metrics

- Avoid double exception logging because log.exception() already logs the stacktrace

- Multiple FastAGI support improvement

## 1.3 (2018-09-21)

- py37 support

## 1.2 (2018-05-24)

- Fix KeyError problem in call_manager

- as_list is now default to none and is used first in Action.multi

- improve AMI version detection

## 1.1 (2016-12-29)

- We no longer loosing calls on reconnection

- End of support for python<3.4

- Better test coverage

## 1.0 (2015-08-19)

- Add FastAGI server, implemented with high-level AsyncIO API (Streams)

- Add events parameter for Manager, to disable AMI events reception (Useful for performance reasons)

- Finish AsyncAGI commands support (WIP)

## 0.6 (2014-11-16)

- Avoid failure when factory is not already set

## 0.5 (2014-11-16)

- AMI command results tracking fixed

- Return AMI command result with multiple events in a Future

- Return AsyncAGI command result in a Future

- Add several examples

- Internal refactoring

- Remove arawman support

- Remove external dependencies

- Add support for multiple responses from Actions (example: QueueStatus)

- Improved performance with Events pattern matching

- Add mocked test wrapper

- Add coroutine support for Events dispatching

- Invert event callback signature to create Manager methods to handle events

- Support of AMI commands

- Support of AsyncAGI commands (Not finished)

## 0.4 (2014-05-30)

- Compat with the latest trollius

## 0.3 (2014-01-10)

- Don’t send commands twice

## 0.2 (2014-01-09)

- Initial release

# Indices and tables

- Index

- Module Index

- Search Page