Skip to main content

A gevent based python client for NSQ.

Project description

https://badge.fury.io/py/gnsq.svg https://travis-ci.org/wtolson/gnsq.svg?branch=master https://pypip.in/d/gnsq/badge.png

A gevent based python client for NSQ.

Features include:

  • Free software: BSD license
  • Documentation: http://gnsq.readthedocs.org
  • Battle tested on billions and billions of messages </sagan>
  • Based on gevent for fast concurrent networking
  • Fast and flexible signals with Blinker
  • Automatic nsqlookupd discovery and back-off
  • Support for TLS, DEFLATE, and Snappy
  • Full HTTP clients for both nsqd and nsqlookupd

Installation

At the command line:

$ easy_install gnsq

Or even better, if you have virtualenvwrapper installed:

$ mkvirtualenv gnsq
$ pip install gnsq

Currently there is support for Python 2.6 and Python 2.7. Support for Python 3 is dependent on gevent support.

Usage

To use gnsq in a project:

import gnsq
reader = gnsq.Reader('topic', 'channel', 'localhost:4150')

@reader.on_message.connect
def handler(reader, message):
    do_work(message.body)

reader.start()

Dependencies

Optional snappy support depends on the python-snappy package which in turn depends on libsnappy:

# Debian
$ sudo apt-get install libsnappy-dev

# Or OS X
$ brew install snappy

# And then install python-snappy
$ pip install python-snappy

Contributing

Feedback, issues, and contributions are always gratefully welcomed. See the contributing guidelines for details on how to help.

Project details


Download files

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

Files for gnsq, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size gnsq-0.1.3-py2.py3-none-any.whl (22.5 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size gnsq-0.1.3.tar.gz (34.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page