add docs and project hair

.gitignore

@@ -3,3 +3,8 @@ venv
 *.pyc
 *.egg-info
 .coverage
+*.egg
+.tox/
+env26/
+zodburi/coverage.xml
+nosetests.xml

CHANGES.txt

+Next release
+------------
+
+- Initial release.

CONTRIBUTORS.txt

+Pylons Project Contributor Agreement
+====================================
+
+The submitter agrees by adding his or her name within the section below named
+"Contributors" and submitting the resulting modified document to the
+canonical shared repository location for this software project (whether
+directly, as a user with "direct commit access", or via a "pull request"), he
+or she is signing a contract electronically.  The submitter becomes a
+Contributor after a) he or she signs this document by adding their name
+beneath the "Contributors" section below, and b) the resulting document is
+accepted into the canonical version control repository.
+
+Treatment of Account
+---------------------
+
+Contributor will not allow anyone other than the Contributor to use his or
+her username or source repository login to submit code to a Pylons Project
+source repository. Should Contributor become aware of any such use,
+Contributor will immediately by notifying Agendaless Consulting.
+Notification must be performed by sending an email to
+webmaster@agendaless.com.  Until such notice is received, Contributor will be
+presumed to have taken all actions made through Contributor's account. If the
+Contributor has direct commit access, Agendaless Consulting will have
+complete control and discretion over capabilities assigned to Contributor's
+account, and may disable Contributor's account for any reason at any time.
+
+Legal Effect of Contribution
+----------------------------
+
+Upon submitting a change or new work to a Pylons Project source Repository (a
+"Contribution"), you agree to assign, and hereby do assign, a one-half
+interest of all right, title and interest in and to copyright and other
+intellectual property rights with respect to your new and original portions
+of the Contribution to Agendaless Consulting. You and Agendaless Consulting
+each agree that the other shall be free to exercise any and all exclusive
+rights in and to the Contribution, without accounting to one another,
+including without limitation, the right to license the Contribution to others
+under the Repoze Public License. This agreement shall run with title to the
+Contribution. Agendaless Consulting does not convey to you any right, title
+or interest in or to the Program or such portions of the Contribution that
+were taken from the Program. Your transmission of a submission to the Pylons
+Project source Repository and marks of identification concerning the
+Contribution itself constitute your intent to contribute and your assignment
+of the work in accordance with the provisions of this Agreement.
+
+License Terms
+-------------
+
+Code committed to the Pylons Project source repository (Committed Code) must
+be governed by the Repoze Public License (http://repoze.org/LICENSE.txt, aka
+"the RPL") or another license acceptable to Agendaless Consulting.  Until
+Agendaless Consulting declares in writing an acceptable license other than
+the RPL, only the RPL shall be used.  A list of exceptions is detailed within
+the "Licensing Exceptions" section of this document, if one exists.
+
+Representations, Warranty, and Indemnification
+----------------------------------------------
+
+Contributor represents and warrants that the Committed Code does not violate
+the rights of any person or entity, and that the Contributor has legal
+authority to enter into this Agreement and legal authority over Contributed
+Code. Further, Contributor indemnifies Agendaless Consulting against
+violations.
+
+Cryptography
+------------
+
+Contributor understands that cryptographic code may be subject to government
+regulations with which Agendaless Consulting and/or entities using Committed
+Code must comply. Any code which contains any of the items listed below must
+not be checked-in until Agendaless Consulting staff has been notified and has
+approved such contribution in writing.
+
+- Cryptographic capabilities or features
+
+- Calls to cryptographic features
+
+- User interface elements which provide context relating to cryptography
+
+- Code which may, under casual inspection, appear to be cryptographic.
+
+Notices
+-------
+
+Contributor confirms that any notices required will be included in any
+Committed Code.
+
+List of Contributors
+====================
+
+The below-signed are contributors to a code repository that is part of the
+project named "zodburi".  Each below-signed contributor has read, understand
+and agrees to the terms above in the section within this document entitled
+"Pylons Project Contributor Agreement" as of the date beside his or her name.
+
+Contributors
+------------
+
+- Chris McDonough, 2011/08/18

