timbertson / 0path Goto Github PK

DEPRECATED
----------

0path is lacking some features required for newer versionf of 0install,
and is generally a fragile way to go about this sort of thing.
Please consider using the newer
[0env](http://gfxmonk.net/dist/0install/0env.xml) instead.


-----


0path is a utility for making the contents of a zero install feed
(including its dependencies) active in your current shell session,
as if the library or application were installed globally.

This should not be used as a substitute for creating a zero-install feed with
your dependencies declared appropriately, but can be useful for trying out a
library without going to that effort.

INSTALLATION:
-------------

Because 0path modifies environment variables, the suggested method of
installation is to add this function to your shell's inisitalisation
environment (e.g by adding to ~/.bashrc):

    function 0path { eval "$(0launch 'http://gfxmonk.net/dist/0install/0path.xml' "$@")"; }

(for zsh users, you should remove the double quotes around "$@")

USAGE:
------

Then the usage is simply e.g:

    0path http://gfxmonk.net/dist/0install/mocktest.xml

This will make the `mocktest` python library available to all programs
run from within the current shell session. For example, you can now
run a python shell and `import mocktest`.

ADVANCED USAGE:
---------------

If you need to add the feed's implementation to a specific environment
variable (rather than one it exports):

    0path http://gfxmonk.net/dist/0install/mocktest.xml PYTHONPATH

This will insert mocktest's base path into your $PYTHONPATH environment
variable.

If providing an environment variable name, you can supply optional --insert
and --mode options, which mimic the behaviour of these attributes in a
zero-install <environment> binding.

If you just want to run it as a once-off without installing it into
your shell, you can run e.g:

eval "$(0launch 'http://gfxmonk.net/dist/0install/0path.xml' <feed-uri>)"