samples(storagecontrol): add delete folder recursive sample

[nidhiii-27]

This PR adds the SDK sample and tests for the hierarchical namespace recursive delete feature, resolving b/521168740.

[snippet-bot]

Here is the summary of changes.

You are about to add 1 region tag.

• storagecontrol/delete_folder_recursive.py:17, tag storage_control_delete_folder_recursive

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[gemini-code-assist]

Code Review

This pull request introduces a new script, delete_folder_recursive.py, along with its corresponding test file, delete_folder_recursive_test.py, to recursively delete folders in Google Cloud Storage. The feedback points out an incorrect type hint for the capsys fixture in the test file, which should be corrected from pytest.LogCaptureFixture to pytest.CaptureFixture[str] to prevent static analysis and type-checking errors.

[gemini-code-assist]

The capsys fixture in pytest is of type pytest.CaptureFixture[str], whereas pytest.LogCaptureFixture is used for the caplog fixture. Using the incorrect type hint can cause static analysis and type-checking tools like mypy to report errors.

Suggested change

	def test_delete_folder_recursive(
	capsys: pytest.LogCaptureFixture, hns_enabled_bucket: storage.Bucket, uuid_name: str
	) -> None:
	def test_delete_folder_recursive(
	capsys: pytest.CaptureFixture[str], hns_enabled_bucket: storage.Bucket, uuid_name: str
	) -> None: