in-line doc edit: s/pyutil/allmydata.util/

import version class and make-version script from pyutil -- fixes win32 build, improves error handling, and eliminates unused features

a first crack at the "put" command-line
There are actually two versions in this patch, one of which requires twisted.web2 and the other of which uses the Python standard library's socket module.  The socketish one doesn't know when the web server is done so it hangs after doing its thing.  (Oh -- maybe I should add an HTTP header asking the web server to close the connection when finished.)  The web2ish one works better in that respect.  Neither of them handle error responses from the server very well yet.

After lunch I intend to finish the socketish one.

To try one, mv src/allmydata/scripts/tahoe_put-{socketish,web2ish}.py src/allmydata/scripts/tahoe_put.py .

If you want to try the web2ish one, and you can't find a web2 package to install, you can get one from:

http://allmydata.org/~zooko/repos/twistedweb2snarf/

Makefile: add build_ext target, for convenience

webish.py: allow users to delete (but not create) empty-named files. Closes #94.

webish: implement replace= for POST commands

webish: implement replace= for PUT commands

IDirectoryNode: add has_child() method

check_memory.py: Disable the 100MB test for now: our buildslave can't currently handle it because the testnet/framework processes uses something like 600M of RSS.

webapi.txt: specify replace= behavior on all PUT and POST commands

webapi.txt: clear up underspecified items, replace 'webpassword' paragraph
with a section about our expected plans for #98, add more introductory text
to the sections on manipulate-file vs manipulate-directory.

webapi.txt: shorter and hopefully clearer description of names vs. identifiers
Brian (and anyone who has an interest in the API and documentation): please review.

client.py: make a note in the logs when the auto-shutdown feature is in use

webish: look for when_done= in POST fields as well as queryargs. Closes #101.

We need to look in the fields because that's how we build the mkdir/upload
forms. Without this, uploading or creating directories would leave us on a
page that had just a URI, instead of something actually useful to a human.

docs/configuration.txt: explain the files in the node's basedir, which ones are useful to modify, etc

fix pyflakes warnings from recent b32decode change

test_system.py: add coverage for get_permuted_peers()

Client.get_permuted_peers: use self.nodeid now that it's fixed

shorten ids

don't over-encode the nodeid many times with ascii-encoding

ymy name...

foolscap: change using-foolscap.xhtml to say "public key" instead of "private key"
In the first instance, I hope that the tubid is generated from the hash of the public key and not the hash of the private key!
In the latter instances, the phrase "public key" as in "public key certificate" is more common.

webish: localfile=/localdir= are now disabled by default, a special switch is required to enable them

webapi.txt: separate out debug/test commands, indicate that localfile=/localdir= requires special activation

webish: reduce POST memory footprint by overriding http.Request

The original twisted.web.http.Request class has a requestReceived method
that parses the form body (in the request's .content filehandle) using
the stdlib cgi.parse_multipart() function. parse_multipart() consumes a
lot of memory when handling large file uploads, because it holds the
arguments entirely in RAM. Nevow's subclass of Request uses cgi.FieldStorage
instead, which is much more memory-efficient.

This patch uses a local subclass of Request and a modified copy of the
requestReceived method. It disables the cgi.parse_multipart parsing and
instead relies upon Nevow's use of FieldStorage. Our code must look for
form elements (which come from the body of the POST request) in req.fields,
rather than assuming that they will be copied into req.args (which now
only contains the query arguments that appear in the URL).

As a result, memory usage is no longer inflated by the size of the file
being uploaded in a POST upload request. Note that cgi.FieldStorage uses
temporary files (tempfile.TemporaryFile) to hold the data.

This closes #29.

webish.POSTHandler: fix typo that meant we didn't look for 'name' in req.fields

webapi.txt: minor clarifications and examples

boringfile: ignore the setuptools .egg that ez_setup.py likes to download/build/install during compilation

Makefile: add 'upload-self' pass to check-memory

#96: add flag to enable pushing data to ourselves, defaulting to False

encode.py: log a percentage complete as well as the raw byte counts

Encoder.__repr__: mention the file being encoded

encode.py: add a reactor turn barrier between segments, to allow Deferreds to retire and free their arguments, all in the name of reducing memory footprint

webapi.txt: put back the manifest feature
So that we can compare versions of webapi.txt with and without this documentation, side by side.

webapi.txt: put back the localfile feature
So that we can compare versions webapi.txt with and without this documentation side by side.

webapi.txt: add URI-based GET variants

webapi.txt: some editing, and remove the localfile feature and the manifest feature
My motivation to remove these features is as per:

http://allmydata.org/pipermail/tahoe-dev/2007-August/000067.html

However, I haven't heard back from Brian yet, so I'm actually going to put them back in the next patch so that I can compare the two versions of webapi.txt side by side.

webapi.txt: further refactoring and add a section explaining TOCTTOU bugs and how to avoid them by using URIs

webapi.txt: further refactoring and editing to clarify the fact that you don't know whether a thing is a file or a directory before you fetch it

webapi.txt: add "?t=file" flag and reorganize doc to discourage people from thinking that they know before hand the file-or-dir type of the thing that they are naming

fix test_web refactoring so that the WebMixin class isn't a TestCase
Thanks, Brian.

If do_stop attempts to stop a nonexistent process the OSError exception is caught (by errno) and handled tersely.

refactor test_web so that other tests can use the part of test_web that sets up a simple filesystem

introducer: don't log.err() an initial connection failure, since that flunks tests. Use self.log() instead. Also improve test_client.py to always trigger this case, before it was finishing to quickly to always hit the problem.

check_memory.py: include a single 100MB test

munin/tahoe-storagespace.py: use /bin/du instead of our python version, since
it a) is faster and b) will include filesystem overhead that is a real cost.

