annotate python/venvit.py @ 107:1da1baa03ac1

add a cli example program
author Jeff Hammel <jhammel@mozilla.com>
date Mon, 29 Nov 2010 07:21:30 -0800
parents a9110cc98d94
children 915f88af9624
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
70
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
1 #!/usr/bin/env python
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
2 """
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
3 venvit.py -- the equivalent of ez_setup.py for virtualenv, but less intrusive;
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
4 It wants a one-step installation to install python into a new virtualenv.
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
5 venvit is meant to be used via e.g. curl, although you can download it as well:
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
6
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
7 curl http://example.com/path/to/venvit.py | python - <package>
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
8
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
9 If <package> is a package name, it tries to install it from the cheeseshop.
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
10
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
11 If it is a svn/hg/git/tgz/etc URL, it should download and install the software
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
12 in source.
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
13
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
14 Only useful output -- like the scripts installed -- should be output to the
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
15 user.
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
16
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
17 Ideally, packages could have a venvit__init__.py (or a better name) that
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
18 will be executed after installation (or a venvit.txt which would just be output
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
19 to console, maybe falling back to the README
a9110cc98d94 adding notes on a venvit idea
Jeff Hammel <jhammel@mozilla.com>
parents:
diff changeset
20 """