Merge lp:~gary/lazr.delegates/build-license-changes into lp:~launchpad-pqm/lazr.delegates/devel

[Gary Poster]

[Gary Poster (gary)]

The same changes as for the other lazr packages:

- license specifies v3 of LGPL

- buildout updates

Thanks

Gary

[Francis J. Lacoste (flacoste)]

On March 24, 2009, Gary Poster wrote:
> Gary Poster has proposed merging
> lp:~gary/lazr.delegates/build-license-changes into lp:lazr.delegates.
>
> Requested reviews:
> LAZR Developers (lazr-developers)
>
> The same changes as for the other lazr packages:
>
> - license specifies v3 of LGPL
>
> - buildout updates
>

 status approved
 review approve

Nothing to say here.

--
Francis J. Lacoste
<email address hidden>

review: Approve

[lp:~gary/lazr.delegates/build-license-changes]

5. By Gary Poster on 2009-03-24

1.0.1

=== modified file '.bzrignore'
--- .bzrignore	2008-12-15 22:21:53 +0000
+++ .bzrignore	2009-03-24 18:52:52 +0000
@@ -1,8 +1,11 @@
-TEST_THIS_REST_BEFORE_REGISTERING.txt
 bin
 develop-eggs
-eggs
+.installed.cfg
+develop-eggs
 parts