webapi.txt: update rfc reference

zfec: required version of setuptools is 0.6c6 on cygwin, 0.6a9 on other platforms

zfec: default setuptools version is now 0.6c6

zfec: add benchmark utility

zfec: add to README.txt how to run the unit tests

zfec: fix link to zfec-dev mailing list

zfec: fix README.txt to explain how to use setuptools with GNU stow better
Also remove requirement of setuptools >= v0.6c3.  I *think* that using setuptools in the modern way relieves this requirement, but I haven't tested it on dapper yet.

zfec: clarify licensing requirements (transitive grace period)

zfec: shebang usr bin env python in ez_setup.py

zfec: update doc strings in fileutil

fix iputil so that it doesn't launch dozens of processes when you give it a full path and so that it tries executables in preference order and stops as soon as one gives out a dotted-quad string

in --> across

cleaning grammar

/twistd.log -> /logs/twistd.log

misc/sizes.py: rename "block" to "share" and "subblock" to "block"
This renaming is already in place in all of our other documentation and code, but misc/sizes.py got overlooked.

architecture.txt: small edits

startstop_node now works if the logs directory already exists
Thanks to Arno and Arch for pointing this out.

README: formatting (line-wrapping) of arch_o_median's edits to README

changed README to inslude simplejson in "The Python Way" install

changed MakeFile to install simplejson

edited README "The Python Way" installs to /usr/bin

README: clarify/edit build, install, and test instructions

clarify licence

README: point people to allmydata.org if they are looking for precompiled packages

README: edit to arch_o_median's contribution re: installing the Python way

README: add note about what "darcs get" will do and how to run "darcs pull"

changed README install "Python Way" section

now that the buildslave is moved to a new machine, enable the 50MB test

foolscap: fix .deb-breaking bug (foolscap.lothar.com: #8)

update foolscap to foolscap-0.1.5, the latest release

shebang /usr/bin/env python in ez_setup.py
This makes it so that "./ez_setup.py" works on more platforms.

fix missing import -- this bug was introduced by the recent patch to relax setuptools version requirements

in relnotes.txt, make the safety warnings slightly less scary

and update the reference to the wiki's UseCases page

require setuptools >= 0.6c6 on cygwin, and >= 0.6a9 on other platforms

Earlier I tried 0.6a9 (which comes in .deb format on Dapper) and something
didn't work, so I raised it to 0.6c3.  However, I didn't make a note of what
failed, and so now I'm hoping that what failed was cygwin-specific.  Anyway,
everyone look out for setuptools compatibility problems on the your favorite
platform (and I'll check the buildslaves), and we'll raise the required version
as little as possible and only on the problematic platform.

update Arno's entry in CREDITS

update README to reflect existence of "make install" target

update README to reflect requirement of setuptools 0.6c6

add install target, works at lest on sudo-free cygwin

setuptools upgrade to 0.6c6

refactor test_uri and add a test of the empty file

move nodelogs from BASEDIR/twistd.log* to BASEDIR/logs/twistd.log*, closes #61

test_web.py: oops, fix syntax error caused by removing comments

test_web.py: remove spurious '# YES' lines, now that all the tests pass

vdrive: eventually create public/private dirnodes event if the vdrive server isn't available at start up

interfaces: move signatures into docstrings, to reduce lines of code and improve code-coverage numbers

remove unused imports: hush pyflakes warnings

switch from rfc 3548 base-32 to z-base-32 except for tubids/nodeids

URI: we now derive the storage index from the encryption key

refactor upload/encode, to split encrypt and encode responsibilities

update architecture.txt a little bit

truncate storage index to 128 bits, since it's derived from a 128 bit AES key

small edit of relnotes

update relnotes.txt to reflect NJS's comments

CHK: remove the storage index from the URI, deriving it from the key instead