pip and tiddlyweb and tiddlywebwiki bundles

[Chris Dent]

The default instructions for installing TiddlyWeb and its associated
pieces involves using easy_install[1] to install the package from PyPI
[2]. easy_install handles the process of finding, downloading and
installing dependent packages (such as simplejson).

pip[3] is a more modern (and maintained) tool that performs many of
the same functions as easy_install. Where one does:

easy_install -U tiddlywebwiki

it is also possible to do:

pip install -U tiddlywebwiki

pip also has support for something it calls bundles. These are zipped
archives of all the Python packages that are needed to install
something. For hosts that are not connected to the open internet or
otherwise can't take advantage of PyPI, these bundles can simplify
installation.

Assuming one has pip installed (see [3]) it is fairly easy to make a
bundle. On an internet connected host do:

pip bundle tiddlywebwiki.bundle tiddlywebwiki

This will download all the required source files and package them up
into a file called tiddlywebwiki.bundle. You can then take that file
to another machine and install it with:

sudo pip install -U tiddlywebwiki.bundle

If you are using virtualenv[4] pip can install the bundle into just
the virtualenv, if you desire.

Starting with today's releases of tiddlyweb and tiddlywebwiki I will
be packaging up bundles of both and distributing them from http://tiddlyweb.peermore.com/dist/

The bundles have datestamps in the filename. Take the one with the
most recent date. If you are using tiddlywebwiki, you do _not_ need
the tiddlyweb one, all the necessary stuff is included.

[1] http://pypi.python.org/pypi/setuptools
[2] http://pypi.python.org/
[3] http://pypi.python.org/pypi/pip
[4] http://pypi.python.org/pypi/virtualenv