Lint Tidal

[ssolson]

This PR enforces automatic linting on the tidal module and adds type hints to improve readability and maintainability.

Key Updates:

• Code Cleanup & Linting: Organized imports, followed PEP 8 conventions, and cleaned up unnecessary comments.
• Type Hints: Added type hints to all functions for better static analysis and clarity.
• Variable Naming: Standardized names to follow snake_case for consistency.

[ssolson]

@akeeste could you review this PR?

[akeeste]

Thanks @ssolson, looks great! Take a look at the suggestions:

• pulling in a couple of the descriptions from our docs when they were informative
• removing functions from the module-level docstrings.

On module-level docstrings--the autosummary tool allows us to automatically populate the function doc strings within a module without duplicating them, so I'd defer to that. Generally though the module level docstrings are a nice improvement. Once we're through a chunk of linting we can make a docs PR to reference this new content and reduce duplication outside of the source

[akeeste]

Remove in favor of the docs "autosummary" feature https://mhkit-software.github.io/MHKiT/mhkit-python/api.tidal.html#io. This will also prevent duplicate descriptions to upkeep

Suggested change

	Functions:
	----------
	request_noaa_data(station, parameter, start_date, end_date, proxy=None,
	write_json=None):
	Loads NOAA current data from the API into a pandas DataFrame,
	with optional support for proxy settings and writing data to a JSON
	file.
	request_noaa_data(station, parameter, start_date, end_date, options=None):
	Fetches NOAA data from the API, converts it into a pandas DataFrame (or xarray Dataset),
	and caches the result. Supports proxy settings and JSON file export.
	_xml_to_dataframe(response):
	Converts NOAA response data in XML format into a pandas DataFrame
	and returns metadata.
	Converts NOAA response data from XML format into a pandas DataFrame and extracts metadata.
	read_noaa_json(filename):
	Reads a JSON file containing NOAA data saved from the request_noaa_data
	function and returns a DataFrame with timeseries site data and metadata.
	read_noaa_json(filename, to_pandas=True):
	Reads a previously saved JSON file containing NOAA data and returns a pandas DataFrame
	(or xarray Dataset) with time-series data and metadata.

[akeeste]

git compares the changes in request_noaa_data poorly, but I'm more or less following how things are broken up into multiple functions