Testing Farm Contribution Guide



All our Python projects MUST use Poetry for packaging. It is required to use poetry version 1.4.2.

To install Poetry use the following command:

curl -sSL https://install.python-poetry.org | python3 - --version 1.4.2


It is required to use Ansbile version 2.14.* both in development environment and Python projects.

To install Ansible use the following command:

sudo dnf install ansible-core-2.14.*


Readability and consistency are essential to maintaining a healthy codebase. In this section we documented the best practices to follow when contributing to our codebase.


When writing documentation, prefer one sentence per line. For more details, see here.


When working with templates, we recommend using spaces to separate different elements, such as variables, operators, filters, etc. This helps to improve the readability and maintainability of our templates and ensures that our template code is easy to understand and modify.

This applies to all templating languages we use, including:

Here are some examples of how to use spaces correctly in templates:

  • Go template:

    {{ if eq .Status "pending" }}
      {{ $total := add .Quantity .Reserved }}
      {{ if gt $total 10 }}
        The total quantity is greater than 10.
      {{ end }}
    {{ end }}
  • Jinja2 template:

    {% if user.is_authenticated %}
      {% for item in cart %}
        {% set price = item.price * item.quantity %}
        <li>{{ item.name }} - {{ price | currency }}</li>
      {% endfor %}
    {% endif %}

Here’s what not to do:

{{if eq .Status "pending"}}
  {{for item in cart}}
    {{set price=item.price*item.quantity}}

In this example, there are no spaces between the different elements of the template, making it difficult to read and understand.