Skip to content

Commit

Permalink
chore: add codespell configuration and check with lint GHA
Browse files Browse the repository at this point in the history
  • Loading branch information
mwtoews committed Nov 14, 2024
1 parent bb9824e commit bb073ef
Show file tree
Hide file tree
Showing 16 changed files with 56 additions and 26 deletions.
3 changes: 3 additions & 0 deletions .github/workflows/commit.yml
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,9 @@ jobs:
- name: Check format
run: ruff format . --check

- name: Check spelling
run: codespell

- name: Check CITATION.cff
run: |
cffconvert --validate
Expand Down
4 changes: 2 additions & 2 deletions DEVELOPER.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,7 +215,7 @@ The `section` attribute assigns the example to a group within the rendered docum

**Note**: Examples are rendered into a thumbnail gallery view by [nbsphinx](https://github.com/spatialaudio/nbsphinx) when the [online documentation](https://flopy.readthedocs.io/en/latest/) is built. At least one plot/visualization is recommended in order to provide a thumbnail for each example notebook in the [Examples gallery](https://flopy.readthedocs.io/en/latest/notebooks.html)gallery.

**Note**: Thumbnails for the examples gallery are generated automatically from the notebook header (typically the first line, begining with a single '#'), and by default, the last plot generated. Thumbnails can be customized to use any plot in the notebook, or an external image, as described [here](https://nbsphinx.readthedocs.io/en/0.9.1/subdir/gallery.html).
**Note**: Thumbnails for the examples gallery are generated automatically from the notebook header (typically the first line, beginning with a single '#'), and by default, the last plot generated. Thumbnails can be customized to use any plot in the notebook, or an external image, as described [here](https://nbsphinx.readthedocs.io/en/0.9.1/subdir/gallery.html).

Each example should create and (attempt to) dispose of its own isolated temporary workspace. On Windows, Python's `TemporaryDirectory` can raise permissions errors, so cleanup is trapped with `try/except`. Some scripts also accept a `--quiet` flag, curtailing verbose output, and a `--keep` option to specify a working directory of the user's choice.

Expand Down Expand Up @@ -283,7 +283,7 @@ This should complete in under a minute on most machines. Smoke testing aims to c

### Writing tests

Test functions and files should be named informatively, with related tests grouped in the same file. The test suite runs on GitHub Actions in parallel, so tests should not access the working space of other tests, example scripts, tutorials or notebooks. A number of shared test fixtures are [imported](conftest.py) from [`modflow-devtools`](https://github.com/MODFLOW-USGS/modflow-devtools). These include keepable temporary directory fixtures and miscellanous utilities (see `modflow-devtools` repository README for more information on fixture usage). New tests should use these facilities where possible. See also the [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.
Test functions and files should be named informatively, with related tests grouped in the same file. The test suite runs on GitHub Actions in parallel, so tests should not access the working space of other tests, example scripts, tutorials or notebooks. A number of shared test fixtures are [imported](conftest.py) from [`modflow-devtools`](https://github.com/MODFLOW-USGS/modflow-devtools). These include keepable temporary directory fixtures and miscellaneous utilities (see `modflow-devtools` repository README for more information on fixture usage). New tests should use these facilities where possible. See also the [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.

### Debugging tests

Expand Down
2 changes: 1 addition & 1 deletion autotest/test_gridgen.py
Original file line number Diff line number Diff line change
Expand Up @@ -714,7 +714,7 @@ def test_gridgen(function_tmpdir):
g6.add_refinement_features(rfpoly, "polygon", 3, range(nlay))
gu.add_refinement_features(rfpoly, "polygon", 3, range(nlay))

# inactivate parts of mfusg layer 2 to test vertical-pass-through option
# deactivate parts of mfusg layer 2 to test vertical-pass-through option
xmin = 0 * delr
xmax = 18 * delr
ymin = 0 * delc
Expand Down
2 changes: 1 addition & 1 deletion autotest/test_mbase.py
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ def test_resolve_exe_by_rel_path(function_tmpdir, use_ext, forgive):
assert actual.lower() == expected
assert which(actual)

# check behavior if exe DNE
# check behavior if exe does not exist
with pytest.warns(UserWarning) if forgive else pytest.raises(FileNotFoundError):
assert not resolve_exe("../bin/mf2005", forgive)

Expand Down
4 changes: 2 additions & 2 deletions autotest/test_modflow.py
Original file line number Diff line number Diff line change
Expand Up @@ -277,14 +277,14 @@ def test_exe_selection(example_data_path, function_tmpdir):
== exe_name
)

# init/load should warn if exe DNE
# init/load should warn if exe does not exist
exe_name = "not_an_exe"
with pytest.warns(UserWarning):
ml = Modflow(exe_name=exe_name)
with pytest.warns(UserWarning):
ml = Modflow.load(namfile_path, exe_name=exe_name, model_ws=model_path)

# run should error if exe DNE
# run should error if exe does not exist
ml = Modflow.load(namfile_path, exe_name=exe_name, model_ws=model_path)
ml.change_model_ws(function_tmpdir)
ml.write_input()
Expand Down
8 changes: 4 additions & 4 deletions autotest/test_uzf.py
Original file line number Diff line number Diff line change
Expand Up @@ -625,15 +625,15 @@ def test_uzf_negative_iuzfopt(function_tmpdir):


def test_optionsblock_auxillary_typo():
# Incorrect: auxillary
# Incorrect: auxillary # codespell:ignore
# Correct: auxiliary
options = OptionBlock("", ModflowWel, block=True)
assert options.auxiliary == []
with pytest.deprecated_call():
assert options.auxillary == []
assert options.auxillary == [] # codespell:ignore
with pytest.deprecated_call():
options.auxillary = ["aux", "iface"]
options.auxillary = ["aux", "iface"] # codespell:ignore
assert options.auxiliary == ["aux", "iface"]
options.auxiliary = []
with pytest.deprecated_call():
assert options.auxillary == []
assert options.auxillary == [] # codespell:ignore
6 changes: 3 additions & 3 deletions flopy/discretization/unstructuredgrid.py
Original file line number Diff line number Diff line change
Expand Up @@ -618,12 +618,12 @@ def neighbors(self, node=None, **kwargs):
reset = kwargs.pop("reset", False)
if method == "iac":
if self._neighbors is None or reset:
neighors = {}
neighbors = {}
idx0 = 0
for node, ia in enumerate(self._iac):
idx1 = idx0 + ia
neighors[node] = list(self._ja[idx0 + 1 : idx1])
self._neighbors = neighors
neighbors[node] = list(self._ja[idx0 + 1 : idx1])
self._neighbors = neighbors
if node is not None:
return self._neighbors[node]
else:
Expand Down
2 changes: 1 addition & 1 deletion flopy/discretization/vertexgrid.py
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ def grid_lines(self):
if self.cell1d is not None:
close_cell = False

# go through each cell and create a line segement for each face
# go through each cell and create a line segment for each face
lines = []
ncpl = len(xgrid)
for icpl in range(ncpl):
Expand Down
2 changes: 1 addition & 1 deletion flopy/mf6/data/mfdatautil.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ def iterable(obj, any_iterator=False):
if any_iterator:
try:
my_iter = iter(obj)
except TypeError as te:
except TypeError:
return False
return True
else:
Expand Down
2 changes: 1 addition & 1 deletion flopy/mf6/utils/lakpak_utils.py
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ def get_lak_connections(modelgrid, lake_map, idomain=None, bedleak=None):
Returns
-------
idomain : ndarry
idomain adjusted to inactivate cells with lakes
idomain adjusted to deactivate cells with lakes
connection_dict : dict
dictionary with the zero-based lake number keys and number of
connections in a lake values
Expand Down
2 changes: 1 addition & 1 deletion flopy/modpath/mp6bas.py
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ class Modpath6Bas(Package):
hdry : float
Head value assigned to dry cells (default is -8888.).
def_face_ct : int
Number fo default iface codes to read (default is 0).
Number of default iface codes to read (default is 0).
bud_label : str or list of strs
MODFLOW budget item to which a default iface is assigned.
def_iface : int or list of ints
Expand Down
4 changes: 2 additions & 2 deletions flopy/plot/crosssection.py
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ def __init__(
self.xypts = plotutil.UnstructuredPlotUtilities.filter_line_segments(
self.xypts, threshold=min_segment_length
)
# need to ensure that the ordering of verticies in xypts is correct
# need to ensure that the ordering of vertices in xypts is correct
# based on the projection. In certain cases vertices need to be sorted
# for the specific "projection"
for node, points in self.xypts.items():
Expand Down Expand Up @@ -933,7 +933,7 @@ def plot_centers(
optional numpy nd.array of size modelgrid.nnodes
s : None, float, numpy array
optional point size parameter
masked_values : None, iteratable
masked_values : None, iterable
optional list, tuple, or np array of array (a) values to mask
inactive : bool
boolean flag to include inactive cell centers in the plot.
Expand Down
2 changes: 1 addition & 1 deletion flopy/plot/map.py
Original file line number Diff line number Diff line change
Expand Up @@ -629,7 +629,7 @@ def plot_centers(
optional numpy nd.array of size modelgrid.nnodes
s : None, float, numpy array
optional point size parameter
masked_values : None, iteratable
masked_values : None, iterable
optional list, tuple, or np array of array (a) values to mask
inactive : bool
boolean flag to include inactive cell centers in the plot.
Expand Down
4 changes: 2 additions & 2 deletions flopy/utils/lgrutil.py
Original file line number Diff line number Diff line change
Expand Up @@ -589,7 +589,7 @@ def to_disv_gridprops(self):
used to create a disv grid (instead of a separate parent
and child representation). The gridprops dictionary can
be unpacked into the flopy.mf6.Modflowdisv() constructor
and flopy.discretization.VertexGrid() contructor.
and flopy.discretization.VertexGrid() constructor.
Note that export capability will only work if the parent
and child models have corresponding layers.
Expand Down Expand Up @@ -964,7 +964,7 @@ def get_disv_gridprops(self):
used to create a disv grid (instead of a separate parent
and child representation). The gridprops dictionary can
be unpacked into the flopy.mf6.Modflowdisv() constructor
and flopy.discretization.VertexGrid() contructor.
and flopy.discretization.VertexGrid() constructor.
Note that export capability will only work if the parent
and child models have corresponding layers.
Expand Down
8 changes: 4 additions & 4 deletions flopy/utils/optionblock.py
Original file line number Diff line number Diff line change
Expand Up @@ -59,10 +59,10 @@ def __init__(self, options_line, package, block=True):
self._set_attributes()

def __getattr__(self, key):
if key == "auxillary": # catch typo from older version
if key == "auxillary": # catch typo from older version - codespell:ignore
key = "auxiliary"
warnings.warn(
"the atttribute 'auxillary' is deprecated, use 'auxiliary' instead",
"the attribute 'auxillary' is deprecated, use 'auxiliary' instead",
category=DeprecationWarning,
)
return super().__getattribute__(key)
Expand Down Expand Up @@ -159,10 +159,10 @@ def __setattr__(self, key, value):
is consistent with the attribute data type
"""
if key == "auxillary": # catch typo from older version
if key == "auxillary": # catch typo from older version - codespell:ignore
key = "auxiliary"
warnings.warn(
"the atttribute 'auxillary' is deprecated, use 'auxiliary' instead",
"the attribute 'auxillary' is deprecated, use 'auxiliary' instead",
category=DeprecationWarning,
)

Expand Down
27 changes: 27 additions & 0 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ dynamic = ["version", "readme"]
dev = ["flopy[lint,test,optional,doc]"]
lint = [
"cffconvert",
"codespell",
"tomli ; python_version <'3.11'",
"ruff"
]
test = [
Expand Down Expand Up @@ -159,3 +161,28 @@ ignore = [
[tool.ruff.lint.per-file-ignores]
".docs/**/*.py" = ["E501"]
"flopy/mf6/**/*.py" = ["E501", "ISC001"]

[tool.codespell]
skip = "cliff.toml,./examples/data/*"
ignore-words-list = [
"alltime",
"dum",
"inout",
"intot",
"delt",
"gage",
"gages",
"datbase",
"wel",
"nam",
"lke",
"ist",
"ninj",
"drob",
"thck",
"vor",
"yur",
"localy",
"vertx",
"nd",
]

0 comments on commit bb073ef

Please sign in to comment.