-src/*.egg-info
-.installed.cfg
+*.egg-info
+tags
+TAGS
+build
+*.egg
 dist
 
=== modified file 'CHANGES.txt'
--- CHANGES.txt	2008-12-15 22:21:53 +0000
+++ CHANGES.txt	2009-03-24 18:56:04 +0000
@@ -1,1 +1,16 @@
 Please see CHANGES.txt in the package.
+
+..
+    This file is part of lazr.delegates.
+
+    lazr.delegates is free software: you can redistribute it and/or modify it
+    under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, version 3 of the License.
+
+    lazr.delegates is distributed in the hope that it will be useful, but
+    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+    License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
 
=== renamed file 'DEVELOP.txt' => 'HACKING.txt'
--- DEVELOP.txt	2008-12-15 22:21:53 +0000
+++ HACKING.txt	2009-03-24 19:51:29 +0000
@@ -1,59 +1,41 @@
+..
+    This file is part of lazr.delegates.
+
+    lazr.delegates is free software: you can redistribute it and/or modify it
+    under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, version 3 of the License.
+
+    lazr.delegates is distributed in the hope that it will be useful, but
+    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+    or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
+    License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+
 This project uses zc.buildout for development.
 
-To develop or run tests, first run ``$DESIRED_PYTHON bootstrap.py`` in this
-directory, where you replace ``$DESIRED_PYTHON`` with the python that should
-be used to build and run this project. A non-system Python is highly
-recommended, but not required.
-
-Then run ``./bin/buildout``.  (NOTE: Ubuntu Intrepid users, see bottom of this
-document if this generates errors.)
-
-You can now run tests with ``./bin/test``.  Use ``./bin/test --help`` to read
-about the many options.
-
-To gain access to a Python interpreter with the package and its dependent eggs
-available, use ``./bin/py``.
-
-You can generate ctags and idutils files for a variety of editors using
-``./bin/tags`` (see ``./bin/tags --help``). The advantage of the files
-generated from this utility is that they include the sourcecode from the eggs
-used in this buildout.
-
-To generate distributions, use ``./bin/buildout setup . SETUP_CMD [...]``.
-That is, you can use ``./bin/buildout setup .`` as if it were
-``python setup.py``.  The intended advantage is easy access to a pristine,
-local version of setuptools.
-
-Every project using zc.buildout will keep its own collection of eggs by
-default.  You may want to cache these eggs, and their downloaded
-distributions, globally.  To do so, perform the following instructions.
-
-- ``mkdir -p ~/.buildout/eggs``
-- ``mkdir ~/.buildout/download-cache``
-- Create ``~/.buildout/default.cfg`` with the following content, replacing
-  "$HOME" with the path to your home::
-
-    [buildout]
-    eggs-directory=$HOME/.buildout/eggs
-    download-cache=$HOME/.buildout/download-cache
-
-Ubunutu Intrepid Problem
-========================
-
-Intrepid has a bug working with buildout.  You may have to hack to fix it.
-Here's an example of the Python 2.4 version of the hack.
-
-$ sudo rm  /usr/lib/python2.4/site-packages/GMenuSimpleEditor/*.py
-$ sudo ln
--s /var/lib/python-support/python2.4/GMenuSimpleEditor/*.py /usr/lib/python2.4/site-packages/GMenuSimpleEditor/
-
-Python 2.5 would need the same kind of fix (replace all three instances of
-"python2.4" with "python2.5" in the above).
-
-The author of this document tried an Intrepid upgrade and an aptitude
-reinstall of python-gmenu to no avail before doing the rough-and-tumble change
-described above.
-
-See
-https://bugs.edge.launchpad.net/ubuntu/+source/gnome-menus/+bug/301571 and the
-bug linked to it by datakid.
+============
+Introduction
+============
+
+These are guidelines for hacking on the lazr.delegates project.  But first,
+please see the common hacking guidelines at:
+
+    http://dev.launchpad.net/Hacking
+
+
+Getting help
+------------
+
+If you find bugs in this package, you can report them here:
+
+    https://launchpad.net/lazr.delegates
+
+If you want to discuss this package, join the team and mailing list here:
+
+    https://launchpad.net/~lazr-developers
+
+or send a message to:
+
+    [e-mail]
 
=== modified file 'MANIFEST.in'
--- MANIFEST.in	2008-12-15 22:21:53 +0000
+++ MANIFEST.in	2009-03-24 18:52:52 +0000
@@ -1,2 +1,2 @@
-include *.txt MANIFEST.in
-recursive-include src *.txt *.py
+exclude MANIFEST.in buildout.cfg bootstrap.py .bzrignore
+prune _bootstrap
 
=== modified file 'README.txt'
--- README.txt	2008-12-15 22:21:53 +0000
+++ README.txt	2009-03-24 19:51:29 +0000
@@ -1,1 +1,16 @@
 Easily write objects that delegate behavior.
+
+..
+    This file is part of lazr.delegates.
+
+    lazr.delegates is free software: you can redistribute it and/or modify it
+    under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, version 3 of the License.
+
+    lazr.delegates is distributed in the hope that it will be useful, but
+    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+    License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
 
=== added directory '_bootstrap'
=== added file '_bootstrap/COPYRIGHT.txt'
--- _bootstrap/COPYRIGHT.txt	1970-01-01 00:00:00 +0000
+++ _bootstrap/COPYRIGHT.txt	2009-03-24 18:52:52 +0000
@@ -0,0 +1,9 @@
+Copyright (c) 2004-2009 Zope Corporation and Contributors.
+All Rights Reserved.
+
+This software is subject to the provisions of the Zope Public License,
+Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+FOR A PARTICULAR PURPOSE.
 
=== added file '_bootstrap/LICENSE.txt'
--- _bootstrap/LICENSE.txt	1970-01-01 00:00:00 +0000
+++ _bootstrap/LICENSE.txt	2009-03-24 18:52:52 +0000
@@ -0,0 +1,54 @@
+Zope Public License (ZPL) Version 2.1
+-------------------------------------
+
+A copyright notice accompanies this license document that
+identifies the copyright holders.
+
+This license has been certified as open source. It has also
+been designated as GPL compatible by the Free Software
+Foundation (FSF).
+
+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. The right to distribute this software or to use it for
+   any purpose does not give you the right to use
+   Servicemarks (sm) or Trademarks (tm) of the copyright
+   holders. Use of them is covered by separate agreement
+   with the copyright holders.
+
+5. 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.
 \ No newline at end of file
 
=== renamed file 'bootstrap.py' => '_bootstrap/bootstrap.py'
=== added symlink 'bootstrap.py'
=== target is '_bootstrap/bootstrap.py'
=== modified file 'buildout.cfg'
--- buildout.cfg	2008-12-15 22:21:53 +0000
+++ buildout.cfg	2009-03-24 19:51:29 +0000
@@ -2,6 +2,7 @@
 parts =
     interpreter
     test
+    docs
     tags
 unzip = true
 
@@ -10,7 +11,14 @@
 [test]
 recipe = zc.recipe.testrunner
 eggs = lazr.delegates
-defaults = '--tests-pattern ^tests --exit-with-status'.split()
+defaults = '--tests-pattern ^tests --exit-with-status --suite-name additional_tests'.split()
+
+[docs]
+recipe = z3c.recipe.sphinxdoc
+eggs = lazr.delegates [docs]
+index-doc = README
+default.css =
+layout.html =
 
 [interpreter]
 recipe = zc.recipe.egg
 
=== added file 'ez_setup.py'
--- ez_setup.py	1970-01-01 00:00:00 +0000
+++ ez_setup.py	2009-03-24 18:52:52 +0000
@@ -0,0 +1,241 @@
+#!python
+"""Bootstrap setuptools installation
+
+If you want to use setuptools in your package's setup.py, just include this
+file in the same directory with it, and add this to the top of your setup.py::
+
+    from ez_setup import use_setuptools
+    use_setuptools()
+
+If you want to require a specific version of setuptools, set a download
+mirror, or use an alternate download directory, you can do so by supplying
+the appropriate options to ``use_setuptools()``.
+
+This file can also be run as a script to install or upgrade setuptools.
+"""
+import sys
+DEFAULT_VERSION = "0.6c8"
+DEFAULT_URL     = "http://pypi.python.org/packages/%s/s/setuptools/" % sys.version[:3]
+
+md5_data = {
+    'setuptools-0.6b1-py2.3.egg': '8822caf901250d848b996b7f25c6e6ca',
+    'setuptools-0.6b1-py2.4.egg': 'b79a8a403e4502fbb85ee3f1941735cb',
+    'setuptools-0.6b2-py2.3.egg': '5657759d8a6d8fc44070a9d07272d99b',
+    'setuptools-0.6b2-py2.4.egg': '4996a8d169d2be661fa32a6e52e4f82a',
+    'setuptools-0.6b3-py2.3.egg': 'bb31c0fc7399a63579975cad9f5a0618',
+    'setuptools-0.6b3-py2.4.egg': '38a8c6b3d6ecd22247f179f7da669fac',
+    'setuptools-0.6b4-py2.3.egg': '62045a24ed4e1ebc77fe039aa4e6f7e5',
+    'setuptools-0.6b4-py2.4.egg': '4cb2a185d228dacffb2d17f103b3b1c4',
+    'setuptools-0.6c1-py2.3.egg': 'b3f2b5539d65cb7f74ad79127f1a908c',
+    'setuptools-0.6c1-py2.4.egg': 'b45adeda0667d2d2ffe14009364f2a4b',
+    'setuptools-0.6c2-py2.3.egg': 'f0064bf6aa2b7d0f3ba0b43f20817c27',
+    'setuptools-0.6c2-py2.4.egg': '616192eec35f47e8ea16cd6a122b7277',
+    'setuptools-0.6c3-py2.3.egg': 'f181fa125dfe85a259c9cd6f1d7b78fa',
+    'setuptools-0.6c3-py2.4.egg': 'e0ed74682c998bfb73bf803a50e7b71e',
+    'setuptools-0.6c3-py2.5.egg': 'abef16fdd61955514841c7c6bd98965e',
+    'setuptools-0.6c4-py2.3.egg': 'b0b9131acab32022bfac7f44c5d7971f',
+    'setuptools-0.6c4-py2.4.egg': '2a1f9656d4fbf3c97bf946c0a124e6e2',
+    'setuptools-0.6c4-py2.5.egg': '8f5a052e32cdb9c72bcf4b5526f28afc',
+    'setuptools-0.6c5-py2.3.egg': 'ee9fd80965da04f2f3e6b3576e9d8167',
+    'setuptools-0.6c5-py2.4.egg': 'afe2adf1c01701ee841761f5bcd8aa64',
+    'setuptools-0.6c5-py2.5.egg': 'a8d3f61494ccaa8714dfed37bccd3d5d',
+    'setuptools-0.6c6-py2.3.egg': '35686b78116a668847237b69d549ec20',
+    'setuptools-0.6c6-py2.4.egg': '3c56af57be3225019260a644430065ab',
+    'setuptools-0.6c6-py2.5.egg': 'b2f8a7520709a5b34f80946de5f02f53',
+    'setuptools-0.6c7-py2.3.egg': '209fdf9adc3a615e5115b725658e13e2',
+    'setuptools-0.6c7-py2.4.egg': '5a8f954807d46a0fb67cf1f26c55a82e',
+    'setuptools-0.6c7-py2.5.egg': '45d2ad28f9750e7434111fde831e8372',
+    'setuptools-0.6c8-py2.3.egg': '50759d29b349db8cfd807ba8303f1902',
+    'setuptools-0.6c8-py2.4.egg': 'cba38d74f7d483c06e9daa6070cce6de',
+    'setuptools-0.6c8-py2.5.egg': '1721747ee329dc150590a58b3e1ac95b',
+}
+
+import sys, os
+
+def _validate_md5(egg_name, data):
+    if egg_name in md5_data:
+        from md5 import md5
+        digest = md5(data).hexdigest()
+        if digest != md5_data[egg_name]:
+            print >>sys.stderr, (
+                "md5 validation of %s failed!  (Possible download problem?)"
+                % egg_name
+            )
+            sys.exit(2)
+    return data
+
+
+def use_setuptools(
+    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
+    download_delay=15, min_version=None
+):
+    """Automatically find/download setuptools and make it available on sys.path
+
+    `version` should be a valid setuptools version number that is available
+    as an egg for download under the `download_base` URL (which should end with
+    a '/').  `to_dir` is the directory where setuptools will be downloaded, if
+    it is not already available.  If `download_delay` is specified, it should
+    be the number of seconds that will be paused before initiating a download,
+    should one be required.  If an older version of setuptools is installed,
+    this routine will print a message to ``sys.stderr`` and raise SystemExit in
+    an attempt to abort the calling script.
+    """
+    # Work around a hack in the ez_setup.py file from simplejson==1.7.3.
+    if min_version:
+        version = min_version
+
+    was_imported = 'pkg_resources' in sys.modules or 'setuptools' in sys.modules
+    def do_download():
+        egg = download_setuptools(version, download_base, to_dir, download_delay)
+        sys.path.insert(0, egg)
+        import setuptools; setuptools.bootstrap_install_from = egg
+    try:
+        import pkg_resources
+    except ImportError:
+        return do_download()       
+    try:
+        pkg_resources.require("setuptools>="+version); return
+    except pkg_resources.VersionConflict, e:
+        if was_imported:
+            print >>sys.stderr, (
+            "The required version of setuptools (>=%s) is not available, and\n"
+            "can't be installed while this script is running. Please install\n"
+            " a more recent version first, using 'easy_install -U setuptools'."
+            "\n\n(Currently using %r)"
+            ) % (version, e.args[0])
+            sys.exit(2)
+        else:
+            del pkg_resources, sys.modules['pkg_resources']    # reload ok
+            return do_download()
+    except pkg_resources.DistributionNotFound:
+        return do_download()
+
+def download_setuptools(
+    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
+    delay = 15
+):
+    """Download setuptools from a specified location and return its filename
+
+    `version` should be a valid setuptools version number that is available
+    as an egg for download under the `download_base` URL (which should end
+    with a '/'). `to_dir` is the directory where the egg will be downloaded.
+    `delay` is the number of seconds to pause before an actual download attempt.
+    """
+    import urllib2, shutil
+    egg_name = "setuptools-%s-py%s.egg" % (version,sys.version[:3])
+    url = download_base + egg_name
+    saveto = os.path.join(to_dir, egg_name)
+    src = dst = None
+    if not os.path.exists(saveto):  # Avoid repeated downloads
+        try:
+            from distutils import log
+            if delay:
+                log.warn("""
+---------------------------------------------------------------------------
+This script requires setuptools version %s to run (even to display
+help).  I will attempt to download it for you (from
+%s), but
+you may need to enable firewall access for this script first.
+I will start the download in %d seconds.
+
+(Note: if this machine does not have network access, please obtain the file
+
+   %s
+
+and place it in this directory before rerunning this script.)
+---------------------------------------------------------------------------""",
+                    version, download_base, delay, url
+                ); from time import sleep; sleep(delay)
+            log.warn("Downloading %s", url)
+            src = urllib2.urlopen(url)
+            # Read/write all in one block, so we don't create a corrupt file
+            # if the download is interrupted.
+            data = _validate_md5(egg_name, src.read())
+            dst = open(saveto,"wb"); dst.write(data)
+        finally:
+            if src: src.close()
+            if dst: dst.close()
+    return os.path.realpath(saveto)
+
+def main(argv, version=DEFAULT_VERSION):
+    """Install or upgrade setuptools and EasyInstall"""
+    try:
+        import setuptools
+    except ImportError:
+        egg = None
+        try:
+            egg = download_setuptools(version, delay=0)
+            sys.path.insert(0,egg)
+            from setuptools.command.easy_install import main
+            return main(list(argv)+[egg])   # we're done here
+        finally:
+            if egg and os.path.exists(egg):
+                os.unlink(egg)
+    else:
+        if setuptools.__version__ == '0.0.1':
+            print >>sys.stderr, (
+            "You have an obsolete version of setuptools installed.  Please\n"
+            "remove it from your system entirely before rerunning this script."
+            )
+            sys.exit(2)
+
+    req = "setuptools>="+version
+    import pkg_resources
+    try:
+        pkg_resources.require(req)
+    except pkg_resources.VersionConflict:
+        try:
+            from setuptools.command.easy_install import main
+        except ImportError:
+            from easy_install import main
+        main(list(argv)+[download_setuptools(delay=0)])
+        sys.exit(0) # try to force an exit
+    else:
+        if argv:
+            from setuptools.command.easy_install import main
+            main(argv)
+        else:
+            print "Setuptools version",version,"or greater has been installed."
+            print '(Run "ez_setup.py -U setuptools" to reinstall or upgrade.)'
+
+def update_md5(filenames):
+    """Update our built-in md5 registry"""
+
+    import re
+    from md5 import md5
+
+    for name in filenames:
+        base = os.path.basename(name)
+        f = open(name,'rb')
+        md5_data[base] = md5(f.read()).hexdigest()
+        f.close()
+
+    data = ["    %r: %r,\n" % it for it in md5_data.items()]
+    data.sort()
+    repl = "".join(data)
+
+    import inspect
+    srcfile = inspect.getsourcefile(sys.modules[__name__])
+    f = open(srcfile, 'rb'); src = f.read(); f.close()
+
+    match = re.search("\nmd5_data = {\n([^}]+)}", src)
+    if not match:
+        print >>sys.stderr, "Internal error!"
+        sys.exit(2)
+
+    src = src[:match.start(1)] + repl + src[match.end(1):]
+    f = open(srcfile,'w')
+    f.write(src)
+    f.close()
+
+
+if __name__=='__main__':
+    if len(sys.argv)>2 and sys.argv[1]=='--md5update':
+        update_md5(sys.argv[2:])
+    else:
+        main(sys.argv[1:])
+
+
+
+
+
 
=== modified file 'setup.py' (properties changed: -x to +x)
--- setup.py	2008-12-15 22:21:53 +0000
+++ setup.py	2009-03-24 19:51:29 +0000
@@ -1,5 +1,25 @@
-# Copyright 2008 Canonical Ltd.  All rights reserved.
-
+#!/usr/bin/env python
+
+# Copyright 2008-2009 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates.
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+
+import ez_setup
+ez_setup.use_setuptools()
+
+import sys
 from setuptools import setup, find_packages
 
 # generic helpers primarily for the long_description
@@ -16,9 +36,13 @@
     return '\n'.join(res)
 # end generic helpers
 
+
+sys.path.insert(0, 'src')
+from lazr.delegates import __version__
+
 setup(
     name='lazr.delegates',
-    version='1.0b1',
+    version=__version__,
     namespace_packages=['lazr'],
     packages=find_packages('src'),
     package_dir={'':'src'},
@@ -26,7 +50,7 @@
     zip_safe=False,
     maintainer='LAZR Developers',
     maintainer_email='[e-mail]',
-    description=open('README.txt').readlines()[0].strip(),
+    description=open('README.txt').readline().strip(),
     long_description=generate(
         'src/lazr/delegates/README.txt',
         'src/lazr/delegates/CHANGES.txt'),
@@ -36,10 +60,17 @@
         'zope.interface',
         ],
     url='https://launchpad.net/lazr.delegates',
+    download_url= 'https://launchpad.net/lazr.delegates/+download',
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)",
         "Operating System :: OS Independent",
         "Programming Language :: Python"],
+    extras_require=dict(
+        docs=['Sphinx',
+              'z3c.recipe.sphinxdoc']
+    ),
+    setup_requires=['eggtestinfo', 'setuptools_bzr'],
+    test_suite='lazr.delegates.tests',
     )
 
=== modified file 'src/lazr/__init__.py'
--- src/lazr/__init__.py	2008-12-15 22:21:53 +0000
+++ src/lazr/__init__.py	2009-03-24 19:51:29 +0000
@@ -1,4 +1,18 @@
 # Copyright 2008 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates.
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
 
 # this is a namespace package
 try:
 
=== modified file 'src/lazr/delegates/CHANGES.txt'
--- src/lazr/delegates/CHANGES.txt	2008-12-15 22:21:53 +0000
+++ src/lazr/delegates/CHANGES.txt	2009-03-24 19:51:29 +0000
@@ -2,7 +2,14 @@
 Changes
 =======
 
-1.0b1 (2008-12-08)
+1.0.1 (2009-03-24)
 ==================
 
+- specify only v3 of LGPL
+
+- build/developer improvements
+
+1.0 (2008-12-19)
+================
+
 - Initial release
 
=== modified file 'src/lazr/delegates/README.txt'
--- src/lazr/delegates/README.txt	2008-12-15 22:21:53 +0000
+++ src/lazr/delegates/README.txt	2009-03-24 19:51:29 +0000
@@ -1,3 +1,18 @@
+..
+    This file is part of lazr.delegates.
+
+    lazr.delegates is free software: you can redistribute it and/or modify it
+    under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, version 3 of the License.
+
+    lazr.delegates is distributed in the hope that it will be useful, but
+    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+    License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+
 The ``lazr.delegates`` Package
 ******************************
 
@@ -39,7 +54,7 @@
     ...     baz = 'hi baz!'
 
 SomeClass can implement IFoo by delegating to an instance of BaseFoo
-stored in the 'context' attribute. Note that ``delagates`` takes the
+stored in the 'context' attribute. Note that ``delegates`` takes the
 interface as the argument. By default, 'context' is the attribute
 containing the object to which the interface implementation is
 delegated.
@@ -170,3 +185,13 @@
     Traceback (most recent call last):
     ...
     NotImplementedError
+
+===============
+Other Documents
+===============
+
+.. toctree::
+   :glob:
+
+   *
+   docs/*
 
=== added file 'src/lazr/delegates/__init__.py'
--- src/lazr/delegates/__init__.py	1970-01-01 00:00:00 +0000
+++ src/lazr/delegates/__init__.py	2009-03-24 19:51:29 +0000
@@ -0,0 +1,30 @@
+# Copyright 2008 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates.
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+
+"""Decorator helpers that simplify class composition."""
+
+__version__ = 1.0
+
+# Re-export in such a way that __version__ can still be imported if
+# dependencies are not yet available.
+try:
+    # While we generally frown on "*" imports, this, combined with the fact we
+    # only test code from this module, means that we can verify what has been
+    # exported.
+    from lazr.delegates._delegates import *
+    from lazr.delegates._delegates import __all__
+except ImportError:
+    pass
 
=== renamed file 'src/lazr/delegates/__init__.py' => 'src/lazr/delegates/_delegates.py'
--- src/lazr/delegates/__init__.py	2008-12-15 22:21:53 +0000
+++ src/lazr/delegates/_delegates.py	2009-03-24 19:51:29 +0000
@@ -1,4 +1,18 @@
 # Copyright 2008 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates.
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
 
 """Decorator helpers that simplify class composition."""
 
 
=== added directory 'src/lazr/delegates/tests'
=== added file 'src/lazr/delegates/tests/__init__.py'
--- src/lazr/delegates/tests/__init__.py	1970-01-01 00:00:00 +0000
+++ src/lazr/delegates/tests/__init__.py	2009-03-24 19:51:29 +0000
@@ -0,0 +1,16 @@
+# Copyright 2008 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates.
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+"""Tests for lazr.delegates"""
 
=== renamed file 'src/lazr/delegates/tests.py' => 'src/lazr/delegates/tests/test_docs.py'
--- src/lazr/delegates/tests.py	2008-12-15 22:21:53 +0000
+++ src/lazr/delegates/tests/test_docs.py	2009-03-24 19:51:29 +0000
@@ -1,17 +1,51 @@
-# Copyright 2008 Canonical Ltd.  All rights reserved.
+# Copyright 2008-2009 Canonical Ltd.  All rights reserved.
+#
+# This file is part of lazr.delegates
+#
+# lazr.delegates is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, version 3 of the License.
+#
+# lazr.delegates is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with lazr.delegates.  If not, see <http://www.gnu.org/licenses/>.
+"Test harness for doctests."
 
-"""Test harness."""
+# pylint: disable-msg=E0611,W0142
 
 __metaclass__ = type
-__all__ = []
+__all__ = [
+    'additional_tests',
+    ]
 
+import atexit
 import doctest
+import os
+from pkg_resources import (
+    resource_filename, resource_exists, resource_listdir, cleanup_resources)
 import unittest
 
-
-def test_suite():
+DOCTEST_FLAGS = (
+    doctest.ELLIPSIS |
+    doctest.NORMALIZE_WHITESPACE |
+    doctest.REPORT_NDIFF)
+
+
+def additional_tests():
+    "Run the doc tests (README.txt and docs/*, if any exist)"
+    doctest_files = [
+        os.path.abspath(resource_filename('lazr.delegates', 'README.txt'))]
+    if resource_exists('lazr.delegates', 'docs'):
+        for name in resource_listdir('lazr.delegates', 'docs'):
+            if name.endswith('.txt'):
+                doctest_files.append(
+                    os.path.abspath(
+                        resource_filename('lazr.delegates', 'docs/%s' % name)))
+    kwargs = dict(module_relative=False, optionflags=DOCTEST_FLAGS)
+    atexit.register(cleanup_resources)
     return unittest.TestSuite((
-        doctest.DocFileSuite(
-            'README.txt',
-            optionflags=doctest.NORMALIZE_WHITESPACE,),
-        ))
+        doctest.DocFileSuite(*doctest_files, **kwargs)))