feat: add metrics.hits, with support for new instrumentation/content/hits endpoint

[toph-allen]

Intent

Add support support for Posit Connect's content hits endpoint (GET /v1/instrumentation/content/hits)

Closes #403

Notes

• Implementation lives in metrics/hits.py
• from and to parameters are named start and end in Python to work around reserved keywords. The rename_params function shared across all metrics classes has been collapsed into a single function.

Tests

• Tests have been added which cover all of the new functionality.

[github-actions]

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines	Covered	Coverage	Threshold	Status
1900	1791	94%	0%	🟢

New Files

File	Coverage	Status
src/posit/connect/metrics/hits.py	100%	🟢
src/posit/connect/metrics/rename_params.py	100%	🟢
TOTAL	100%	🟢

Modified Files

File	Coverage	Status
src/posit/connect/metrics/metrics.py	100%	🟢
src/posit/connect/metrics/shiny_usage.py	100%	🟢
src/posit/connect/metrics/visits.py	100%	🟢
src/posit/connect/resources.py	92%	🟢
TOTAL	98%	🟢

updated for commit: 7576f00 by action🐍

[tdstein]

Should we include something here about how 'start' and 'end' are translated to 'from' and 'to'?

Also, another option here is to just use **kwargs and state the use of from and to in the docstring.

def fetch(
        self,
        **kwargs,
    ) -> Iterable[Hit]:
        """
        Fetch all content hit records matching the specified conditions.

        Parameters
        ----------
        from : str, not required
            The timestamp that starts the time window of interest in RFC 3339 format.
            Any hit information that happened prior to this timestamp will not be returned.
            Example: "2025-05-01T00:00:00Z"
        to : str, not required
            The timestamp that ends the time window of interest in RFC 3339 format.
            Any hit information that happened after this timestamp will not be returned.
            Example: "2025-05-02T00:00:00Z"

        Returns
        -------
        Iterable[Hit]
            All content hit records matching the specified conditions.
        """
        ...