diff options
| author | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2022-06-25 20:41:23 +0100 |
|---|---|---|
| committer | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2022-06-25 20:41:23 +0100 |
| commit | 17311b1f8eb8f14afd23d84bb54e7a62c666e7fe (patch) | |
| tree | 56543155bd282103e6ae893f233d51911bb31f84 /setuptools/command | |
| parent | d5b5f6bef582acd2db481758c6a4c993ba4050b8 (diff) | |
| download | python-setuptools-git-17311b1f8eb8f14afd23d84bb54e7a62c666e7fe.tar.gz | |
Add interfaces to docs
Diffstat (limited to 'setuptools/command')
| -rw-r--r-- | setuptools/command/build.py | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/setuptools/command/build.py b/setuptools/command/build.py index c35dc3fc..1396afd5 100644 --- a/setuptools/command/build.py +++ b/setuptools/command/build.py @@ -44,20 +44,20 @@ class SubCommand(Protocol): 1. ``setuptools`` will set the ``editable_mode`` flag will be set to ``True`` 2. ``setuptools`` will execute the ``run()`` command. - .. important:: - Subcommands **SHOULD** take advantage of ``editable_mode=True`` to adequate - its behaviour or perform optimisations. - - For example, if a subcommand don't need to generate any extra file and - everything it does is to copy a source file into the build directory, - ``run()`` **SHOULD** simply "early return". - - Similarly, if the subcommand creates files that would be placed alongside - Python files in the final distribution, during an editable install - the command **SHOULD** generate these files "in place" (i.e. write them to - the original source directory, instead of using the build directory). - Note that ``get_output_mapping()`` should reflect that and include mappings - for "in place" builds accordingly. + .. important:: + Subcommands **SHOULD** take advantage of ``editable_mode=True`` to adequate + its behaviour or perform optimisations. + + For example, if a subcommand don't need to generate any extra file and + everything it does is to copy a source file into the build directory, + ``run()`` **SHOULD** simply "early return". + + Similarly, if the subcommand creates files that would be placed alongside + Python files in the final distribution, during an editable install + the command **SHOULD** generate these files "in place" (i.e. write them to + the original source directory, instead of using the build directory). + Note that ``get_output_mapping()`` should reflect that and include mappings + for "in place" builds accordingly. 3. ``setuptools`` use any knowledge it can derive from the return values of ``get_outputs()`` and ``get_output_mapping()`` to create an editable wheel. |
