Pull Request Overview

Adds a new sync method to ProjectRemoteMirror to force an immediate remote mirror update via HTTP POST, along with corresponding test coverage and documentation.

• Implements ProjectRemoteMirror.sync() in the API client
• Extends unit tests to verify the sync endpoint call
• Updates the Sphinx docs to show how to invoke mirror.sync()

Reviewed Changes

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

gitlab/v4/objects/projects.py:1238

• [nitpick] The return type annotation is a union of dict[str, Any] and requests.Response, but since http_post always returns a Response object, consider narrowing the annotation to requests.Response for clarity.

    def sync(self, **kwargs: Any) -> dict[str, Any] | requests.Response:

docs/gl_objects/remote_mirrors.rst:40

• [nitpick] Expand this example to show the returned Response object (e.g., checking response.status_code) and mention any accepted kwargs or possible exceptions so users know how to handle the result of mirror.sync().

Force push mirror update::

Perfect, thanks @JohnVillalovos!