Doodba Copier Template

This project lets you maintain Odoo deployments based on Doodba using Copier.

Table of contents

Installation and Usage
Using your subproject to build an Odoo deployment
Getting help
Contributing
Credits

Installation and Usage

Install the dependencies

This project itself is just the template, but you need to install these tools to use it:

copier v3.0.6 or newer
docker-compose
git 2.24 or newer
invoke installed in Python 3.6+ (and the binary must be called invoke — beware if your distro installs it as invoke3 or similar).
pre-commit
python 3.6+
venv

Install non-python apps with your distro's recommended package manager. The recommended way to install Python CLI apps is pipx:

python3 -m pip install --user pipx
pipx install docker-compose
pipx install copier
pipx install invoke
pipx install pre-commit
pipx ensurepath

Use the template to generate your subproject

Once you installed everything, you can now use Copier to copy this template:

copier copy gh:Tecnativa/doodba-copier-template ~/path/to/your/subproject

Copier will ask you a lot of questions. Answer them to properly generate the template.

Getting updates for your subproject

⚠️ If you come from doodba-scaffolding, please follow the migration guide.

If you always used Copier with this project, getting last updates with Copier is simple:

cd ~/path/to/your/downstream/scaffolding
copier update

Copier will ask you all questions again, but default values will be those you answered last time. Just hit Enter to accept those defaults, or change them if needed... or you can use copier --force update instead to avoid answering again all things.

Basically, read Copier docs and copier --help-all to know how to use it.