Add a feature similar to Pyhton’s virtualenv + pip.
The env command creates a new Odoo environment: a directory for Odoo addons
to be the home for a database. It contains an odoo.sh to be used to work
with this environment.
The get command discovers modules and makes them available in an Odoo
environment addons. For this it uses an index of known modules, downloads
the source code from the web, and makes the available in the environment
through a symlink.
The default index used is: https://github.com/dreispt/ooenv-index For the moment only OCA modules are indexed.
To run an Odoo server for that environment, and maybe perform some actions on it
such as modules installation or upgrade, use the ./odoo.sh with the
start CLI command:
$ ./odoo.sh start
This automatically appends the environment directory to the addons path and uses the directory name for the database name.
To install just put the odoo-env module somewhere in your
addons path. The module provides additional Odoo CLI commands and
no actual installation is needed.
To confirm the commands are available try:
$ ./path-to-odoo/odoo.py env -h
There are some known issues with CLI commands on Odoo 8.0. You may need to add this fix to you Odoo server: odoo/odoo#6335
To better understand how to get started, here is an example session.
First we create a new Odoo environment.
The new Odoo environment will be tied to a particular Odoo server.
The one used to run the env command will be used as the reference server:
$ ./path-to-odoo/odoo.py env my-name
A my-name subdirectory will be created with an odoo.sh executable
file. Further actions for that environment should be ran using that script.
Now we will install the mgmtsystem OCA module with all it’s dependencies.
$ my-name/odoo.sh get mgmtsystem
You will notice that the OCA/management-system and OCA/knowlege repositories will be automatically cloned into a local cache to provide the needed modules.
If you now list the contents of the my-name/ directory, you will see the two
modules needed.
To start the server for this environment and install mgmtsystem:
$ my-name/odoo.sh start -i mgmtsystem