Implement New Contributors functionality

* Implements the new_contributors() function, albeit slightly different
  from the original version.

  First, we see if there is a name associated with an email. If there
  is, print it out together with the email. Otherwise, just print out
  the email

Author: tomice

README.md

@@ -67,7 +67,7 @@ project's version. Not Yet Implemented means it does not exist yet:
 | **Branch Tree View**                            | Completed ✔️            | Visual representation of the branch hierarchy.          |
 | **All Branches (Sorted by Most Recent Commit)** | Completed ✔️            | Lists all branches ordered by latest commit date.       |
 | **All Contributors (Sorted by Name)**           | Completed ✔️            | Displays all contributors sorted alphabetically.        |
-| **New Contributors (Sorted by Email)**          | Stubbed 🛠️             | Lists new contributors sorted by their email addresses. |
+| **New Contributors (Sorted by Email)**          | Completed ✔️            | Lists new contributors sorted by their email addresses. |
 | **Git Commits per Author**                      | Stubbed 🛠️             | Counts commits made by each author.                     |
 | **Git Commits per Date**                        | Stubbed 🛠️             | Counts commits based on the date.                       |
 | **Git Commits per Month**                       | Stubbed 🛠️             | Counts commits based on the monthly.                    |
@@ -96,14 +96,16 @@ there may be instances where this version differs from the base project by desig
 The following is a list of differences that this project will maintain compared to
 the parent project:
 
-* Author and branch names can be passed via cmdline without interaction by
-  the user. This means you can now do `git-py-stats -L "John Doe"` instead of
-  being prompted to enter the name after executing the non-interactive cmd.
+* Author, dates, and branch names can be passed via cmdline without interaction
+  by the user. This means you can now do `git-py-stats -L "John Doe"` instead
+  of being prompted to enter the name after executing the non-interactive cmd.
 * CSV output is now saved to a file instead of printing out to the terminal.
   This file will be saved to wherever the process was executed. The name will
   be `git_daily_stats.csv`
 * JSON output is saved to a file wherever the process was executed instead of
   one that is provided by the user. The name will be `git_log.json`
+* The New Contributors function shows the user's name next to the email in case
+  no known mailmap has been implemented for that user.
 
 ## Requirements
 

git_py_stats/arg_parser.py

