Add a Graphql implementation of the repo StargazersStream

tap_github/repository_streams.py

@@ -1479,7 +1479,7 @@ def parse_response(self, response: requests.Response) -> Iterable[dict]:
 class StargazersStream(GitHubRestStream):
     """Defines 'Stargazers' stream. Warning: this stream does NOT track star deletions."""
 
-    name = "stargazers"
+    name = "stargazers_rest"
     path = "/repos/{org}/{repo}/stargazers"
     primary_keys = ["user_id", "repo", "org"]
     parent_stream_type = RepositoryStream
@@ -1488,6 +1488,13 @@ class StargazersStream(GitHubRestStream):
     # GitHub is missing the "since" parameter on this endpoint.
     missing_since_parameter = True
 
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # TODO - remove warning with next release.
+        self.logger.warning(
+            "This stream is deprecated. Please use the Graphql version instead 'stargazers'."
+        )
+
     @property
     def http_headers(self) -> dict:
         """Return the http headers needed.
@@ -1532,6 +1539,14 @@ class StargazersGraphqlStream(GitHubGraphqlStream):
     # The parent repository object changes if the number of stargazers changes.
     ignore_parent_replication_key = False
 
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # TODO - remove warning with next release.
+        self.logger.warning(
+            "This stream might conflict with previous implementation of 'stargazer'. "
+            "Looking for the older version, use 'stargazers_rest'."
+        )
+
     def post_process(self, row: dict, context: Optional[Dict] = None) -> dict:
         """
         Add a user_id top-level field to be used as state replication key.