Add read_nwb_method for local paths in both hdf5 and zarr

[h-mayorquin]

Motivation

See #1974

How to test the behavior?

I added tests.

Checklist

• Did you update CHANGELOG.md with your changes?
• Have you checked our Contributing document?
• Have you ensured the PR clearly describes the problem and the solution?
• Is your contribution compliant with our coding style? This can be checked running ruff check . && codespell from the source directory.
• Have you checked to ensure that there aren't other open Pull Requests for the same change?
• Have you included the relevant issue number using "Fix #XXX" notation where XXX is the issue number? By including "Fix #XXX" you allow GitHub to close issue #XXX when the PR is merged.

[codecov]

Codecov Report

Attention: Patch coverage is 18.18182% with 9 lines in your changes missing coverage. Please review.

Project coverage is 91.39%. Comparing base (2c2bc85) to head (33847a6).

Files with missing lines	Patch %	Lines
src/pynwb/__init__.py	18.18%	9 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##              dev    #1994      +/-   ##
==========================================
- Coverage   91.69%   91.39%   -0.30%     
==========================================
  Files          27       27              
  Lines        2708     2719      +11     
  Branches      707      710       +3     
==========================================
+ Hits         2483     2485       +2     
- Misses        149      158       +9     
  Partials       76       76              

Flag	Coverage Δ
integration	72.60% <18.18%> (-0.23%)	⬇️
unit	82.38% <18.18%> (-0.27%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

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

[stephprince]

Sorry for the delay @h-mayorquin! Added my review comments

[stephprince]

Suggested change

	from hdmf_zarr import NWBZarrIO
	backend_is_zarr = NWBZarrIO.can_read(path=path)
	if backend_is_zarr:
	return NWBZarrIO.read_nwb(path=path)
	else:
	raise ValueError(f"Unsupported backend for file: {path}")
	try:
	from hdmf_zarr import NWBZarrIO
	backend_is_zarr = NWBZarrIO.can_read(path=path)
	if backend_is_zarr:
	return NWBZarrIO.read_nwb(path=path)
	else:
	raise ValueError(f"Unsupported backend for file: {path}")
	except ImportError:
	raise ValueError(f"Unsupported backend for file: '{path}'. If you are trying to read a Zarr file, make sure you have hdmf-zarr installed.")

I believe read_nwb will currently return an ImportError if the user provides an invalid path but does not have hdmf_zarr installed. Can you support this case?

[stephprince]

Can you add tests for

1. the user providing a path that does not exist
2. if the user does not have hdmf_zarr installed and provides an unsupported file path

[stephprince]

Suggested change

	* Detects file format based on extension
	* Detects file format based on whether supported backend IO classes can read the file

I think in the current implementation other extensions will work since can_read and IO.read_nwb methods just check whether the IO can successfully open the file?

[stephprince]

Suggested change

	- Removed `SpatialSeries.bounds` field that was not functional. This will be fixed in a future release. @rly [#1907](https://github.com/NeurodataWithoutBorders/pynwb/pull/1907), [#1996](https://github.com/NeurodataWithoutBorders/pynwb/pull/1996)
	- Added support for `NWBFile.was_generated_by` field. @stephprince [#1924](https://github.com/NeurodataWithoutBorders/pynwb/pull/1924)
	- Added support for `model_number`, `model_name`, and `serial_number` fields to `Device`. @stephprince [#1997](https://github.com/NeurodataWithoutBorders/pynwb/pull/1997)
	- Deprecated `EventWaveform` neurodata type. @rly [#1940](https://github.com/NeurodataWithoutBorders/pynwb/pull/1940)
	- Deprecated `ImageMaskSeries` neurodata type. @rly [#1941](https://github.com/NeurodataWithoutBorders/pynwb/pull/1941)
	- Removed `SpatialSeries.bounds` field that was not functional. This will be fixed in a future release. @rly [#1907](https://github.com/NeurodataWithoutBorders/pynwb/pull/1907), [#1996](https://github.com/NeurodataWithoutBorders/pynwb/pull/1996)
	- Added support for `NWBFile.was_generated_by` field. @stephprince [#1924](https://github.com/NeurodataWithoutBorders/pynwb/pull/1924)
	- Added support for `model_number`, `model_name`, and `serial_number` fields to `Device`. @stephprince [#1997](https://github.com/NeurodataWithoutBorders/pynwb/pull/1997)
	- Deprecated `EventWaveform` neurodata type. @rly [#1940](https://github.com/NeurodataWithoutBorders/pynwb/pull/1940)
	- Deprecated `ImageMaskSeries` neurodata type. @rly [#1941](https://github.com/NeurodataWithoutBorders/pynwb/pull/1941)

These updates were indented to indicate schema 2.8.0 related changes

[stephprince]

I think once the simplified read_nwb with streaming is supported we may want to go through the other tutorials that use io.read() in read only mode and update those as well.