Add ability to delete files from a BIDS dataset

[PierreGtch]

PR Description

Add a BIDSPath.rm method to delete all the matching files and update the scans.tsv and participants.tsv files accordingly

C.f. #547, #443

closes #439

Merge checklist

Maintainer, please confirm the following before merging.
If applicable:

• All comments are resolved
• This is not your own PR
• All CIs are happy
• PR title starts with [MRG]
• whats_new.rst is updated
• New contributors have been added to CITATION.cff
• PR description includes phrase "closes <#issue-number>"

[welcome]

Hello! 👋 Thanks for opening your first pull request here! ❤️ We will try to get back to you soon. 🚴🏽‍♂️

[PierreGtch]

I implemented the comments @agramfort made in PR #547.

@hoechenberger can take a look at the code now?

[jasmainak]

We finally have the entire CRUD operation stack!

[hoechenberger]

Looks good so far, but please use list comprehensions instead of map()

[codecov]

Codecov Report

Merging #1149 (7085a77) into main (eeb5903) will decrease coverage by 0.09%.
The diff coverage is 94.80%.

❗ Current head 7085a77 differs from pull request most recent head 2a14880. Consider uploading reports for the commit 2a14880 to get more accurate results

@@            Coverage Diff             @@
##             main    #1149      +/-   ##
==========================================
- Coverage   97.59%   97.51%   -0.09%     
==========================================
  Files          40       40              
  Lines        8577     8654      +77     
==========================================
+ Hits         8371     8439      +68     
- Misses        206      215       +9     

Impacted Files	Coverage Δ
mne_bids/path.py	97.38% <92.72%> (-0.33%)	⬇️
mne_bids/tests/test_path.py	99.85% <100.00%> (+<0.01%)	⬆️

... and 3 files with indirect coverage changes

[PierreGtch]

@hoechenberger would you be happy with the current state?

[hoechenberger]

I won't have time to review for the next few days, @sappelhoff can you take over please?

[sappelhoff]

@PierreGtch could you please solve the remaining CI failure?

FileNotFoundError: fname does not exist: "/home/runner/work/mne-bids/mne-bids/MEG/sample/sample_audvis_trunc_raw.fif"

Other than that, this PR looks good to me.

[PierreGtch]

@PierreGtch could you please solve the remaining CI failure?

FileNotFoundError: fname does not exist: "/home/runner/work/mne-bids/mne-bids/MEG/sample/sample_audvis_trunc_raw.fif"

@sappelhoff I actually found a very simple fix for this fixture, it should all be green now!

[sappelhoff]

the bids validator issue (ubuntu-latest, 3.11, mne-main, validator-main test suite) can be ignored, however the failures on windows seem real to me 🤔

[PierreGtch]

the bids validator issue (ubuntu-latest, 3.11, mne-main, validator-main test suite) can be ignored, however the failures on windows seem real to me 🤔

I managed to solve the windows issue 👌

[sappelhoff]

Thanks a lot!

[welcome]

🎉 Congrats on merging your first pull request! 🥳 Looking forward to seeing more from you in the future! 💪