setup: fix site-dirs to find system installed twisted on mac.

zooko helped me unravel a build weirdness today.  somehow the system installed
twisted (/System/Library) was pulling in parts of the other twisted (/Library)
which had been installed by easy_install, and exploding.

getting rid of the latter helped, but it took this change to get the tahoe
build to stop trying to rebuild twisted and instead use the one that was
already installed. c.f. tkt #229

CLI: rework webopen, and moreover its tests w.r.t. path handling

in the recent reconciliation of webopen patches, I wound up adjusting
webopen to 'pass through' the state of the trailing slash on the given
argument to the resultant url passed to the browser.  this change
removes the requirement that arguments must be directories, and allows
webopen to be used with files.  it also broke the tests that assumed
that webopen would always normalise the url to have a trailing slash.

in fixing the tests, I realised that, IMHO, there's something deeply
awry with the way tahoe handles paths; specifically in the combination
of '/' being the name of the root path within an alias, but a leading
slash on paths, e.g. 'alias:/path', is catagorically incorrect. i.e.
 'tahoe:' == 'tahoe:/' == '/'
but 'tahoe:/foo' is an invalid path, and must be 'tahoe:foo'

I wound up making the internals of webopen simply spot a 'path' of
'/' and smash it to '', which 'fixes' webopen to match the behaviour
of tahoe's path handling elsewhere, but that special case sort of
points to the weirdness.

(fwiw, I personally found the fact that the leading / in a path was
disallowed to be weird - I'm just used to seeing paths qualified by
the leading / I guess - so in a debate about normalising path handling
I'd vote to include the /)

CLI: reconcile webopen changes

I think this is largely attributable to a cleanup patch I'd made
which never got committed upstream somehow, but at any rate various
conflicting changes to webopen had been made. This cleans up the
conflicts therein, and hopefully brings 'tahoe webopen' in line with
other cli commands.

cli: cleanup webopen command

moved the body of webopen out of cli.py into tahoe_webopen.py

made its invocation consistent with the other cli commands, most
notably replacing its 'vdrive path' with the same alias parsing,
allowing usage such as 'tahoe webopen private:Pictures/xti'

macapp: changed to remove 'Tahoe' from .app name

Change the build product from 'Allmydata Tahoe' to 'Allmydata'
more inkeeping with the branding of the Allmydata product

add --syslog argument to 'tahoe start' and 'tahoe restart', used to pass --syslog to twistd for non-Tahoe nodes (like cpu-watcher)

misc/make-canary-files.py: tool to create 'canary files', explained in the docstring

webapi: survive slashes in filenames better: make t=info and t=delete to work, and let t=rename fix the problem

setup: when detecting platform, ask the Python Standard Library's platform.dist() before executing lsb_release, and cache the result in global (module) variables
This should make it sufficiently fast, while still giving a better answer on Ubuntu than platform.dist() currently does, and also falling back to lsb_release if platform.dist() says that it doesn't know.

node.py: add BASEDIR/keepalive_timeout and BASEDIR/disconnect_timeout, to set/enable the foolscap timers, for #521

setup: stop catching EnvironmentError when attempting to copy ./_auto_deps.py to ./src/allmydata/_auto_deps.py
It is no longer the case that we can run okay without _auto_deps.py being in place in ./src/allmydata, so if that cp fails then the build should fail.

immutable: remove unused imports (thanks, pyflakes)

immutable: refactor immutable filenodes and comparison thereof
* the two kinds of immutable filenode now have a common base class
* they store only an instance of their URI, not both an instance and a string
* they delegate comparison to that instance

setup: try parsing /etc/lsb-release first, then invoking lsb_release, because the latter takes half-a-second on my workstation, which is too long
Also because in some cases the former will work and the latter won't.
This patch also tightens the regexes so it won't match random junk.

setup: fix a cut-and-paste error in the fallback to parsing /etc/lsb-release

setup: if executing lsb_release doesn't work, fall back to parsing /etc/lsb-release before falling back to platform.dist()
An explanatio of why we do it this way is in the docstring.

setup: if invoking lsb_release doesn't work (which it doesn't on our etch buildslave), then fall back to the Python Standard Library's platform.dist() function

