roocs / clisops / 16154603223 / 2
87%
master: 87%

DEFAULT BRANCH: master
Ran
Files 32
Run time 1s
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 86.265% (-0.8%) from 87.108%
16154603223.2

push

github

web-flow 
Fix docstrings and add more static typing to call signatures (#439)

### What kind of change does this PR introduce?: <!--(Bug fix, feature,
docs update, etc.)-->

* Replaces `black` and `isort` and most checks done via `flake8` with
`ruff`
* All docstrings that were previously written using non-`numpydoc`
conventions have been translated.
* Call signatures have been added for many functions missing them.
* `pre-commit` checks now include `ruff`, as well as several other new
hooks, including test artifact checking and YAML linting
* Coding conventions are now set for Python3.10+
* Added an `engine` argument for `Grid.ds.to_netcdf()`.

### Does this PR introduce a breaking change?: <!--(Has there been an
API change? New dependencies?)-->

Yes. Almost all docstrings have been modified, and call signatures have
been changed in many places. Some small bugs have been dealt with. This
represents an enormous change and the documentation should benefit from
this.

`Grid.ds.to_netcdf()` now accepts an `engine` argument (default: `None`)
to allow passing a specific engine option. This is necessary in some
situations (malformed metadata in a Dataset is better handled by
NetCDF4).

### Other information: <!--(Relevant discussion threads? Outside
documentation pages?)-->

`ruff` has been developed to provide a comprehensive set of linting and
formatting tools based on existing projects in Python. The program is
built in `rust` and is extremely fast.

The docstrings were converted using AI (GitHub Copilot) and human
validation. Corrections were made manually as needed.

3090 of 3582 relevant lines covered (86.26%)

0.86 hits per line

Source Files on job run-Python3.12-conda - 16154603223.2