Ouranosinc / xclim / 21725543416

92%

main: 92%

push

github

[new xclim] Adopt PEP-735 (Dependency groups) (#2316)

### What kind of change does this PR introduce?

* Splits the `lint` dependencies into a `dependency-group` in
`pyproject.toml`.
* Adjusts the Makefile to silently install linting dependencies if the
`lint` command is called.
* Updates the `tox` configuration to the latest version supporting
`dependency-groups`.
* Addresses a small `yamllint` warning concerning line length.
* Adds `--help` alias to the `xclim` CLI.

### Does this PR introduce a breaking change?

Yes. The development dependencies no longer install the linting
dependencies by default. `make lint` will now install the linting
dependencies only if explicitly called; Otherwise, the `pre-commit` step
will handle the running of linting steps. `tox` has been adjusted in
order to refer to the "lint" `dependency-group` (removing redundancy).

### Other information:

`dependency-groups` are a way to ensure that development-time
dependencies are now published with distributions of packages, which is
great for packages that do not bundle code, or for preventing end-users
from installing tools they will never require when using the package.

Example invocation:
```
$ pip install --group lint,test
```

A `dependency-group` is only available when examining the source code of
the library and allows developers to only install the dependencies
without needing to install the library itself (great for linting). It
also supports installing the library or nesting of other
`dependency-groups`/`optional-dependencies`, if desired.

Testing and other miscellaneous development libraries are also suggested
to be listed under `dependency-groups`; Is this something that people
would be OK with? We could split these dependencies out such that the
only additional libraries would be listed under `xclim[extras]`.

https://peps.python.org/pep-0735/

18 of 21 new or added lines in 3 files covered. (85.71%)

7935 of 8624 relevant lines covered (92.01%)

6.29 hits per line