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!

HTTP Status for Humans

Project Description

# status - HTTP Status for Humans

[![version](]( [![supported](]( ![license](

status is a very simple python library which provides human understandable HTTP status codes and improves readability of your code. You don’t have to use those ugly HTTP status numbers, but use easily understandable status names.


class PythonPeople(RequestHandler):
def post(self):
# do stuff return (‘That worked!’, 201)

But, do this:

class PythonPeople(RequestHandler):
def post(self):
# do stuff return (‘That worked!’, status.HTTP_201_CREATED)

See, that looks so much better. You can use this library wherever you want, from custom python scripts to Django, Flask etc apps. For example, if you were playing with [Requests](

>>> response = requests.delete('http://some-url')
>>> response.status_code == status.HTTP_204_NO_CONTENT

## Installation

pip install python-status

## Usage

status comes with HTTP response status codes and also some helpful methods to check the response status. Under the hood, status codes are merely an integer variable with meaningful variable names. Check file.

>>> import status
>>> status.HTTP_200_OK == 200

For list of available status codes check file.

status also comes with some helpful methods to check the status of a response. They are status.is_informational, status.is_success, status.is_redirect, status.is_client_error and status.is_server_error.

>>> import status
>>> response = requests.delete('http://some-url')
>>> if status.is_success(code=response.status_code):

# Why?

For every project I was creating a file in the root directory. So I thought it’s better to release this as a package on PyPi and use it.

# License

Please check LICENSE for more details.

# Credits

status is a fork of [Django Rest Framework]( and is independently maintained. The fork is entirely stripped of all DRF features and is not a submodule of DRF. And it doesn’t come with any DRF functionalities.

Release History

This version
History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.8 kB) Copy SHA256 Hash SHA256
Source None Oct 17, 2015

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting