Notice other versions of the same page (#208)

* Notice other versions of the same page

For instance, inform if a linux page is also in common.

* feat: list all found platforms that have the pag

---------

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: CleanMachine1 <78213164+CleanMachine1@users.noreply.github.com>
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

Author: 4 people

tldr.py

@@ -234,6 +234,70 @@ def get_language_list() -> List[str]:
     return languages
 
 
+def get_page_for_every_platform(
+    command: str,
+    remote: Optional[str] = None,
+    platforms: Optional[List[str]] = None,
+    languages: Optional[List[str]] = None
+) -> Union[List[Tuple[str, str]], bool]:
+    """Gives a list of tuples result-platform ordered by priority."""
+    if platforms is None:
+        platforms = get_platform_list()
+    if languages is None:
+        languages = get_language_list()
+    # only use cache
+    if USE_CACHE:
+        result = list()
+        for platform in platforms:
+            for language in languages:
+                if platform is None:
+                    continue
+                try:
+                    result.append(
+                        (get_page_for_platform(
+                                command,
+                                platform,
+                                remote,
+                                language,
+                                only_use_cache=True,
+                        ), platform)
+                    )
+                    break   # Don't want to look for the same page in other langs
+                except CacheNotExist:
+                    continue
+        if result:  # Return if smth was found
+            return result
+    # Know here that we don't have the info in cache
+    result = list()
+    for platform in platforms:
+        for language in languages:
+            if platform is None:
+                continue
+            try:
+                result.append(
+                    (
+                        get_page_for_platform(
+                            command,
+                            platform,
+                            remote,
+                            language
+                        ),
+                        platform
+                    )
+                )
+                break
+            except HTTPError as err:
+                if err.code != 404:
+                    raise
+            except URLError:
+                if not PAGES_SOURCE_LOCATION.startswith('file://'):
+                    raise
+    if result:  # Return if smth was found
+        return result
+
+    return False
+
+
 def get_page(
     command: str,
     remote: Optional[str] = None,
@@ -547,20 +611,33 @@ def main() -> None:
     else:
         try:
             command = '-'.join(options.command).lower()
-            result = get_page(
+            results = get_page_for_every_platform(
                 command,
                 options.source,
                 options.platform,
                 options.language
             )
-            if not result:
+            if not results:
                 sys.exit((
                     "`{cmd}` documentation is not available.\n"
                     "If you want to contribute it, feel free to"
                     " send a pull request to: https://github.com/tldr-pages/tldr"
                 ).format(cmd=command))
             else:
-                output(result, plain=options.markdown)
+                output(results[0][0], plain=options.markdown)
+                if results[1:]:
+                    platforms_str = [result[1] for result in results[1:]]
+                    are_multiple_platforms = len(platforms_str) > 1
+                    if are_multiple_platforms:
+                        print(
+                            f"Found {len(platforms_str)} pages with the same name"
+                            f" under the platforms: {', '.join(platforms_str)}."
+                        )
+                    else:
+                        print(
+                            f"Found 1 page with the same name"
+                            f" under the platform: {platforms_str[0]}."
+                        )
         except URLError as e:
             sys.exit("Error fetching from tldr: {}".format(e))