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!

Port manager for developing multiple local web apps.

Project Description

When you’re building several web apps simultaneously (an increasingly common situation with microservices) it’s annoying to try and remember which app is on which port. plut (port lookup table) does it for you.



pip install plut


plut maps names to ports. You supply a name and get back the port it’s mapped to.

Imagine you have a web app with two microservices responsible for authentication and the user dashboard. Each of these services needs to know what port to bind to when it starts up, and what port the other is on, so they can talk. In this case, you might code-name these services auth and dashboard respectively. Inside the authentication service, you’d say:

import plut

port = plut.port('userauth')


Now imagine the authentication service exposes an API. Inside the dashboard service you could say:

import plut

base_url = 'http://localhost:%d/api/v1' % plut.port('userauth')
# use requests or something to send requests to base_url


  • plut.port(name) returns the port that name maps to. The same port will be returned for each name, user-wide.
  • returns a dict mapping names to ports.


  • plut shows all names and ports.
  • plut <name> shows the port of a name. This prints out a single integer, so you can use its output as a command-line argument for another program.
  • plut rm <name> removes a port. (There’s no programmatic API for this at the moment. Should I add it? I’m a bit lazy.)


plut saves everything to ~/.plutfile. If you delete this you’ll lose (or voluntarily reset) your mappings.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


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
plut-0.5.3.tar.gz (3.3 kB) Copy SHA256 Checksum SHA256 Source Oct 26, 2015

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