feat(binaryfile): add write methods

[wpbonelli]

Add instance write() methods to

• MfGrdFile
• HeadFile
• CellBudgetFile

Grid files

from flopy.mf6.utils.binarygrid_util import MfGrdFile

grb = MfGrdFile("model.grb")
grb.write("output.grb") # identical
grb.write("output_single.grb", precision="single") # different precision

Head/budget files

from flopy.utils.binaryfile import HeadFile, CellBudgetFile

# head file
hds = HeadFile("model.hds")
hds.write("output.hds")
hds.write("filtered.hds", kstpkper=[(1, 0), (1, 1)])  # specific time steps
hds.write("output_single.hds", precision="single")  # different precision

# budget file
cbc = CellBudgetFile("model.cbc")
cbc.write("output.cbc")
# specific budget terms
cbc.write("flowja_only.cbc", text="FLOW-JA-FACE")
cbc.write("subset.cbc", text=["STORAGE", "CONSTANT HEAD"])
# specific time steps and terms
cbc.write("filtered.cbc", kstpkper=[(1, 0)], text="FLOW-JA-FACE")

Close #2717

[codecov]

Codecov Report

❌ Patch coverage is 27.68166% with 209 lines in your changes missing coverage. Please review.
✅ Project coverage is 72.2%. Comparing base (556c088) to head (7557e50).
⚠️ Report is 136 commits behind head on develop.

Files with missing lines	Patch %	Lines
flopy/utils/binaryfile/__init__.py	1.0%	193 Missing ⚠️
flopy/mf6/utils/binarygrid_util.py	82.4%	13 Missing ⚠️
flopy/utils/utils_def.py	85.0%	3 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #2722      +/-   ##
===========================================
+ Coverage     55.5%    72.2%   +16.7%     
===========================================
  Files          644      674      +30     
  Lines       124135   131134    +6999     
===========================================
+ Hits         68947    94748   +25801     
+ Misses       55188    36386   -18802     

Files with missing lines	Coverage Δ
flopy/utils/utils_def.py	90.3% <85.0%> (+4.3%)	⬆️
flopy/mf6/utils/binarygrid_util.py	89.8% <82.4%> (-0.9%)	⬇️
flopy/utils/binaryfile/__init__.py	69.7% <1.0%> (-14.8%)	⬇️

... and 568 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.