From b148b4601024f2a92f9d9b6ba711f8c26719781d Mon Sep 17 00:00:00 2001
From: Jay DeLuca <jaydeluca4@gmail.com>
Date: Wed, 27 Sep 2023 13:37:43 -0400
Subject: [PATCH] benchmarks working

---
 benchmark.py                 |  91 ++++++++++++++++++++++++++++++++
 github_client.py             |  23 ++++++--
 main.py                      |   8 ++-
 media/benchmark_output.png   | Bin 0 -> 44002 bytes
 readme.md                    |  58 ++++++++++++++------
 results_parser.py            |  46 ++++++++++++++++
 tests/results_parser_test.py |  25 +++++++++
 tests/test_utilities.py      |  99 ++++++++++++++++++++++++++++++++++-
 utilities.py                 |  13 +++++
 9 files changed, 338 insertions(+), 25 deletions(-)
 create mode 100644 benchmark.py
 create mode 100644 media/benchmark_output.png
 create mode 100644 results_parser.py
 create mode 100644 tests/results_parser_test.py

diff --git a/benchmark.py b/benchmark.py
new file mode 100644
index 0000000..378d448
--- /dev/null
+++ b/benchmark.py
@@ -0,0 +1,91 @@
+from typing import List
+
+import matplotlib.pyplot as plt
+import argparse
+from github_client import GithubClient
+from results_parser import parse
+from single_file_cache import SingleFileCache
+from utilities import get_dates_between, convert_to_plot
+from datetime import datetime
+from collections import defaultdict
+
+COMMIT_CACHE_FILE = 'cache/benchmark-date-commit-cache.json'
+REPORT_CACHE_FILE = 'cache/benchmark-report-cache.json'
+
+
+class BenchmarkApp:
+    def __init__(self, file_path: str):
+        self.client = GithubClient()
+        self.commit_cache = SingleFileCache(location=COMMIT_CACHE_FILE)
+        self.report_cache = SingleFileCache(location=REPORT_CACHE_FILE)
+        self.file_path = file_path
+
+    def get_commit_by_date(self, repository, date):
+        find_commit = self.commit_cache.retrieve_value(date)
+        if not find_commit:
+            find_commit = self.client.get_most_recent_commit(repository, date, "gh-pages")
+            if find_commit:
+                self.commit_cache.add_to_cache(date, find_commit)
+
+        return find_commit
+
+    def get_report_by_commit(self, repository, commit):
+        repo_data = self.report_cache.retrieve_value(commit)
+
+        if not repo_data:
+            repo_data = self.client.get_file_at_commit(repository=repository, filepath=self.file_path, commit_sha=commit)
+            self.report_cache.add_to_cache(commit, repo_data)
+
+        return repo_data
+
+
+def main(args):
+    file_path = "benchmark-overhead/results/release/summary.txt"
+
+    metrics = [
+        "Min heap used (MB)",
+        "Max heap used (MB)"
+    ]
+
+    timeframe = get_dates_between(args.start, datetime.now().date(), args.interval)
+    result = defaultdict(dict)
+
+    app = BenchmarkApp(file_path=file_path)
+
+    for snapshot in timeframe:
+        commit = app.get_commit_by_date(date=snapshot, repository=args.repo)
+
+        report = app.get_report_by_commit(repository=args.repo, commit=commit)
+        parsed = parse(report, metrics)
+        if parsed:
+            result[snapshot]["date"] = snapshot
+            for metric in metrics:
+                result[snapshot][metric] = parsed.metrics[metric]
+
+    dates, metric_values = convert_to_plot(result, metrics)
+
+    for metric, values in metric_values.items():
+        plt.plot(dates, values, label=metric)
+
+    plt.xlabel('Date')
+    plt.ylabel('MB')
+    plt.title('Benchmark Metrics')
+    plt.xticks(rotation=45)
+    plt.legend()
+    plt.tight_layout()
+    plt.show()
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description='Benchmark Tracker')
+    parser.add_argument("-r", "--repo",
+                        help="Repository name. "
+                             "ex: open-telemetry/opentelemetry-java-instrumentation",
+                        required=True)
+    parser.add_argument("-s", "--start",
+                        help="Starting Date (will calculate from this date until now)",
+                        required=True)
+    parser.add_argument("-i", "--interval",
+                        help="Interval (in days) between data points", required=True)
+    arguments = parser.parse_args()
+    main(arguments)
diff --git a/github_client.py b/github_client.py
index 131ecd0..58c6342 100644
--- a/github_client.py
+++ b/github_client.py
@@ -1,3 +1,5 @@
+import base64
+
 import requests
 import os
 
