Skip to main content

A Python project that adds real time streaming to your web app's data.

Project description



Oneline is a websockets project that aims to simplifies writing client/server
socket code for ws, additionally provides layer of database. It is
made for developers who wish to experiment with the websocket standard
while trying to build practical applications.

How It works

It uses ws4py and cherrypy in processing websocket things, the frontend
client written in javascript is the connection to web applications. The server is designed to handle it's client.


To install oneline, you can download the code on PyPi or even GitHub (,

currently to run this, use


on success you should see the oneline server startup.


There's some recipes for Oneline, they demonstrate its pragmatic
usage in web applications or broker servers, currently they are (as of this writing)

Example 1:
LastFM Tag Streamer
- This example demonstrates streaming artists and music according to their
socially voted tags. The dataset, publicly available can be found @

Example 2:
Catapult Call Streaming
- Websockets with telecom info, this will show how to
stream VoIP events, calls using oneline and Catapult's RESTful
API, documentation.

Example 3:
Wikipedia PageRank
- This application, will use PIG and Hadoop MapReduce in providing
a realtime pagerank for wiki articles, articles which are scored
with a dampening factor of 0.08 can be voted up or down

All recipes are available at

Object Documentation
Geo Object
used to calculate lat,lng coords, bidrectionally or
in one.
meet time ranged events
General purpose SQL queries
Get input of sound based events
use oneline without a database connection

Technical Supports, requirements

Python Support:

currently >= 2.7 is needed

Databases, as of this writing supports:

PostGreSQL, MySQL, SQLite, CouchDB and MongoDB

It is recommended to atleast have one database connection

Old news ----------------------------------------------------------------------

Older Description:
A Python project that adds real time streaming to your web app's data.
Streaming is done through server modules which are written
in python, these will then be streamed over websockets -- using
cherrypy and ws4py. Streaming is done with a db table, which
will be used for all the module's data.

Data can be refined in a few ways. Currently, it is done
through the defined modules, geolocation and event.
The former will refine data based on geolocation(lng, lat) coordinates.
The latter is a general purpose database querier. These objects
can be used through a non commutative pipeline which
will filter data according to your needs.

Project details

Download files

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

Source Distributions (11.5 MB view hashes)

Uploaded source

oneline-0.6.4-alpha.tar.gz (21.6 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page