adding stats CLI for future usage

Author: ford-at-aws

aws_doc_sdk_examples_tools/stats.py

@@ -24,5 +24,4 @@ def main(roots: List[str]):
 
 if __name__ == "__main__":
     from sys import argv
-
     main(argv[1:])

aws_doc_sdk_examples_tools/stats_cli.py

@@ -0,0 +1,168 @@
+import subprocess
+import yaml
+import tempfile
+import os
+from colorama import Fore, Style, init
+
+# Initialize colorama for Windows compatibility (does nothing on Linux/macOS)
+init(autoreset=True)
+
+# Define the ages you're interested in
+AGES = ["now", "1 month ago", "2 months ago", "3 months ago", "4 months ago", "5 months ago", "6 months ago"]
+
+# Path to the Git repository
+REPO_PATH = "/Users/fprior/Development/GitFarm/workplace/fprior/update-mirror-3/update-mirror/src/AWSDocsSdkExamplesPublic"
+
+# Path to the YAML file you want to extract from each commit
+FILE_PATH = "tools/update_mirror/config.yaml"
+
+# Function to run git commands
+def run_git_command(command, cwd=None):
+    try:
+        result = subprocess.run(command, cwd=cwd, text=True, capture_output=True, shell=True)
+        if result.returncode != 0:
+            raise subprocess.CalledProcessError(result.returncode, command, result.stderr)
+        return result.stdout.strip()
+    except Exception as e:
+        print(f"{Fore.RED}Error running command: {command}\n{Fore.RED}Error: {e}")
+        return None
+
+# Function to clone a repository if it's not already cloned
+def clone_or_reuse_repo(repo_url, branch, clone_dir):
+    if os.path.exists(clone_dir):
+        print(f"{Fore.YELLOW}Repository {repo_url} already cloned in {clone_dir}. Reusing existing clone.")
+    else:
+        print(f"{Fore.GREEN}Cloning repository {repo_url} into {clone_dir}...")
+        clone_cmd = f"git clone {repo_url} {clone_dir}"
+        run_git_command(clone_cmd)
+
+        # Checkout the correct branch
+        print(f"{Fore.CYAN}Checking out branch {branch} in {clone_dir}...")
+        checkout_cmd = f"git checkout {branch}"
+        run_git_command(checkout_cmd, cwd=clone_dir)
+
+# Function to get the latest commit hash for the specific age in the repo
+def get_commit_hash_for_age(repo_dir, age):
+    log_cmd = f'git rev-list -1 --before="{age}" HEAD'
+    commit_hash = run_git_command(log_cmd, cwd=repo_dir)
+    if commit_hash:
+        return commit_hash
+    else:
+        print(f"{Fore.RED}Failed to find commit hash for {age} in {repo_dir}")
+        return None
+
+# Function to force checkout to the specific commit hash
+def checkout_commit(repo_dir, commit_hash):
+    print(f"{Fore.CYAN}Checking out commit {commit_hash} in {repo_dir}")
+    checkout_cmd = f'git checkout --force {commit_hash}'
+    run_git_command(checkout_cmd, cwd=repo_dir)
+
+# Function to run the specific Git log command and Python command
+def run_commands_in_repo(repo_dir, commit_hash, age):
+    # Checkout the repository to the specific commit
+    checkout_commit(repo_dir, commit_hash)
+
+    # Retrieve the commit details
+    log_cmd = f'git log -n 1 {commit_hash} --pretty=format:"%H|%an|%aI"'
+    log_output = run_git_command(log_cmd, cwd=repo_dir)
+
+    if log_output:
+        log_parts = log_output.split('|')
+        commit_hash = log_parts[0]
+        author_name = log_parts[1]
+        commit_date = log_parts[2]
+
+        print(f"{Fore.MAGENTA}Commit for {age}: {commit_hash}, Author: {author_name}, Date: {commit_date}")
+
+        # Now run the Python command on the repository
+        python_cmd = f'python3 -m aws_doc_sdk_examples_tools.stats "{repo_dir}"'
+        print(f"{Fore.CYAN}Running stats command for repository: {repo_dir}")
+        output = run_git_command(python_cmd, cwd=repo_dir)
+        if output:
+            print(output)
+        print("###########################")
+    else:
+        print(f"{Fore.RED}No commit found for {age} in {repo_dir}")
+
+# Main function to gather file contents from specific commits and clone repositories
+def get_file_from_commits_and_clone(repo_path, file_path, ages):
+    age_content_dict = {}
+    cloned_repos = {}  # To track cloned repositories and their directories
+
+    # Create a temporary directory for the clones
+    with tempfile.TemporaryDirectory() as tmp_dir:
+        # First, fetch the configuration file from the main repository for each age
+        for age in ages:
+            print(f"{Style.BRIGHT}{Fore.BLUE}#############################################################")
+            print(f"{Style.BRIGHT}{Fore.BLUE}######################## {age.upper()} ##############################")
+            print(f"{Style.BRIGHT}{Fore.BLUE}#############################################################")
+
+            # Get the commit hash for the main repository
+            main_commit_hash = get_commit_hash_for_age(repo_path, age)
+            if not main_commit_hash:
+                print(f"{Fore.RED}Skipping {age} because commit hash could not be retrieved for the main repository.")
+                continue
+
+            # Get the YAML configuration from that commit
+            file_content = run_git_command(f"git show {main_commit_hash}:{file_path}", cwd=repo_path)
+
+            if file_content:
+                try:
+                    # Parse the YAML content
+                    yaml_content = yaml.safe_load(file_content)
+
+                    # Extract the mirrors section
+                    mirrors = yaml_content.get('mirrors', {})
+                    age_content_dict[age] = mirrors
+
+                    # Clone or reuse repositories for each mirror
+                    for mirror_name, mirror_info in mirrors.items():
+                        repo_url = mirror_info.get('git_mirror')
+                        branch = mirror_info.get('branch')
+                        dir_name = mirror_info.get('dir')
+
+                        # Check if this repository has already been cloned
+                        if repo_url not in cloned_repos:
+                            # If not, clone the repository to a subfolder in the temp directory
+                            clone_dir = os.path.join(tmp_dir, dir_name)
+                            clone_or_reuse_repo(repo_url, branch, clone_dir)
+
+                            # Mark this repo as cloned
+                            cloned_repos[repo_url] = clone_dir
+                        else:
+                            print(f"{Fore.YELLOW}Reusing cloned repository {repo_url} for mirror {mirror_name}.")
+
+                        # Get the specific commit hash for this repo at this age
+                        repo_commit_hash = get_commit_hash_for_age(cloned_repos[repo_url], age)
+                        if repo_commit_hash:
+                            # Run commands in the cloned repository for the specific commit hash
+                            run_commands_in_repo(cloned_repos[repo_url], repo_commit_hash, age)
+                        else:
+                            print(f"{Fore.RED}Skipping {mirror_name} in {age} due to failure in retrieving commit hash.")
+
+                except yaml.YAMLError as exc:
+                    print(f"{Fore.RED}Error parsing YAML file for {age}: {exc}")
+            else:
+                print(f"{Fore.RED}No file content found for commit {main_commit_hash} at {age}")
+
+    return age_content_dict
+
+# Review the contents (age range as key and the list of mirror repositories as values)
+def display_age_content_dict(age_content_dict):
+    print(f"{Style.BRIGHT}{Fore.GREEN}File contents grouped by age range:")
+    for age, mirrors in age_content_dict.items():
+        print(f"{Fore.YELLOW}Age: {age}")
+        print(f"{Fore.CYAN}Mirrors:")
+        for mirror_name, mirror_info in mirrors.items():
+            print(f"{Fore.MAGENTA}  - {mirror_name}:")
+            print(f"    {Fore.CYAN}git_mirror: {mirror_info.get('git_mirror')}")
+            print(f"    {Fore.CYAN}branch: {mirror_info.get('branch')}")
+            print(f"    {Fore.CYAN}dir: {mirror_info.get('dir')}")
+        print("-----------------")
+
+if __name__ == "__main__":
+    # Get the contents from the commits and clone the repos
+    age_content_dict = get_file_from_commits_and_clone(REPO_PATH, FILE_PATH, AGES)
+
+    # Display the contents in the dictionary format
+    display_age_content_dict(age_content_dict)