COPYRIGHT.txt

+Copyright (c) 2008-2011 Agendaless Consulting and Contributors.
+(http://www.agendaless.com), All Rights Reserved

LICENSE.txt

+A copyright notice accompanies this license document that identifies
+the copyright holders.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions in source code must retain the accompanying
+    copyright notice, this list of conditions, and the following
+    disclaimer.
+
+2.  Redistributions in binary form must reproduce the accompanying
+    copyright notice, this list of conditions, and the following
+    disclaimer in the documentation and/or other materials provided
+    with the distribution.
+
+3.  Names of the copyright holders must not be used to endorse or
+    promote products derived from this software without prior
+    written permission from the copyright holders.
+
+4.  If any files are modified, you must cause the modified files to
+    carry prominent notices stating that you changed the files and
+    the date of any change.
+
+Disclaimer
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND
+  ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+  TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+  PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+  HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+  THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+  SUCH DAMAGE.

README.rst

+``zodburi``
+===========
+
+A library which parses URIs and converts them to ZODB storage objects and
+database arguments.
+
+See the documentation at https://docs.pylonsproject.org/projects/zodburi/dev/
+for more information.
+

docs/.gitignore

+_themes
+_build/
+.static

docs/Makefile

+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d _build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html web pickle htmlhelp latex changes linkcheck
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html      to make standalone HTML files"
+	@echo "  pickle    to make pickle files (usable by e.g. sphinx-web)"
+	@echo "  htmlhelp  to make HTML files and a HTML help project"
+	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  changes   to make an overview over all changed/added/deprecated items"
+	@echo "  linkcheck to check all external links for integrity"
+
+clean:
+	-rm -rf _build/*
+
+html: _themes/
+	mkdir -p _build/html _build/doctrees
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html."
+
+text:
+	mkdir -p _build/text _build/doctrees
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text
+	@echo
+	@echo "Build finished. The HTML pages are in _build/text."
+
+pickle:
+	mkdir -p _build/pickle _build/doctrees
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) _build/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files or run"
+	@echo "  sphinx-web _build/pickle"
+	@echo "to start the sphinx-web server."
+
+web: pickle
+
+htmlhelp: _themes
+	mkdir -p _build/htmlhelp _build/doctrees
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) _build/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in _build/htmlhelp."
+
+latex:
+	mkdir -p _build/latex _build/doctrees
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) _build/latex
+	cp _static/*.png _build/latex
+	./convert_images.sh
+	cp _static/latex-warning.png _build/latex
+	cp _static/latex-note.png _build/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in _build/latex."
+	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
+	      "run these through (pdf)latex."
+
+changes:
+	mkdir -p _build/changes _build/doctrees
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) _build/changes
+	@echo
+	@echo "The overview file is in _build/changes."
+
+linkcheck:
+	mkdir -p _build/linkcheck _build/doctrees
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) _build/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in _build/linkcheck/output.txt."
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) _build/epub
+	@echo
+	@echo "Build finished. The epub file is in _build/epub."
+
+_themes:
+	git clone git://github.com/Pylons/pylons_sphinx_theme.git _themes

docs/api.rst

+.. _zodburi_api:
+
+:mod:`zodburi` API
+------------------
+
+.. automodule:: zodburi
+
+.. autofunction:: resolve_uri
+
+

docs/conf.py

+# -*- coding: utf-8 -*-
+#
+# zodburi documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its containing
+# dir.
+#
+# The contents of this file are pickled, so don't put values in the
+# namespace that aren't pickleable (module imports are okay, they're
+# removed automatically).
+#
+# All configuration values have a default value; values that are commented
+# out serve to show the default value.
+
+# If your extensions are in another directory, add it here. If the
+# directory is relative to the documentation root, use os.path.abspath to
+# make it absolute, like shown here.
+#sys.path.append(os.path.abspath('some/directory'))
+
+import sys, os
+
+parent = os.path.dirname(os.path.dirname(__file__))
+sys.path.append(os.path.abspath(parent))
+wd = os.getcwd()
+os.chdir(parent)
+os.system('%s setup.py test -q' % sys.executable)
+os.chdir(wd)
+
+for item in os.listdir(parent):
+    if item.endswith('.egg'):
+        sys.path.append(os.path.join(parent, item))
+
+# General configuration
+# ---------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.intersphinx',
+    ]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['.templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General substitutions.
+project = 'zodburi'
+copyright = '2011, Agendaless Consulting <chrism@plope.com>'
+
+# The default replacements for |version| and |release|, also used in various
+# other places throughout the built documents.
+#
+# The short X.Y version.
+version = '0.0'
+# The full version, including alpha/beta/rc tags.
+release = version
+
+# There are two options for replacing |today|: either, you set today to
+# some non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+today_fmt = '%B %d, %Y'
+
+# List of documents that shouldn't be included in the build.
+#unused_docs = []
+
+# List of directories, relative to source directories, that shouldn't be
+# searched for source files.
+#exclude_dirs = []
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+
+# Options for HTML output
+# -----------------------
+
+# Add and use Pylons theme
+sys.path.append(os.path.abspath('_themes'))
+html_theme_path = ['_themes']
+html_theme = 'pylons'
+html_theme_options = dict(github_url='http://github.com/Pylons/zodburi')
+
+# The style sheet to use for HTML and HTML Help pages. A file of that name
+# must exist either in Sphinx' static/ path, or in one of the custom paths
+# given in html_static_path.
+# html_style = 'repoze.css'
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as
+# html_title.
+#html_short_title = None
+
+# The name of an image file (within the static path) to place at the top of
+# the sidebar.
+# html_logo = '.static/logo_hi.gif'
+
+# The name of an image file (within the static path) to use as favicon of
+# the docs.  This file should be a Windows icon file (.ico) being 16x16 or
+# 32x32 pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets)
+# here, relative to this directory. They are copied after the builtin
+# static files, so a file named "default.css" will overwrite the builtin
+# "default.css".
+#html_static_path = ['.static']
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page
+# bottom, using the given strftime format.
+html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_use_modindex = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, the reST sources are included in the HTML build as
+# _sources/<name>.
+#html_copy_source = True
+
+# If true, an OpenSearch description file will be output, and all pages
+# will contain a <link> tag referring to it.  The value of this option must
+# be the base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = ''
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'atemplatedoc'
+
+
+# Options for LaTeX output
+# ------------------------
+
+# The paper size ('letter' or 'a4').
+#latex_paper_size = 'letter'
+
+# The font size ('10pt', '11pt' or '12pt').
+#latex_font_size = '10pt'
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, document class [howto/manual]).
+latex_documents = [
+  ('index', 'zodburi.tex', 'zodburi Documentation',
+   'Repoze Developers', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the
+# top of the title page.
+latex_logo = '.static/logo_hi.gif'
+
+# For "manual" documents, if this is true, then toplevel headings are
+# parts, not chapters.
+#latex_use_parts = False
+
+# Additional stuff for the LaTeX preamble.
+#latex_preamble = ''
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_use_modindex = True

docs/index.rst

+zodburi
+=======
+
+Overview
+--------
+
+A library which parses URIs and converts them to ZODB storage objects and
+database arguments.
+
+It will run under CPython 2.5, 2.6, and 2.7.  It will not run under PyPy or
+Jython.  It requires ZODB >= 3.10.0.
+
+Installation
+------------
+
+Install using setuptools, e.g. (within a virtualenv)::
+
+  $ easy_install zodburi
+
+Using
+-----
+
+``zodburi`` has exactly one api: :func:`zodburi.resolve_uri`.  This API
+obtains a ZODB storage factory and a set of keyword arguments suitable for
+passing to the ``ZODB.DB.DB`` constructor.  For example:
+
+.. code-block:: python
+   :linenos:
+
+   from zodburi import resolve_uri
+
+   storage_factory, dbkw = resolve_uri(
+                     'zeo://localhost:9001?connection_cache_size=20000')
+
+   # factory will be an instance of ClientStorageURIResolver 
+   # dbkw will be {'connection_cache_size':20000, 'pool_size':7,
+   #               'database_name':'unnamed'}
+
+   from ZODB.DB import DB
+   storage = storage_factory()
+   db = DB(storage, **dbkw)
+
+URI Schemes
+-----------
+
+The URI schemes currently recognized in the ``zodbconn.uri`` setting are
+``file://``, ``zeo://``, ``zconfig://`` and ``memory://``.  Documentation for
+these URI scheme syntaxes are below.
+
+``file://`` URI scheme
+~~~~~~~~~~~~~~~~~~~~~~
+
+The ``file://`` URI scheme can be passed as ``zodbconn.uri`` to create a ZODB
+FileStorage database factory.  The path info section of this scheme should
+point at a filesystem file path that should contain the filestorage data.
+For example::
+
+  file:///my/absolute/path/to/Data.fs
+
+The URI scheme also accepts query string arguments.  The query string
+arguments honored by this scheme are as follows.
+
+FileStorage constructor related
++++++++++++++++++++++++++++++++
+
+These arguments generally inform the FileStorage constructor about
+values of the same names.
+
+create
+  boolean
+read_only
+  boolean
+quota
+  bytesize
+
+Database-related
+++++++++++++++++
+
+These arguments relate to the database (as opposed to storage)
+settings.
+
+database_name
+  string
+
+Connection-related
+++++++++++++++++++
+
+These arguments relate to connections created from the database.
+
+connection_cache_size
+  integer (default 10000)
+connection_pool_size
+  integer (default 7)
+
+Blob-related
+++++++++++++
+
+If these arguments exist, they control the blob settings for this
+storage.
+
+blobstorage_dir
+  string
+blobstorage_layout
+  string
+
+Misc
+++++
+
+demostorage 
+  boolean (if true, wrap FileStorage in a DemoStorage)
+
+Example
++++++++
+
+An example that combines a path with a query string::
+
+   file:///my/Data.fs?connection_cache_size=100&blobstorage_dir=/foo/bar
+
+``zeo://`` URI scheme
+~~~~~~~~~~~~~~~~~~~~~~
+
+The ``zeo://`` URI scheme can be passed as ``zodbconn.uri`` to create a ZODB
+ClientStorage database factory. Either the host and port parts of this scheme
+should point at a hostname/portnumber combination e.g.::
+
+  zeo://localhost:7899
+
+Or the path part should point at a UNIX socket name::
+
+  zeo:///path/to/zeo.sock
+
+The URI scheme also accepts query string arguments.  The query string
+arguments honored by this scheme are as follows.
+
+ClientStorage-constructor related
++++++++++++++++++++++++++++++++++
+
+These arguments generally inform the ClientStorage constructor about
+values of the same names.
+
+storage
+  string
+cache_size
+  bytesize
+name
+  string
+client
+  string
+debug
+  boolean
+var
+  string
+min_disconnect_poll
+  integer
+max_disconnect_poll
+  integer
+wait
+  boolean
+wait_timeout
+  integer
+read_only
+  boolean
+read_only_fallback
+  boolean
+username
+  string
+password
+  string
+realm
+  string
+blob_dir
+  string
+shared_blob_dir
+  boolean
+
+Misc
+++++
+
+demostorage
+  boolean (if true, wrap ClientStorage in a DemoStorage)
+
+Connection-related
+++++++++++++++++++
+
+These arguments relate to connections created from the database.
+
+connection_cache_size
+  integer (default 10000)
+connection_pool_size
+  integer (default 7)
+
+Database-related
+++++++++++++++++
+
+These arguments relate to the database (as opposed to storage)
+settings.
+
+database_name
+  string
+
+Example
++++++++
+
+An example that combines a path with a query string::
+
+  zeo://localhost:9001?connection_cache_size=20000
+
+``zconfig://`` URI scheme
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``zconfig://`` URI scheme can be passed as ``zodbconn.uri`` to create any
+kind of storage that ZODB can load via ZConfig. The path info section of this
+scheme should point at a ZConfig file on the filesystem. Use an optional
+fragment identifier to specify which database to open. This URI scheme does
+not use query string parameters.
+
+Examples
+++++++++
+
+An example ZConfig file::
+
+    <zodb>
+      <mappingstorage>
+      </mappingstorage>
+    </zodb>
+
+If that configuration file is located at /etc/myapp/zodb.conf, use the
+following URI to open the database::
+
+    zconfig:///etc/myapp/zodb.conf
+
+A ZConfig file can specify more than one database.  For example::
+
+    <zodb temp1>
+      <mappingstorage>
+      </mappingstorage>
+    </zodb>
+    <zodb temp2>
+      <mappingstorage>
+      </mappingstorage>
+    </zodb>
+
+In that case, use a URI with a fragment identifier::
+
+    zconfig:///etc/myapp/zodb.conf#temp1
+
+``memory://`` URI scheme
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``memory://`` URI scheme can be passed as ``zodbconn.uri`` to create a
+ZODB MappingStorage (memory-based) database factory.  The path info section
+of this scheme should be a storage name.  For example::
+
+  memory://storagename
+
+However, the storage name is usually omitted, and the most common form is::
+
+  memory://
+
+The URI scheme also accepts query string arguments.  The query string
+arguments honored by this scheme are as follows.
+
+Database-related
+++++++++++++++++
+
+These arguments relate to the database (as opposed to storage)
+settings.
+
+database_name
+  string
+
+Connection-related
+++++++++++++++++++
+
+These arguments relate to connections created from the database.
+
+connection_cache_size
+  integer (default 10000)
+connection_pool_size
+  integer (default 7)
+
+Example
++++++++
+
+An example that combines a dbname with a query string::
+
+   memory://storagename?connection_cache_size=100&database_name=fleeb
+
+More Information
+----------------
+
+.. toctree::
+   :maxdepth: 1
+
+   api.rst
+
+Reporting Bugs / Development Versions
+-------------------------------------
+
+Visit http://github.com/Pylons/zodburi to download development or
+tagged versions.
+
+Visit http://github.com/Pylons/zodburi/issues to report bugs.
+
+Indices and tables
+------------------
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

setup.py

@@ -6,7 +6,7 @@ from setuptools import find_packages
 here = os.path.abspath(os.path.dirname(__file__))
 
 try:
-    README = open(os.path.join(here, 'README.txt')).read()
+    README = open(os.path.join(here, 'README.rst')).read()
     CHANGES = open(os.path.join(here, 'CHANGES.txt')).read()
 except:
     README = ''
@@ -16,7 +16,7 @@ requires = ['ZODB3']
 tests_require = requires + ['mock']
 
 setup(name='zodburi',
-      version='0.1a1',
+      version='0.0',
       description=('Constructs ZODB storage instances from URIs.'),
       long_description=README + '\n\n' +  CHANGES,
       classifiers=[

tox.ini

+[tox]
+envlist = 
+    py25,py26,py27,cover
+
+[testenv]
+commands = 
+    python setup.py test -q
+
+[testenv:cover]
+basepython =
+    python2.6
+commands = 
+    python setup.py nosetests --with-xunit --with-xcoverage
+deps =
+    nose
+    coverage==3.4
+    nosexcover
+
+# we separate coverage into its own testenv because a) "last run wins" wrt
+# cobertura jenkins reporting and b) pypy and jython can't handle any
+# combination of versions of coverage and nosexcover that i can find.
+# coverage==3.4 is required by nosexcover.
+