@@ -84,7 +84,7 @@ def parse_arguments(argv: Optional[List[str]] = None) -> Namespace:
     )
     parser.add_argument(
         '-n', '--new-contributors',
-        action='store_true',
+        metavar='DATE',
         help='List everyone who made their first contribution since a specified date'
     )
     parser.add_argument(

git_py_stats/interactive_mode.py

@@ -18,7 +18,7 @@ def handle_interactive_mode() -> None:
         '8': list_cmds.branch_tree,
         '9': list_cmds.branches_by_date,
         '10': list_cmds.contributors,
-        '11': list_cmds.new_contributors,
+        '11': lambda: list_cmds.new_contributors(input("Enter cutoff date (YYYY-MM-DD): ")),
         '12': list_cmds.git_commits_per_author,
         '13': list_cmds.git_commits_per_date,
         '14': list_cmds.git_commits_per_month,

git_py_stats/list_cmds.py

@@ -172,23 +172,110 @@ def contributors() -> None:
     else:
         print('No contributors found.')
 
-def new_contributors() -> None:
+def new_contributors(new_date: str) -> None:
     """
-    Lists contributors sorted by email.
+    Lists all new contributors to a repo since the specified date.
+
+    Args:
+        new_date (str): Cutoff date for being considered "new" in 'YYYY-MM-DD' format.
+
+    Returns:
+        None
     """
-    
-    cmd = ['git', 'log', '--format=%aN|%aE']
+
+    # Attempt to handle date in YYYY-MM-DD format
+    try:
+        new_date_dt = datetime.strptime(new_date, '%Y-%m-%d')
+        new_date_ts = int(new_date_dt.timestamp())
+    except ValueError:
+        print("Invalid date format. Please use YYYY-MM-DD.")
+        return
+
+    # User adjustable vars
+    # TODO: Fix these later on
+    merges = "--no-merges"
+    since = ""  # Include the world for now
+    until = ""
+    log_options = ""
+    pathspec = ""
+
+    # Original command:
+    # git -c log.showSignature=false log --use-mailmap $_merges \
+    #     "$_since" "$_until" --format='%aE' $_log_options \
+    #     $_pathspec | sort -u
+    cmd = [
+        'git',
+        '-c', 'log.showSignature=false',
+        'log',
+        '--use-mailmap',
+        merges,
+        since,
+        until,
+        '--format=%aE|%at',
+        log_options,
+        pathspec
+    ]
+
+    # Remove any empty strings from the command to prevent Git misinterpretation
+    # Needed when we start messing with datetime stuff
+    cmd = [arg for arg in cmd if arg]
+
     output = run_git_command(cmd)
     if output:
-        contributors = set(output.split('\n'))
-        new_contributors_list = sorted(contributors, key=lambda x: x.split('|')[1])
-        print("New contributors:")
-        for contributor in new_contributors_list:
+        # Dictionary to store the earliest commit timestamp for each contributor
+        contributors_dict = {}
+
+        # Process each line of the Git output
+        for line in output.split('\n'):
             try:
-                name, email = contributor.split('|')
-                print(f"{name} <{email}>")
+                email, timestamp = line.split('|')
+                timestamp = int(timestamp)
+                # If the contributor is not in the dictionary or the current timestamp is earlier
+                if email not in contributors_dict or timestamp < contributors_dict[email]:
+                    contributors_dict[email] = timestamp
             except ValueError:
-                continue  # Skip lines that don't match the expected format
+                continue  # Skip lines that don't match format
+
+        # List to hold new contributors
+        new_contributors_list = []
+
+        # Iterate over contributors to find those who are new since 'new_date'
+        for email, first_commit_ts in contributors_dict.items():
+            if first_commit_ts >= new_date_ts:
+                # Retrieve the contributor's name
+                # Original command:
+                # git -c log.showSignature=false log --author="$c" \
+                #     --reverse --use-mailmap $_merges "$_since" "$_until" \
+                #     --format='%at' $_log_options $_pathspec | head -n 1
+                name_cmd = [
+                    'git',
+                    '-c', 'log.showSignature=false',
+                    'log',
+                    '--use-mailmap',
+                    '--format=%aN',
+                    '--author=' + email,
+                    '-n', '1'
+                ]
+
+                # Grab name + email if we can. Otherwise, just grab email
+                name = run_git_command(name_cmd)
+                if name:
+                    new_contributors_list.append((name, email))
+                else:
+                    new_contributors_list.append(("", email))
+
+        # Sort the list alphabetically by name to match the original
+        # and print all of this out
+        if new_contributors_list:
+            print(f"New contributors since {new_date}:\n")
+            sorted_new_contributors = sorted(new_contributors_list, key=lambda x: (x[0], x[1]))
+            for idx, (name, email) in enumerate(sorted_new_contributors, 1):
+                if name:
+                    print(f"{name} <{email}>")
+                else:
+                    print(f"<{email}>")
+        else:
+            print("No new contributors found since the specified date.")
     else:
         print('No contributors found.')
 

git_py_stats/non_interactive_mode.py

@@ -23,7 +23,7 @@ def handle_non_interactive_mode(args) -> None:
         'branch_tree': list_cmds.branch_tree,
         'branches_by_date': list_cmds.branches_by_date,
         'contributors': list_cmds.contributors,
-        'new_contributors': list_cmds.new_contributors,
+        'new_contributors': lambda: list_cmds.new_contributors(args.new_contributors),
         'commits_per_author': list_cmds.git_commits_per_author,
         'commits_per_day': list_cmds.git_commits_per_date,
         'commits_by_year': list_cmds.git_commits_per_year,