Sanitize "locator" value

[yarikoptic]

We observed the Study Description to contain spaces in it. Due to unresolved bug in nipype (nipy/nipype#3604) we must avoid spaces in the file names since then external execution of dcm2niix would fail. While at it, I decided to sanitize it more and replace all other "funny" characters with the special treatment by shells.

[Copilot]

Pull Request Overview

This PR sanitizes the "locator" value to avoid spaces and special characters that could cause issues with dcm2niix execution due to a known nipype bug. The changes implement a path sanitization utility that replaces problematic characters with underscores.

• Adds a sanitize_path function to clean paths by replacing unwanted characters with underscores
• Applies sanitization to the locator value in the main workflow
• Includes comprehensive test coverage for both valid and invalid path scenarios

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
heudiconv/utils.py	Adds delete_chars and sanitize_path utility functions for path cleaning
heudiconv/main.py	Applies sanitize_path to the locator value in the workflow
heudiconv/tests/test_utils.py	Adds parametrized tests for the new sanitization functions

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

The string concatenation with a space between two string literals is unnecessary. The strings should be combined into a single string for better readability: \"%r %s contained problematic character(s), it was cleaned to be %r\"

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.92%. Comparing base (5b1718b) to head (16c72a1).

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #830      +/-   ##
==========================================
+ Coverage   82.84%   82.92%   +0.07%     
==========================================
  Files          42       42              
  Lines        4313     4333      +20     
==========================================
+ Hits         3573     3593      +20     
  Misses        740      740              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

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

[yarikoptic]

Do you rely on locator values extracted from DICOMs StudyDescription, @nipy/team-heudiconv ?
if so -- please verify that this PR doesn't affect behavior for you!

I am planing to merge/release within a week or so

[bpinsard]

LGTM, I think we were taking care of the sanitization in our heuristics infotoids and using spaces in the Siemens program tree was rare or none.