skip to navigation
skip to content

Not Logged In

hypchat 0.2

Package for HipChat's v2 API

Latest Version: 0.12

A Python package for HipChat's v2 JSON REST API. It's based on v2's navigability and self-declaration.


There are two basic types in HypChat: Linker and RestObject. They are not meant to be instantiated directly but instead created as references from other objects.


A simple callable that represents an unfollowed reference.

The URL this object points to
Calling a Linker will perform the request and return a RestObject


A subclass of dict, contains additional functionality for links and actions.

Other Actions

Many of the v2 types define additional types, eg Rooms have methods for messaging, setting the topic, getting the history, and inviting users to the room. These are implemented as methods of subclasses. The complete listing is in the Type List.

Timezone Handling

HypChat uses aware datetime objects throughout by the dateutil module. However, the HipChat API universally uses UTC.

For methods that take a datetime, if a naive object is given, it will be assumed to be in UTC. If this is not what you mean, has a wonderful selection of timezones available.


First, create a HypChat object with the token

hc = HypChat("mytoken")

There are several root links:

rooms = hc.rooms()
users = hc.users()
emots = hc.emoticons()
caps = hc.capabilities()

In addition, the HypChat object has methods for creating objects and directly referencing the basic types.


If you call python -m hypchat, a interactive prompt (using IPython if available) will appear. The environment will contain hipchat, an instance of the HypChat object. The token is pulled from ~/.hypchat, /etc/hypchat, or the environment variable HIPCHAT_TOKEN.

Type List

See TYPES.rst


  • Proper Datetime and Timezone (dateutils) support
  • History
  • API Links
File Type Py Version Uploaded on Size
hypchat-0.2.tar.gz (md5) Source 2013-12-12 9KB
  • Downloads (All Versions):
  • 143 downloads in the last day
  • 746 downloads in the last week
  • 2533 downloads in the last month