@@ -17,13 +19,14 @@ def _get(self, url, params=None):
         except Exception as e:
             print(e)
 
-    def get_most_recent_commit(self, repo, timestamp) -> requests.models.Response:
+    def get_most_recent_commit(self, repo: str, timestamp: str, branch: str) -> requests.models.Response:
         api_url = f"{self.base_url}/repos/{repo}/commits"
 
         params = {
             "per_page": 1,
             "until": timestamp,
-            "order": "desc"
+            "order": "desc",
+            "sha": branch
         }
 
         response = self._get(api_url, params=params)
@@ -40,7 +43,7 @@ def get_most_recent_commit(self, repo, timestamp) -> requests.models.Response:
             print(f"Error: {response.status_code}")
             return None
 
-    def get_repository_at_commit(self, repository, commit_sha):
+    def get_repository_at_commit(self, repository: str, commit_sha: str):
         api_url = f"{self.base_url}/repos/{repository}/git/trees/{commit_sha}?recursive=1"
 
         response = self._get(api_url)
@@ -50,3 +53,17 @@ def get_repository_at_commit(self, repository, commit_sha):
         else:
             print(f"Error: {response.status_code}")
             return None
+
+    def get_file_at_commit(self, repository: str, filepath: str, commit_sha: str):
+        api_url = f"{self.base_url}/repos/{repository}/contents/{filepath}"
+
+        response = self._get(api_url, params={"ref": commit_sha})
+
+        if response.status_code == 200:
+            # File content is base64 encoded, decode it
+            content = response.json().get("content", "")
+            content = base64.b64decode(content)
+            return str(content, encoding='utf-8')
+        else:
+            print(f"Error: {response.status_code}")
+            return None
diff --git a/main.py b/main.py
index 83f8312..cff5324 100644
--- a/main.py
+++ b/main.py
@@ -7,7 +7,7 @@
 
 from data_filter import DataFilter
 from multi_file_cache import MultiFileCache
-from utilities import count_by_file_extension, get_dates_between
+from utilities import count_by_file_extension, get_dates_between, convert_to_plot
 
 from single_file_cache import SingleFileCache
 from github_client import GithubClient
@@ -27,7 +27,7 @@ def __init__(self, languages: List[str], path_prefix: str, keyword: str):
     def get_commit_by_date(self, repository, date):
         find_commit = self.commit_cache.retrieve_value(date)
         if not find_commit:
-            find_commit = self.client.get_most_recent_commit(repository, date)
+            find_commit = self.client.get_most_recent_commit(repository, date, "main")
             if find_commit:
                 self.commit_cache.add_to_cache(date, find_commit)
 
@@ -74,9 +74,7 @@ def main(args):
         except Exception as e:
             print(f"Error for {snapshot}, {e}")
 
-    dates = []
-
-    language_counts = {}
+    dates, language_counts = convert_to_plot(result, languages)
 
     for item in result.values():
         dates.append(item["date"][:10])
diff --git a/media/benchmark_output.png b/media/benchmark_output.png
new file mode 100644
index 0000000000000000000000000000000000000000..fdd0a52bb8cbcd144cdb10c05b0209e8cbb1494e
GIT binary patch
literal 44002
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

literal 0
HcmV?d00001

diff --git a/readme.md b/readme.md
index 93fb746..5d4582d 100644
--- a/readme.md
+++ b/readme.md
@@ -1,6 +1,10 @@
-# Code Migration Tracker
+# Repo Metrics
 
-Goal: Given a repository, a timeframe, and any filtering rules, track a goal over time.
+Random collection of tools to pull and visualize various data about a repository as timeseries metrics.
+
+Functionality:
+* Timeseries file count tracking: for tracking migration projects from one language to another.
+* Pull benchmark data and visualize as timeseries
 
 ## Setup
 
