diff --git a/README.md b/README.md index 8447005..01646dc 100644 --- a/README.md +++ b/README.md @@ -147,17 +147,23 @@ git clone \ cd test_linux_containers ``` -``` -pipenv install -``` +Prior to any further development one needs to initialise the project by running +the following commands on the command line. ``` -pipenv install --dev +task init-project pipenv-shell ``` -``` -pipenv shell -``` +These tasks will perform the following steps. + +1. Create a Python virtual environment through `pipenv`. +2. Any Python dependencies described in `Pipfile.lock`, such as Ansible, +will be downloaded and installed. +3. Any Python development dependencies described in `Pipfile.lock`, +such as linters and code formatters, will be downloaded and installed. +4. The virtual environment will be activated. + +From this point on, the project is properly initialised for development. ## Lint Ansible artifacts diff --git a/Taskfile.yml b/Taskfile.yml index 12e2671..3ff6bd1 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -1,6 +1,10 @@ --- version: '3' tasks: + init-project: + cmds: [pipenv install, pipenv install --dev] + pipenv-shell: + cmds: [pipenv shell] format-yml: cmds: [yamlfix .] lint-yml: