pysipp is for people who hate SIPp

but (want to) use it for automated testing because it gets the job done...

What is it?

Python configuring and launching the infamous SIPp using an api inspired by requests

It definitely lets you

• Launch multi-UA scenarios (aka SIPp subprocesses) sanely
  • avoids nightmarish shell command concoctions from multiple terminals
  • allows for complex functional or end-to-end SIP testing
• Reuse your existing SIPp XML scripts
• Integrate nicely with pytest

It doesn't try to

• Auto-generate SIPp XML scripts like sippy_cup
  • we believe this is the wrong way to work around the problem of SIPp's shitty XML control language

Usage

Launching the default uac scenario is a short line:

import pysipp
pysipp.client(destaddr=('10.10.8.88', 5060))()

Manually running the default uac --calls--> uas scenario is also simple:

uas = pysipp.server(srcaddr=('10.10.8.88', 5060))
uac = pysipp.client(destaddr=uas.srcaddr)
# run server async
uas(block=False)  # returns a `pysipp.launch.PopenRunner` instance by default
uac()  # run client synchronously

For more complex multi-UA orchestrations we can use a pysipp.scenario. The scenario from above is the default agent configuration:

scen = pysipp.scenario()
scen()

Say you have a couple SIPp xml scrips and a device you're looking to test using them (eg. a B2BUA or SIP proxy). Assuming you've organized the scripts nicely in a directory like so:

test_scenario/
  uac.xml
  referer_uas.xml
  referee_uas.xml

If you've configured your DUT to listen for for SIP on 10.10.8.1:5060 and route traffic to the destination specified in the SIP TO: header and your local ip address is 10.10.8.8:

scen = pysipp.scenario(scendir='path/to/test_scenario/',
    proxyaddr=('10.10.8.1', 5060)
)

# setup local server sockets
for port, ua in enumerate(scen.servers.values(), 5080):
    ua.srcaddr = ('10.10.8.8', port)

# point client at first server
scen.clientdefaults.destaddr = scen.servers.values()[0].srcaddr

# run all agents in sequence starting with servers
scen()

If you've got multiple such scenario directories you can iterate over them:

for path, scen in pysipp.walk('path/to/scendirs/root/'):
    print("running scenario collected from {}".format(path))
    # ... steps from above ...
    scen()

To see the mapping of SIPp command line args to pysipp.agent.UserAgent attributes, take a look at pysipp.command.sipp_spec. This should give you an idea of what can be set on each agent.

Features

• (a)synchronous multi-scenario invocation
• fully plugin-able thanks to pluggy
• detailed console reporting

... more to come!

Dependencies

SIPp duh...Get the latest version on github

Install

from git

pip install git+git://github.com/SIPp/pysipp.git

Hopes and dreams

I'd love to see pysipp become a standard end-to-end unit testing tool for SIPp itself (particularly if paired with pytest).

Other thoughts are that someone might one day write actual Python bindings to the internals of SIPp such that a pure Python DSL can be used instead of the silly default xml SIP-flow mini-language. If/when that happens, pysipp can serve as a front end interface.

Advanced Usage

pysipp comes packed with some nifty features for customizing SIPp default command configuration and launching as well as detailed console reporting. There is even support for remote execution of SIPp over the network using rpyc

Enable detailed console reporting

pysipp.utils.log_to_stderr("DEBUG")

Applying default settings

For now see #4

More to come...

• writing plugins
• remote execution
• async mult-scenario load testing