pypd - PagerDuty Python API Client

A client in Python for PagerDuty's v2 API.

Now available on PyPI https://pypi.python.org/pypi/pypd

How Do

Yes, how do. The ultimate question in quickstart.

Make sure that you have installed requirements with pip

pip install -r requirements.txt

Then get cracking

import pypd
pypd.api_key = "SOMESECRETAPIKEY"

# fetch some dataz
incidents = pypd.Incident.find(maximum=10)

# how do dataz?
ep = pypd.EscalationPolicy.find_one()
print ep['id']
print ep.get('name')
print ep.json  # not a string, a json-compat dict
print ep.__json__()  # a json encoded string, json encoder interface compat
print ep._data  # raw data, best not to access it this way!

# nice embedded property things
incident = pypd.Incident.find_one()
log_entries = incident.log_entries()

# find users
user = pypd.User.find_one(email="jdc@pagerduty.com")

# create an event
pypd.Event.create(data={
    'service_key': 'YOUR_INTEGRATION_KEY',
    'event_type': 'trigger',
    'description': 'this is a trigger event!',
    'contexts': [
          {
              'type': 'link',
              'href': 'http://acme.pagerduty.com',
              'text': 'View on PD',
          },
    ],
})

Notes

All models should be complete CR-D complete, with the missing update method. Soon to be fixed.

If you need some embedded properties that don't exist, take a look at LogEntry or Incident model classes.

There was some stagnation on the pull requests here. No longer! Thanks for being patient.

Tests

Make sure you have tox installed

pip install -r test_requirements.txt

# or

pip install tox

Run all the tests (unittests only currently) with:

tox

Links

Do you develop twisted applications? An asynchronous port of this library for Twisted exists txpypd and is on it's way to catching up now.

Contributing

All help is welcome. Unittests are great to have more of. Suggestions welcome.

Copyright

pypd is availabe under the MIT License. The LICENSE file has the complete details.

Warranty

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

The LICENSE file has the complete details.

ashleyabrooks / pagerduty-api-python-client