fix test_cli to put the root_dir.cap in the private subdir

cmdline: give useful error messages about the --dir-uri and ~/.tahoe/private/root_dir.cap

a few formatting tidy-ups

test_client.py: validate more versioning code

test_client.py: assert allmydata.__version__ is not unknown

Makefile: run 'make-version' at least once, in the 'build' target, to make sure we populate src/allmydata/_version.py

remove automatic private dir
 * rename my_private_dir.cap to root_dir.cap
 * move it into the private subdir
 * change the cmdline argument "--root-uri=[private]" to "--dir-uri=[root]"

add human-encodings of caps, refactor encodings of caps, tighten checks, fix unit tests to use values of the right size

add regexes to idlib to match certain kinds of base32-encoded values

fix idlib.could_be_base32_encoded_l() to accept *only* valid strings

refactor constructing URI objects from strings and add human-encoding of WriteableSSKFileURI

docs/Makefile: rules to turn our SVG images into .png and .eps forms

debian: update dependencies to match calc-deps.py, mainly pycryptopp-0.2.8

running.html: fix usage of 'tahoe create-client' and 'tahoe start', explain ~/.tahoe, add closing tags

README: update required version numbers, fix small cut-and-paste error

docs: update install.html and update and format running.html

setup: add back "build-deps" as an alias for "build-auto-deps" since I don't know how to configure the buildmaster
And I am very tired.

setup: whoops, fix the use of source-tree-root-dir eggs in our Makefile

docs: a couple of improvements to install.html

setup: fix bin/tahoe to include .egg's from the source tree root dir as well
This is necessary, as we can't prevent setuptools from respecting any such eggs, therefore we need to respect them in order to maintain consistency.  However, we don't normally install any "install_requires" eggs into the source tree root dir.

setup: rename build-deps to build-auto-deps

setup: "make" now defaults to "simple-build", which depends on build-deps
This is for conformance with the simple new install.html.  People who don't want build-deps can run "make build".

setup: clean up darcsver egg on "make clean"

setup: update the list of files that we think are boring when we are using darcs

setup: finish renaming of docs/testnet to docs/testgrid

setup: use darcsver instead of pyutil for darcsver, use setup.py plugin instead of executable for darcsver
This hopefully fixes the deb builders.

setup: add darcsver source tarball to misc/dependencies
In the future, we're likely to stop keeping misc/dependencies under revision control, as per

http://allmydata.org/trac/tahoe/ticket/249

docs: even further simplify and reformat install.html

docs: format install.html into HTML format

docs: a bunch of updates to simplify the process of installing from source and running Tahoe
These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files
are complete and should work (and they are delightfully concise!).  I'm pushing this just to let people see incremental progress
and to solicit feedback.  "Testing out" the install.html and running.html files and submitting patches or bug reports would be
quite welcome.

More to come.

docs: a few updates, edits, and formatting tweaks to README.win32

refactor webish.py slightly, improve the test coverage a bit. One test is marked SKIP pending improvements in webish.py

test_web.py: fix pyflakes error

webish: use get_args() everywhere, put .fields=None in MyRequest

test_web: more coverage of URIPOSTHandler error cases

test_web: test POST_upload_no_link against /uri, not /uri/

test_web.py: use /uri?t=mkdir instead of /uri/?t=mkdir, and confirm that the redirection target is correct

webish: factor out queryargs-or-formargs extraction, make /uri?t=mkdir work and redirect to a valid url

node.py: remove the provoke-logport-furlfile-creation hack now that foolscap-0.2.3 does it for us, and add bridge-twisted-logs

upgrade to foolscap-0.2.3

Makefile: put an existing PYTHONPATH in front of our generated EGGSPATH, to make it easier to test tahoe against development versions of dependent libraries

setup: allow shell built-ins "true" and "false" so that I can experiment with deb builders on an OSX box.  ;-)

setup: fix bug in bugfix to patch to include .egg's found in CWD

setup: fix bug in previous patch to include .egg's from CWD

setup: we also need to include .egg's in the CWD in our search path, because if we install a 3rd party library into support/, and *it* installs a library that *it* requires, that one will appear in CWD
It would be nice to figure out a way to force them to all appear in support/ where they belong.

setup: zope.interface bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: upgrade bundle zfec-1.1.tar.gz to zfec-1.3.4.tar

setup: simplejson bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: upgrade bundle from setuptools_darcs-1.0.6.tar.gz to setuptools_darcs-1.1.5.tar

setup: bundle pyutil-1.3.12.tar

