Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Paasmaker Python interface library

Project Description

This is a simple Python library that is designed to read in the Paasmaker configuration of the container, falling back to a custom configuration file in development.

You can read more about the Paasmaker PaaS at


In the startup of your application create an interface object. Supply the constructor with a list of locations to look for override configuration files for development. You won’t need override configuration files if you are using the development directory SCM in Paasmaker.

import pminterface

interface = pminterface.PaasmakerInterface(['../my-project.yml'])

interface.is_on_paasmaker() # Returns true if on Paasmaker.

# Raises NameError if no such service exists.
service = interface.get_service('named-service')
# service now is a dict of the parameters. Typically this will
# have the keys 'hostname', 'username', 'password', etc. Use this
# to connect to revelant services.

# Get other application metadata.
application = interface.get_application_name()

Override configuration files can be in either YAML or JSON format. If using the YAML format, be sure to install pyyaml first. If pyyaml isn’t present, only the JSON format is supported, and it will raise an exception when trying to read YAML files.

Example YAML configuration file:

    foo: bar

  name: test
  version: 1
  workspace: Test
  workspace_stub: test

Example JSON configuration file:

        "services": {
                "parameters": {
                        "foo": "bar"
        "application": {
                "name": "test",
                "version": 1,
                "workspace": "Test",
                "workspace_stub": "test"


You can run the unit tests with the script in the root directory.

The code is currently stored on BitBucket at:

Feel free to fork and submit pull requests.

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pminterface-0.9.tar.gz (4.3 kB) Copy SHA256 Checksum SHA256 Source Mar 8, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting