diff --git a/source/discussions/src-layout-vs-flat-layout.rst b/source/discussions/src-layout-vs-flat-layout.rst index c38968345..b6bce86ca 100644 --- a/source/discussions/src-layout-vs-flat-layout.rst +++ b/source/discussions/src-layout-vs-flat-layout.rst @@ -86,12 +86,22 @@ Running a command-line interface from source with src-layout ============================================================ Due to the firstly mentioned specialty of the src layout, a command-line -interface can not be run directly from the :term:`source tree `, -but requires installation of the package in -:doc:`Development Mode ` -for testing purposes. Since this can be unpractical in some situations, -a workaround could be to prepend the package folder to Python's -:py:data:`sys.path` when called via its :file:`__main__.py` file: +interface can not be run directly from the :term:`source tree `. + +To run a command-line interface directly, you can install the package in +:doc:`Development Mode ` for testing purposes. + +Since this can be unpractical in some situations, you can also either: + +Run :file:`__main__.py` via: + +.. code-block:: bash + + cd src/ + python -m awesome_package + +Or prepend the package folder to Python's :py:data:`sys.path` when called via its +:file:`__main__.py` file: .. code-block:: python