@@ -11,7 +15,23 @@ export GITHUB_TOKEN="insert-your-token"
 make install
 ```
 
-## Arguments
+## Test / linting
+
+```
+# Make sure you install pytest and ruff
+make install
+
+# Tests
+make test
+
+# Linting
+make lint
+```
+
+
+## File Count Tracking
+
+### Arguments
 
 | Argument   | Command        | Description                                                                | Example                                                    |
 |------------|----------------|----------------------------------------------------------------------------|------------------------------------------------------------|
@@ -20,7 +40,7 @@ make install
 | Interval   | -i, --interval | Interval (in days) between data points                                     | --interval 14                                              |
 
 
-## Example Usage:
+### Example Usage:
 
 In the `open-telemetry/opentelemetry-java-instrumentation` repository, track the conversion of tests from groovy to java 
 in the `instrumentation` directory starting from 2022-11-15 with a data point every 2 weeks.
@@ -32,19 +52,28 @@ Output:
 ![Example](./media/example_output.png)
 
 
-## Test / linting
+## Benchmark Visualization
 
-```
-# Make sure you install pytest and ruff
-make install
+This is very specific to the open-telemetry/opentelemetry-java-instrumentation repo
 
-# Tests
-make test
+### Arguments
 
-# Linting
-make lint
-```
+| Argument   | Command        | Description                                                                | Example                                                    |
+|------------|----------------|----------------------------------------------------------------------------|------------------------------------------------------------|
+| Repository | -r, --repo     | Repository name.                                                           | --repo "open-telemetry/opentelemetry-java-instrumentation" |
+| Start Date | -s, --start    | Starting Date in format %Y-%m-%d (will calculate from this date until now) | --start "2022-11-15"                                       |
+| Interval   | -i, --interval | Interval (in days) between data points                                     | --interval 14                                              |
+
+
+### Example Usage:
+
+Chart Min and max heap starting from 2022-02-14 with a data point every 30 days.
 
+`python benchmark.py -r "open-telemetry/opentelemetry-java-instrumentation" -s "2022-02-14" -i 30`
+
+Output:
+
+![Example](./media/benchmark_output.png)
 
 ## Approach
 
@@ -54,6 +83,3 @@ make lint
   - Cache this data locally to avoid repeated api calls
 - Generate Graph to show results over time frame
 
-
-## Data Filters
-
diff --git a/results_parser.py b/results_parser.py
new file mode 100644
index 0000000..e413cf5
--- /dev/null
+++ b/results_parser.py
@@ -0,0 +1,46 @@
+from datetime import datetime
+from typing import List
+
+
+class ReportMetrics:
+    def __init__(self, date: str):
+        self.date = date
+        self.metrics = {}
+
+
+def parse(report: str, metrics: List[str]) -> ReportMetrics:
+    if report is None:
+        return None
+
+    split = report.split("----------------------------------------------------------\n")
+
+    metrics_split = split[2].split("\n")
+    date = convert_to_desired_format(split[1].split("Run at ")[1].split("\n")[0])
+
+    report_metrics = ReportMetrics(date=date)
+
+    try:
+        for line in metrics_split:
+            for metric in metrics:
+
+                if line.startswith(metric):
+                    values = line.split(":")
+                    report_metrics.metrics[metric] = float(values[1].split()[1])
+    except IndexError:
+        return None
+
+    return report_metrics
+
+
+def convert_to_desired_format(date_str):
+    # Define the input and output date formats
+    input_format = "%a %b %d %H:%M:%S UTC %Y"
+    output_format = "%Y-%m-%d"
+
+    try:
+        parsed_date = datetime.strptime(date_str, input_format)
+        formatted_date = parsed_date.strftime(output_format)
+        return formatted_date
+    except ValueError:
+        print("Invalid date format")
+        return None
diff --git a/tests/results_parser_test.py b/tests/results_parser_test.py
new file mode 100644
index 0000000..dfa3cb0
--- /dev/null
+++ b/tests/results_parser_test.py
@@ -0,0 +1,25 @@
+import unittest
+
+from results_parser import parse
+
+
+class ResultsParserTestCase(unittest.TestCase):
+
+    def __init__(self, *args, **kwargs):
+        self.example = """----------------------------------------------------------\n Run at Sat Sep 23 05:22:19 UTC 2023\n release : compares no agent, latest stable, and latest snapshot agents\n 5 users, 5000 iterations\n----------------------------------------------------------\nAgent               :              none           latest         snapshot\nRun duration        :          00:02:27         00:02:57         00:03:06\nAvg. CPU (user) %   :        0.46024063       0.48809186       0.49900937\nMax. CPU (user) %   :         0.5527638        0.5891089              0.6\nAvg. mch tot cpu %  :         0.9943353       0.99306744        0.9932704\nStartup time (ms)   :             19598            16351            17050\nTotal allocated MB  :          27799.50         34195.20         58039.97\nMin heap used (MB)  :             88.10           115.85           112.63\nMax heap used (MB)  :            365.90           557.00           478.78\nThread switch rate  :          28534.94        29848.291        32354.986\nGC time (ms)        :              1800             3014             2928\nGC pause time (ms)  :              1814             3052             2959\nReq. mean (ms)      :             10.74            12.82            13.51\nReq. p95 (ms)       :             32.04            38.45            40.28\nIter. mean (ms)     :            144.60           173.90           182.65\nIter. p95 (ms)      :            233.74           275.94           291.89\nNet read avg (bps)  :        5441971.00       4728712.00       4507975.00\nNet write avg (bps) :        7256048.00      25533599.00      24434992.00\nPeak threads        :                43               55               56\n"""
+        self.metrics = [
+            "Min heap used (MB)",
+            "Max heap used (MB)"
+        ]
+        super(ResultsParserTestCase, self).__init__(*args, **kwargs)
+
+    def test_parse_metrics_from_summary(self):
+        result = parse(report=self.example, metrics=self.metrics)
+        self.assertEqual(557.00, result.metrics["Max heap used (MB)"])
+        self.assertEqual(115.85, result.metrics["Min heap used (MB)"])
+
+    def test_parse_date_from_summary(self):
+        result = parse(report=self.example, metrics=self.metrics)
+        self.assertEqual("2023-09-23", result.date)
+
+
diff --git a/tests/test_utilities.py b/tests/test_utilities.py
index b25200a..aafcfdf 100644
--- a/tests/test_utilities.py
+++ b/tests/test_utilities.py
@@ -1,6 +1,7 @@
+from collections import defaultdict
 from unittest import TestCase
 
-from utilities import get_dates_between, count_by_file_extension
+from utilities import get_dates_between, count_by_file_extension, convert_to_plot
 from datetime import datetime
 
 
@@ -56,3 +57,99 @@ def test_count_by_file_extension(self):
         self.assertEqual(2, result['groovy'])
         self.assertEqual(1, result['txt'])
 
+    def test_report_generator(self):
+        metrics = [
+            "Min heap used (MB)",
+            "Max heap used (MB)"
+        ]
+
+        expected_dates = ['2022-11-16', '2022-11-30', '2022-12-14', '2022-12-28',
+                          '2023-01-11', '2023-01-25', '2023-02-08', '2023-02-22',
+                          '2023-03-08', '2023-03-22', '2023-04-05', '2023-04-19',
+                          '2023-05-03', '2023-05-17', '2023-05-31', '2023-06-14',
+                          '2023-06-28', '2023-07-12', '2023-07-26', '2023-08-09',
+                          '2023-08-23', '2023-09-06', '2023-09-20']
+
+        test = {'2022-11-16T00:00:00Z': {'date': '2022-11-16T00:00:00Z',
+                                         'Min heap used (MB)': 88.37,
+                                         'Max heap used (MB)': 360.79},
+                '2022-11-30T00:00:00Z': {'date': '2022-11-30T00:00:00Z',
+                                         'Min heap used (MB)': 93.24,
+                                         'Max heap used (MB)': 357.57},
+                '2022-12-14T00:00:00Z': {'date': '2022-12-14T00:00:00Z',
+                                         'Min heap used (MB)': 93.12,
+                                         'Max heap used (MB)': 489.0},
+                '2022-12-28T00:00:00Z': {'date': '2022-12-28T00:00:00Z',
+                                         'Min heap used (MB)': 93.36,
+                                         'Max heap used (MB)': 339.98},
+                '2023-01-11T00:00:00Z': {'date': '2023-01-11T00:00:00Z',
+                                         'Min heap used (MB)': 90.34,
+                                         'Max heap used (MB)': 448.27},
+                '2023-01-25T00:00:00Z': {'date': '2023-01-25T00:00:00Z',
+                                         'Min heap used (MB)': 90.57,
+                                         'Max heap used (MB)': 343.99},
+                '2023-02-08T00:00:00Z': {'date': '2023-02-08T00:00:00Z',
+                                         'Min heap used (MB)': 88.31,
+                                         'Max heap used (MB)': 389.67},
+                '2023-02-22T00:00:00Z': {'date': '2023-02-22T00:00:00Z',
+                                         'Min heap used (MB)': 89.99,
+                                         'Max heap used (MB)': 334.34},
+                '2023-03-08T00:00:00Z': {'date': '2023-03-08T00:00:00Z',
+                                         'Min heap used (MB)': 85.4,
+                                         'Max heap used (MB)': 340.25},
+                '2023-03-22T00:00:00Z': {'date': '2023-03-22T00:00:00Z',
+                                         'Min heap used (MB)': 94.67,
+                                         'Max heap used (MB)': 362.89},
+                '2023-04-05T00:00:00Z': {'date': '2023-04-05T00:00:00Z',
+                                         'Min heap used (MB)': 83.31,
+                                         'Max heap used (MB)': 406.11},
+                '2023-04-19T00:00:00Z': {'date': '2023-04-19T00:00:00Z',
+                                         'Min heap used (MB)': 108.68,
+                                         'Max heap used (MB)': 474.59},
+                '2023-05-03T00:00:00Z': {'date': '2023-05-03T00:00:00Z',
+                                         'Min heap used (MB)': 90.29,
+                                         'Max heap used (MB)': 396.23},
+                '2023-05-17T00:00:00Z': {'date': '2023-05-17T00:00:00Z',
+                                         'Min heap used (MB)': 96.5,
+                                         'Max heap used (MB)': 448.06},
+                '2023-05-31T00:00:00Z': {'date': '2023-05-31T00:00:00Z',
+                                         'Min heap used (MB)': 94.72,
+                                         'Max heap used (MB)': 362.23},
+                '2023-06-14T00:00:00Z': {'date': '2023-06-14T00:00:00Z',
+                                         'Min heap used (MB)': 112.4,
+                                         'Max heap used (MB)': 483.55},
+                '2023-06-28T00:00:00Z': {'date': '2023-06-28T00:00:00Z',
+                                         'Min heap used (MB)': 109.7,
+                                         'Max heap used (MB)': 478.83},
+                '2023-07-12T00:00:00Z': {'date': '2023-07-12T00:00:00Z',
+                                         'Min heap used (MB)': 115.64,
+                                         'Max heap used (MB)': 511.06},
+                '2023-07-26T00:00:00Z': {'date': '2023-07-26T00:00:00Z',
+                                         'Min heap used (MB)': 117.18,
+                                         'Max heap used (MB)': 545.65},
+                '2023-08-09T00:00:00Z': {'date': '2023-08-09T00:00:00Z',
+                                         'Min heap used (MB)': 111.84,
+                                         'Max heap used (MB)': 483.33},
+                '2023-08-23T00:00:00Z': {'date': '2023-08-23T00:00:00Z',
+                                         'Min heap used (MB)': 114.26,
+                                         'Max heap used (MB)': 503.5},
+                '2023-09-06T00:00:00Z': {'date': '2023-09-06T00:00:00Z',
+                                         'Min heap used (MB)': 116.66,
+                                         'Max heap used (MB)': 554.82},
+                '2023-09-20T00:00:00Z': {'date': '2023-09-20T00:00:00Z',
+                                         'Min heap used (MB)': 103.79,
+                                         'Max heap used (MB)': 521.74}}
+
+        expected_plots = {
+            'Min heap used (MB)': [88.37, 93.24, 93.12, 93.36, 90.34, 90.57, 88.31,
+                                   89.99, 85.4, 94.67, 83.31, 108.68, 90.29, 96.5,
+                                   94.72, 112.4, 109.7, 115.64, 117.18, 111.84, 114.26,
+                                   116.66, 103.79],
+            'Max heap used (MB)': [360.79, 357.57, 489.0, 339.98, 448.27, 343.99,
+                                   389.67, 334.34, 340.25, 362.89, 406.11, 474.59,
+                                   396.23, 448.06, 362.23, 483.55, 478.83, 511.06,
+                                   545.65, 483.33, 503.5, 554.82, 521.74]}
+
+        dates, plots = convert_to_plot(test, metrics)
+        self.assertEqual(expected_plots, plots)
+        self.assertEqual(expected_dates, dates)
diff --git a/utilities.py b/utilities.py
index a8ccf1f..651fef9 100644
--- a/utilities.py
+++ b/utilities.py
@@ -35,3 +35,16 @@ def count_by_file_extension(files: List[str], languages: List[str]) -> dict:
             if file.endswith(extension):
                 file_counts[ext] += 1
     return file_counts
+
+
+def convert_to_plot(input_dict: dict, items):
+    result = {}
+    dates = []
+    for entry in input_dict.values():
+        dates.append(entry["date"][:10])
+        for item in items:
+            try:
+                result[item].append(entry[item])
+            except KeyError:
+                result[item] = [entry[item]]
+    return dates, result