Update repo

Co-Authored-By: Divyanshu Bhardwaj <[email protected]>

Author: egedemirci

README.md

@@ -1,2 +1,37 @@
 # Performance-Comparison-of-Python-Runtime-Systems
-Performance Comparison of Python Runtime Systems: CPython, PyPy, and IronPython.
+This repository is codebase for Runtime Systems project. We implement and evaluate runtime and memory metrics for various benchmarks across three python interpreters - CPython3, PyPy3 and Jython. 
+
+## Set Up
+To setup and replicate our benchmark data, installing the same version of interpreters is necessary. To install, run
+
+''' github clone link_to_the_repository
+cd path_to_repository
+chmod x+w setup.sh
+./setup.sh
+'''
+
+## Recording runtime for benchmarks
+All the benchmarks are located in experiment/benchmarks directory. To run all the benchmarks and record runtime, run
+
+'''
+python3 run_experiments.py
+'''
+
+This would automatically run all benchmarks across all interpreters and store the runtimes in results.csv in the main directory.
+
+## Memory Profiler Set Up
+We use memory_profiler which is the standard python memory profiling tool to collect memory usage statistics. Memory profiler has to be installed individually for each interpreters as follows:
+'''
+python3 -m pip install memory_profiler
+pypy3 -m pip install memory_profiler
+jython -m pip install memory_profiler
+'''
+
+## Memory Profiling
+For each benchmark, run
+'''
+python3 -m mprof run benchmark.py
+mprof plot
+'''
+
+This would produce a matplot with graph showing memory usage against runtime. Note: Plotting the graph requires matplotlib package.s

experiment/benchmarks/prime.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+
+import time
+import json
+from memory_profiler import profile 
+
+def is_prime(n):
+    """
+    Basic primality test with O(sqrt(n)) complexity.
+    """
+    if n <= 1:
+        return False
+    if n <= 3:
+        return True
+    if n % 2 == 0 or n % 3 == 0:
+        return False
+    
+    i = 5
+    while i * i <= n:
+        if n % i == 0 or n % (i + 2) == 0:
+            return False
+        i += 6
+    return True
+
+@profile
+def prime_count(limit):
+    """
+    Counts how many primes exist up to `limit`.
+    """
+    count = 0
+    for x in range(1, limit + 1):
+        if is_prime(x):
+            count += 1
+    return count
+
+def benchmark_cpu_intensive(limit=100000):
+    """
+    A CPU-intensive benchmark that counts primes up to `limit`.
+    Returns the number of primes found and the total runtime.
+    """
+    start_time = time.time()
+    total_primes = prime_count(limit)
+    end_time = time.time()
+    return total_primes, end_time - start_time
+
+if __name__ == "__main__":
+    limit = 5000000
+    primes, runtime = benchmark_cpu_intensive(limit)
+    
+    result = {
+        "benchmark": "cpu_bound_prime_count",
+        "limit": limit,
+        "prime_count": primes,
+        "runtime": runtime,
+        "timestamp": time.time()
+    }
+    print(json.dumps(result))

github

@@ -0,0 +1,7 @@
+-----BEGIN OPENSSH PRIVATE KEY-----
+b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW
+QyNTUxOQAAACDgf6g3CO14/bc4p1PoP5j4KgkGbaLxWfL4gjmv2AqPGQAAAKDHUNNHx1DT
+RwAAAAtzc2gtZWQyNTUxOQAAACDgf6g3CO14/bc4p1PoP5j4KgkGbaLxWfL4gjmv2AqPGQ
+AAAEAbezo6SqfsJLVZMhb4pWng//CBmVyZGgT360oJZxFjTuB/qDcI7Xj9tzinU+g/mPgq
+CQZtovFZ8viCOa/YCo8ZAAAAHWQxdnlhYW5zaHUuYmhhcmR3YWpAZ21haWwuY29t
+-----END OPENSSH PRIVATE KEY-----

github.pub

@@ -0,0 +1 @@
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOB/qDcI7Xj9tzinU+g/mPgqCQZtovFZ8viCOa/YCo8Z [email protected]

setup.sh

@@ -0,0 +1,57 @@
+
+
+#!/bin/bash
+set -euo pipefail
+##Script for installing all three interpreters.
+# Update system and install dependencies
+sudo apt-get update -qq
+sudo apt-get install -qq -y software-properties-common wget
+
+# Install Python 3
+if ! command -v python3 &> /dev/null; then
+    echo "Installing Python 3..."
+    sudo apt-get install -qq -y python3 python3-pip
+else
+    echo "Python 3 already installed"
+fi
+
+# Install PyPy3
+if ! command -v pypy3 &> /dev/null; then
+    echo "Installing PyPy3..."
+    sudo add-apt-repository -y universe
+    sudo apt-get update -qq
+    sudo apt-get install -qq -y pypy3 libssl-dev
+    sudo ln -sf /usr/bin/pypy3 /usr/local/bin/pypy3
+else
+    echo "PyPy3 already installed"
+fi
+
+# Install Jython dependencies (Java)
+if ! command -v java &> /dev/null; then
+    echo "Installing Java (Jython dependency)..."
+    sudo apt-get install -qq -y openjdk-17-jdk
+else
+    echo "Java already installed"
+fi
+
+# Install Jython
+JYTHON_VERSION="2.7.3"
+JYTHON_DIR="/opt/jython"
+if ! command -v jython &> /dev/null; then
+    echo "Installing Jython ${JYTHON_VERSION}..."
+    sudo mkdir -p "${JYTHON_DIR}"
+    sudo wget -q "https://repo1.maven.org/maven2/org/python/jython-installer/${JYTHON_VERSION}/jython-installer-${JYTHON_VERSION}.jar" -O /tmp/jython_installer.jar
+    sudo java -jar /tmp/jython_installer.jar -s -d "${JYTHON_DIR}" -t standard
+    sudo ln -sf "${JYTHON_DIR}/bin/jython" /usr/local/bin/jython
+    sudo rm /tmp/jython_installer.jar
+else
+    echo "Jython already installed"
+fi
+
+# Verify installations
+echo -e "\nInstallation verification:"
+echo "Python 3: $(python3 --version 2>&1) [$(which python3)]"
+echo "PyPy3: $(pypy3 --version 2>&1) [$(which pypy3)]"
+echo "Jython: $(jython --version 2>&1) [$(which jython)]"
+
+echo -e "\nInstallation completed successfully!"