setup: fix bug in recent patch to use allmydata.get_package_versions() to tell the foolscap app-version-tracking what's what

setup: when using the foolscap "what versions are here?" feature, use allmydata.get_package_versions() instead of specifically importing allmydata, pycryptopp, and zfec

setup: simplify the implementation of allmydata.get_package_versions() and add "platform" which is a human-oriented summary of the underlying operating system and machine

misc/make_umid: change docs, make elisp code easier to grab

use foolscap's new app_versions API, require foolscap-0.3.1

BASEDIR/nickname is now UTF-8 encoded

various: use util.log.err instead of twisted.log.err, so we get both Incidents and trial-test-flunking

logging.txt: explain how to put log.err at the end of Deferred chains, explain FLOGTOTWISTED=1

util.log: send log.err to Twisted too, so that Trial tests are flunked

setup.py trial: improve --verbose suggestion a bit

test_cli: disable generate-keypair test on OS-X, pycryptopp still has a bug

NEWS: finish editing for the upcoming 1.3.0 release

NEWS: more edits, almost done

NEWS: describe all changes since the last release. Still needs editing.

CLI: add 'tahoe admin generate-keypair' command

web: add 'more info' pages for files and directories, move URI/checker-buttons/deep-size/etc off to them

setup.py: remove unused 'Extension' import

setup.py,Makefile: move the 'chmod +x bin/tahoe' into setup.py

docs/install.html: reference InstallDetails instead of debian-specific stuff

Makefile,docs: tahoe-deps.tar.gz now lives in separate source/deps/ directory on http://allmydata.org

docs: mention -SUMO tarballs, point users at release tarballs instead of development ones

setup.py,Makefile: teat sdist --sumo about tahoe-deps/, use -SUMO suffix on tarballs, add sumo to 'make tarballs' target

.darcs-boringfile ignore tahoe-deps and tahoe-deps.tar.gz

docs: add a note about the process of making a new Tahoe release

Makefile: pyutil from a dependent lib causes a #455-ish problem, the workaround is to run build-once *three* times

Makefile: desert-island: don't re-fetch tahoe-deps.tar.gz if it's already there, remove the tahoe-deps/ before untarring directory to avoid unpacking weirdness

misc/check-build.py: ignore the 'Downloading file:..' line that occurs for the setup_requires= -triggered handling of the setuptools egg

#249: add 'test-desert-island', to assert that a tahoe-deps.tar.gz -enabled build does not download anything

#249: get dependent libs from tahoe-deps and ../tahoe-deps

#249: move dependent libs out of misc/dependencies/, get them from tahoe-deps.tar.gz instead

conf_wiz.py - updating version numbers in file, should really get these from a TAG or conf file

webish: add an extra newline to JSON output

windows/Makefile: fix dependencies: windows-installer must cause windows-exe to run

Makefile: fix windows issues

Makefile: use run_with_pythonpath, move windows targets into a separate Makefile

setup.py: add 'setup.py run_with_pythonpath', to run other commands with PYTHONPATH set usefully

Makefile: convert check-auto-deps target into 'setup.py check_auto_deps'

startstop_node.py: find twistd in our supportlib if we had to build Twisted as a setuptools dependency. This is a form of cgalvan's #505 patch, simplified because now 'setup.py trial' takes care of sys.path and PYTHONPATH

rewrite parts of the Makefile in setup.py. Add 'build_tahoe' and 'trial' subcommands.

The 'make build' target now runs 'setup.py build_tahoe', which figures out
where the target 'supportlib' directory should go, and invokes 'setup.py
develop' with the appropriate arguments.

The 'make test' target now runs 'setup.py trial', which manages sys.path and
runs trial as a subroutine instead of spawning an external process. This
simplifies the case where Twisted was built as a dependent library (and thus
the 'trial' executable is not on PATH).

