Merge lp:~free.ekanayaka/txamqp/travis-integration into lp:txamqp

[Free Ekanayaka]

This branch adds a .travis.yml file with basic configuration for making txamqp tests running on Travis.

An example build is available here:

https://travis-ci.org/freeekanayaka/txamqp

It already caught a small flakiness in a test (apparently basic_qos should be sent before publishing messages, although I couldn't reproduce that failure locally).

I also added a README.md file which symlinks to the (now markdown-ified) doc/README. If there's no need to keep those files under doc/, I could just move them to the top-level dir. The CI badge snippet for now points at my Travis account, but I noticed that GitHub already has a "txamqp" organization, so it'd be nice if we could add an official GitHub mirror of lp:txlongpoll at https://github.com/txamqp/txamqp.

Note that Launchpad only supports syncing a branch *from* GitHub, but not *to*. However it's easy to do that via webhooks. I already have a service that could handle the job, so if you wish it'd be just be a matter of adding that special URL in Launchpad and granting my ssh key write access to GitHub.

You can see how the rendered README looks like here:

https://github.com/freeekanayaka/txamqp

=== added file '.travis.yml'
--- .travis.yml	1970-01-01 00:00:00 +0000
+++ .travis.yml	2016-06-08 13:24:16 +0000
@@ -0,0 +1,8 @@
+sudo: false
+dist: trusty
+language: python
+python:
+  - 2.7
+services: rabbitmq
+install: pip install -r requirements.txt
+script: cd src; TXAMQP_BROKER=RABBITMQ trial txamqp
 
=== added symlink 'README.md'
=== target is u'doc/README'
=== modified file 'doc/README'
--- doc/README	2009-08-15 10:27:56 +0000
+++ doc/README	2016-06-08 13:24:16 +0000
@@ -1,51 +1,54 @@
+## Python library for communicating with AMQP peers and brokers using Twisted
+[![Build Status](https://travis-ci.org/freeekanayaka/txamqp.svg?branch=master)](https://travis-ci.org/freeekanayaka/txamqp)
+
 This is a quick post on getting started using the txAMQP library with RabbitMQ,
 based on Dan Reverri's article "Getting started with RabbitMQ, Python, Twisted,
 and txAMQP on Ubuntu 9.04" [http://www.apparatusproject.org/blog/?p=38]
 
-Install RabbitMQ
+### Install RabbitMQ
 	
 If you're using Debian (or a derivative, like Ubuntu) and RabbitMQ is not
 included in your distribution, you can add RabbitMQ's APT repository:
 
-http://www.rabbitmq.com/debian.html#apt
+    http://www.rabbitmq.com/debian.html#apt
 
-Running RabbitMQ
+### Running RabbitMQ
 
 If you installed RabbitMQ using the Debian package, it will be automatically
 started. If not, you'll find an init.d file in /etc/init.d/rabbitmq-server
 
-Install Twisted
+### Install Twisted
 
 As of 2009-07-09, txAMQP is being developed using Twisted 8.2.0, it may
 work with older versions, but it's not guaranteed. In case you are using
 Ubuntu, and the version available is not recent enough, you can install
 Twisted through its PPA:
 
-https://launchpad.net/~twisted-dev/+archive/ppa
+    https://launchpad.net/~twisted-dev/+archive/ppa
 
-Install txAMQP
+### Install txAMQP
 
 The instructions below install txAQMP from trunk. There are Ubuntu packages
 available if you prefer, refer to the following page for more details:
 
-https://launchpad.net/~txamqpteam/+archive/ppa
+    https://launchpad.net/~txamqpteam/+archive/ppa
 
 a. Install Bazaar
 
-$ sudo apt-get install bzr
+    $ sudo apt-get install bzr
 
 b. Fetch txAQMP
 
-$ cd ~
-$ bzr branch lp:txamqp txamqp
+    $ cd ~
+    $ bzr branch lp:txamqp txamqp
 
 If you get the error "bzr: ERROR: Unknown repository format: 'Bazaar
 RepositoryFormatKnitPack6 (bzr 1.9)", you'll need to upgrade Bazaar. You may
 do so following the instructions at:
 
-http://bazaar-vcs.org/Download
+    http://bazaar-vcs.org/Download
 
 c. Install txAMQP
 
-$ cd txamqp
-$ sudo python setup.py install
+    $ cd txamqp
+    $ sudo python setup.py install
 
=== added file 'requirements.txt'
--- requirements.txt	1970-01-01 00:00:00 +0000
+++ requirements.txt	2016-06-08 13:24:16 +0000
@@ -0,0 +1,1 @@
+-e .
 
=== modified file 'src/txamqp/test/test_basic.py'
--- src/txamqp/test/test_basic.py	2012-07-11 11:12:55 +0000
+++ src/txamqp/test/test_basic.py	2016-06-08 13:24:16 +0000
@@ -264,13 +264,14 @@
         """
         #setup: declare queue and subscribe
         channel = self.channel
+
+        #set prefetch to 5:
+        yield channel.basic_qos(prefetch_count=5)
+
         yield channel.queue_declare(queue="test-prefetch-count", exclusive=True)
         subscription = yield channel.basic_consume(queue="test-prefetch-count", no_ack=False)
         queue = yield self.client.queue(subscription.consumer_tag)
 
-        #set prefetch to 5:
-        yield channel.basic_qos(prefetch_count=5)
-
         #publish 10 messages:
         for i in range(1, 11):
             channel.basic_publish(routing_key="test-prefetch-count", content=Content("Message %d" % i))