1.0.0-beta1 release

CHANGELOG.rst

@@ -0,0 +1,3 @@
+1.0.0-beta
+==========
+Initial release

README-dev.rst

@@ -0,0 +1,50 @@
+Releasing
+=========
+* Run the tests and ensure they all pass
+* Update CHANGELOG.rst
+* Update the version in ``cassandra/__init__.py``
+* Commit the changelog and version changes
+* Tag the release.  For example: ``git tag -a 1.0.0 -m 'version 1.0.0'``
+* Push the commit and tag: ``git push --tags origin master``
+* Upload the package to pypi:
+
+    python setup.py register
+    python setup.py sdist upload
+
+* Update the docs (see below)
+* Add a '+' to the version in ``cassandra/__init__.py`` so that it looks
+  like ``x.y.z+``
+* Commit and push
+
+Running the Tests
+=================
+In order for the extensions to be built and used in the test, run:
+
+    python setup.py nosetests
+
+Building the Docs
+=================
+Sphinx is required to build the docs. You probably want to install through apt,
+if possible:
+
+    $ sudo apt-get install python-sphinx
+
+pip may also work:
+
+    $ sudo pip install -U Sphinx
+
+To build the docs, run:
+
+    python setup.py doc
+
+To upload the docs, checkout the ``gh-pages`` branch (it's usually easier to
+clone a second copy of this repo and leave it on that branch) and copy the entire
+contents all of ``docs/_build/X.Y.Z/*`` into the root of the ``gh-pages`` branch
+and then push that branch to github.
+
+For example:
+
+    $ python setup.py doc
+    $ cp -R docs/_build/1.0.0-beta1/* ~/python-driver-docs/
+    $ cd ~/python-driver-docs
+    $ git push origin gh-pages

README.rst

@@ -26,9 +26,14 @@ Features to be Added
 
 Installation
 ------------
-A package hasn't been put on pypi yet, so for now, run:
+If you would like to use the optional C extensions, please follow
+the instructions in the section below before installing the driver.
 
-    .. code-block:: bash
+Installation through pip is recommended:
+
+    $ sudo pip install cassandra-driver
+
+If you want to install manually, you can instead do:
 
     $ sudo pip install futures scales # install dependencies
     $ sudo python setup.py install
@@ -47,14 +52,10 @@ To compile the extenions, ensure that GCC and the Python headers are available.
 
 On Ubuntu and Debian, this can be accomplished by running:
 
-    .. code-block:: bash
-
     $ sudo apt-get install build-essential python-dev
 
 On RedHat and RedHat-based systems like CentOS and Fedora:
 
-    .. code-block:: bash
-
     $ sudo yum install gcc python-devel
 
 On OS X, homebrew installations of Python should provide the necessary headers.
@@ -68,23 +69,17 @@ a C extension.
 If you're on Linux, you should be able to install libev
 through a package manager.  For example, on Debian/Ubuntu:
 
-    .. code-block:: bash
-
     $ sudo apt-get install libev4 libev-dev
 
 If you're on Mac OS X, you should be able to install libev
 through `Homebrew <http://brew.sh/>`_. For example, on Mac OS X:
 
-    .. code-block:: bash
-
     $ brew install libev
 
 If successful, you should be able to build and install the extension
 (just using ``setup.py build`` or ``setup.py install``) and then use
 the libev event loop by doing the following
 
-    .. code-block:: python
-
     >>> from cassandra.io.libevreactor import LibevConnection
     >>> from cassandra.cluster import Cluster
 

cassandra/__init__.py

@@ -1,4 +1,4 @@
-__version_info__ = (0, 1, 4)
+__version_info__ = (1, 0, '0-beta1')
 __version__ = '.'.join(map(str, __version_info__))
 
 

setup.py

@@ -20,6 +20,9 @@ from distutils.cmd import Command
 
 from cassandra import __version__
 
+long_description = ""
+with open("README.rst") as f:
+    long_description = f.read()
 
 class doc(Command):
 
@@ -166,9 +169,11 @@ The optional C extensions are not supported on big-endian systems.
     features = {}
 
 setup(
-    name='cassandra',
+    name='cassandra-driver',
     version=__version__,
     description='Python driver for Cassandra',
+    long_description=long_description,
+    url='http://github.com/datastax/python-driver',
     author='Tyler Hobbs',
     author_email='tyler@datastax.com',
     packages=["cassandra", "cassandra.io"],