setup: pycryptopp: bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: foolscap bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: bundle argparse-0.8.0.tar
It isn't actually needed for Tahoe, only for the command-line tools from pyutil.  Later I will make an "extras" category within pyutil to specify in a machine-readable way that argparse is not required for pyutil unless you want the command-line tools.

setup: Nevow bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: update doc in __init__.py

setup: small tidy-up of Make rules

setup: refactor ez_setup.py and setup.py to satisfy the Desert Island scenario, to find and use setuptools egg in-place in misc/dependencies, and make it setup_require pyutil (for darcsver)

setup: copy in the latest version of ez_setup.py, which works even if setuptools is already imported, or can be imported, into the current Python interpreter, but can't be imported into a new Python interpreter in a subprocess
This actually happens in practice -- this fixes the Desert Island scenario.  Thanks to PJE.

setup: bundle setuptools_darcs plugin in misc/dependencies

setup: new name for setuptools_darcs plugin is also boring

setup: finish switching from Tahoe's versions of autoversioning tools to pyutil's versions

setup: remove misc/make-version.py and invoke "darcsver" from the pyutil library
misc/make-version.py has a limitation which prevents it from generating version
stamps from our current darcs history.  This limitation has been fixed in
pyutil's "darcsver".  Rather than copy the fix from there to
misc/make-version.py, I'm making it so that you have to install pyutil if you
want to automatically generate _version.py files from the current darcs
history.

setup: fix scheme ("file:") for download base for boostrapping setuptools

setup: fix typo in name of download base for bootstrapping setuptools

setup: fix the name of "misc/dependencies" for bootstrapping setuptools

setup: use os.path.join('misc', 'dependencies') instead of "misc/dependencies"
In the hopes that this will make the boostrapping of setuptools from its bundled egg work on Windows.

webish: add button to make directories and unit test of it
Unfortunately although it passes the unit tests, it doesn't work, because the unit tests and the implementation use the "encode params into URL" technique but the button uses the "encode params into request body" technique.

make the unit test of the overwrite button more general

make the wapi/wui [*] support creation of a new directory without there already being an existing directory to link the new one into

[*] WebAPI/WebUI

mutable: always include ourselves in the querylist when Publishing, because 0.7.0 usually stores our root dirnode only on ourselves, and our nodeid might not appear in the first N+epsilon peers

mutable.py: one more logging fix

mutable.py: oops, our logging wrappers can't take posargs yet

mutable.Publish: improve logging

dirnode: add set_uris() and set_nodes() (plural), to set multiple children at once. Use it to set up a new webapi test for issue #237.

node: provoke foolscap-0.2.2 into saving logport.furl, so we can attach to it with 'flogtool dump'. Also, place it in private/, since logs are considered somewhat private

fix representation of node ids in PeerTracker objects

remove some no-longer needed replacements of "/" with "!" in uris

more new-pyflakes warnings fixed

the new pyflakes is stricter, complaining about function definitions that overshadow earlier definitions or imports. Fix some of its complaints.

hush pyflakes

create_node.py: need to create private/ dir in create-client so we can touch the my_private_dir.cap file

oops, touch private/my_private_dir.cap when creating the client

check_load: add stats-gathering

add a simple load-generating tool to do random reads and writes

move my_private_dir.cap into private/

my_private_dir.cap: add newline for readability, open with mode 'w' not 'w+' since we don't need to read from this filehandle

remove the slash-to-bang conversion from CLI tools and webapi.txt

unit test that POST /uri/?t=mkdir works

remove the DirnodeURI foolscap schema and mv those regexes into uri.py
We currently do not pass dirnode uris over foolscap.

make more precise regexp for WriteableSSKFileURI and DirnodeURI and use it in unit tests
Also allow an optional leading "http://127.0.0.1:8123/uri/".
Also fix a few unit tests to generate bogus Dirnode URIs of the modern form instead of the former form.

fix unit tests to assert that we do *not* link to start.html when there is no private dir, instead of asserting that we *do*

do not put a link from the welcoXme page to the start.html if there is not a private directory

rename "my_private_dir.uri" to "my_private_dir.cap"

rename "secret" to "lease_secret" and change its size from 16 to 32 bytes

put all private state in $BASEDIR/private
fixes #219

The only part of #219 that this doesn't include is the part about
logpublisher, which has been moved out of tahoe into foolscap.

we no longer need to replace "/" with "!" in urls

tidy-up some comments and logging messages

fix the overwrite button and add unit test for it

test_system.py: oops, match change in RIControl

test_web.py: cosmetic, remove leftover trailing space