[IMP] intergrate gh tool

README.md

@@ -29,9 +29,16 @@ Syntax:
     $ oca-port <source> <target> <module_path> [options]
     $ oca-port --help
 
-To check if an addon could be migrated or to get eligible commits to port:
+GITHUB_TOKEN can be passed by exposing to environment:
 
     $ export GITHUB_TOKEN=<token>
+
+Alternatively, you can pass the token directly using the `--github-token` option
+
+If neither method is used, the tool will attempt to obtain the token using the `gh` client (if it's installed).
+
+To check if an addon could be migrated or to get eligible commits to port:
+
     $ cd <path/to/OCA/cloned_repository>
     $ oca-port origin/16.0 origin/18.0 <module_path> --verbose --dry-run
 

oca_port/app.py

@@ -4,6 +4,7 @@
 import pathlib
 from dataclasses import dataclass
 import re
+import subprocess
 
 import git
 
@@ -109,7 +110,20 @@ def __post_init__(self):
         self._check_branch_exists(self.source.ref, raise_exc=True)
         self._check_branch_exists(self.target.ref, raise_exc=True)
         # GitHub API helper
-        self.github = GitHub(self.github_token or os.environ.get("GITHUB_TOKEN"))
+        token = False
+        if os.environ.get("GITHUB_TOKEN"):
+            token = os.environ["GITHUB_TOKEN"]
+        else:
+            token = self.github_token
+            if not token:
+                try:
+                    # get from gh
+                    token = subprocess.check_output(
+                        ["gh", "auth", "token"], text=True
+                    ).strip()
+                except subprocess.SubprocessError:
+                    pass
+        self.github = GitHub(token)
         # Initialize storage & cache
         self.storage = utils.storage.InputStorage(self.to_branch, self.addon)
         self.cache = utils.cache.UserCacheFactory(self).build()

oca_port/cli/main.py

@@ -98,6 +98,12 @@
 @click.option("--fetch", is_flag=True, help="Fetch remote branches from upstream.")
 @click.option("--no-cache", is_flag=True, help="Disable user's cache.")
 @click.option("--clear-cache", is_flag=True, help="Clear the user's cache.")
+@click.option(
+    "--github-token",
+    is_flag=True,
+    help="""Token to use when requesting GitHub API (highly recommended
+            to not trigger the "API rate limit exceeded" error).""",
+)
 def main(
     addon_path: str,
     source: str,
@@ -114,6 +120,7 @@ def main(
     no_cache: bool,
     clear_cache: bool,
     dry_run: bool,
+    github_token: str,
 ):
     """Migrate ADDON from SOURCE to TARGET or list Pull Requests to port.
 
@@ -148,6 +155,7 @@ def main(
             clear_cache=clear_cache,
             dry_run=dry_run,
             cli=True,
+            github_token=github_token,
         )
     except ForkValueError as exc:
         error_msg = prepare_remote_error_msg(*exc.args)