build: adopt src layout

[bonjourmauko]

Depends on #61

• Technical improvement
• Impacted areas: all
• Details:
  • Adopt src layout to avoid importing bugs and properly testing built versions

From: https://packaging.python.org/en/latest/discussions/src-layout-vs-flat-layout/

The src layout involves an additional step in the development workflow of a
project (typically, an editable installation is used for development and a
regular installation is used for testing).

(...)

The src layout helps enforce that an editable installation is only able to
import files that were meant to be importable.

(...)

This is especially relevant when the editable installation is implemented
using a path configuration file that adds the directory to the import path.

[benoit-cty]

Reading the doc you provide, I see The src layout requires installation of the project to be able to run its code, and the flat layout does not. does this done automatically by Poetry or does the developer needs to do something about it ?

[bonjourmauko]

Reading the doc you provide, I see The src layout requires installation of the project to be able to run its code, and the flat layout does not. does this done automatically by Poetry or does the developer needs to do something about it ?

Poetry does it automatically. This just helps to avoid accidentally testing in dev mode.