setup.py now manages sys.path and PYTHONPATH for its internal subcommands, so
the $(PP) prefix was removed from all Makefile targets that invoke setup.py .
For the remaining ones, the 'setup.py -q show_pythonpath' subcommand was
added to compute this prefix with python rather than with fragile
shell/Makefile syntax.

bin/tahoe: reflow error messages

mac/Makefile: remove the verbose hdiutil diagnostics now that we resolved the problem

Makefile: give setup.py develop a '--site-dirs' arg to work around the #249 setuptools bug which causes us to unnecessarily rebuild pyopenssl and other support libs installed via debian's python-support. Should be harmless on other platforms.

web: fix output=JSON, add buttons for repair/json to the 'run deep-check' form

disallow deep-check on non-directories, simplifies the code a bit

dirnode: refactor recursive-traversal methods, add stats to deep_check() method results and t=deep-check webapi

dirnode: cleanup, make get_verifier() always return a URI instance, not a string

test_system: check t=deep-stats too

test_system: add deep-check-JSON tests, fix a bug

test_system: oops, re-enable some tests that got bypassed

test_system: add deep-stats test

hush pyflakes

checker results: add output=JSON to webapi, add tests, clean up APIs
to make the internal ones use binary strings (nodeid, storage index) and
the web/JSON ones use base32-encoded strings. The immutable verifier is
still incomplete (it returns imaginary healty results).

immutable verifier: provide some dummy results so deep-check works, make the tests ignore these results until we finish it off

mutable checker: even more tests. Everything in ICheckerResults should be covered now, except for immutable-verify which is incomplete

checker results: more tests, update interface docs

mutable checker: oops, fix redefinition of 'healthy' (numshares < N, not numshares < k, which is 'recoverable' not 'healthy')

checker results: more tests, more results. immutable verifier tests are disabled until they emit more complete results

checker: add tests, add stub for immutable check_and_repair

interfaces.py: minor improvement to IDirectoryNode.set_node

mac/Makefile: upload the .dmg file with foolscap xfer-client.py instead of scp

misc/xfer-client.py: small foolscap utility to transfer a file to a waiting server

setup: add excited DEVELOPER NOTE to install.html
It should be removed before 1.3.0 release, of course...

setup: edit the text of install.html

setup: add link to the DownloadDebianPackages page
Because I want that link off of the front page of the wiki...

setup: change URL from which to get source tarballs
So that when you look at that directory you won't see distracting other things such as darcs repositories.

test_system: make log() tolerate the format= form

immutable/checker: make log() tolerate the format= form

checker: overhaul checker results, split check/check_and_repair into separate methods, improve web displays

webapi.txt: explain that t=manifest gives verifycaps

introducer: add get_nickname_for_peerid

docs/logging.txt: explain tahoe/foolscap logging. Addresses #239.

setup: don't assert that trial is present when the Makefile is evaluated
This should fix #506, but it means that if (for some weird reason) Twisted can't be auto-installed and the find_trial.py script doesn't work, the user will get a weird failure message instead of a clean failure message explaining that trial couldn't be found.  Oh well.

Chris Galvan is working on a much nicer fix to all these issues -- see #505.

testutil.PollMixin: use a custom exception (and convert it) to avoid the ugly 'stash' cycle

mac/Makefile: more attempts to debug the buildslave failure

mac: add -verbose to the hdiutil call, to figure out why it's failing on the buildslave

setup: simplify parsing of python version number

setup: emit the version of python in the list of versions

munin: add tahoe_diskleft plugin, update spacetime/diskwatcher.tac to support it

docs: how_to_make_a_tahoe_release.txt
Just some cryptic notes to self, but if I get hit by a truck then someone else might be able to decode them.

debian: include misc/cpu-watcher.tac in the debian package

munin/tahoe_doomsday: change the graph title, 'time predictor' is more accurate than 'space predictor'

munin/tahoe_diskusage: clip the graph at zero, to prevent transient negative excursions (such as when a lot of old logfiles are deleted from a storage server's disk) from scaling the graph into unusability

CREDITS: thanks to Chris Galvan