codegreen 0.3.1__tar.gz → 0.3.2__tar.gz

{codegreen-0.3.1 → codegreen-0.3.2}/CMakeLists.txt

@@ -84,7 +84,7 @@ add_custom_target(dev-install ALL
     DEPENDS codegreen-nemb
     COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_SOURCE_DIR}/lib
     COMMAND ${CMAKE_COMMAND} -E copy
-        ${CMAKE_BINARY_DIR}/lib/libcodegreen-nemb${CMAKE_SHARED_LIBRARY_SUFFIX}
+        $<TARGET_FILE:codegreen-nemb>
         ${CMAKE_SOURCE_DIR}/lib/
     COMMENT "Dev-install: copying NEMB to ${CMAKE_SOURCE_DIR}/lib/"
 )

{codegreen-0.3.1/codegreen.egg-info → codegreen-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.3.1
+Version: 0.3.2
 Summary: Energy-aware software development tool for measuring and optimizing code energy consumption
 Author-email: Saurabhsingh Rajput <saurabh@dal.ca>
 Maintainer-email: Saurabhsingh Rajput <saurabh@dal.ca>

{codegreen-0.3.1 → codegreen-0.3.2}/benchmark/profilers.py

@@ -202,11 +202,79 @@ class NativeProfiler(ProfilerInterface):
     def is_available(self) -> bool:
         return True
 
+class CodeCarbonProfiler(ProfilerInterface):
+    """Wraps CodeCarbon for energy measurement (requires: pip install codecarbon)."""
+    def run(self, cmd: List[str], timeout: int = 300) -> ProfileResult:
+        try:
+            from codecarbon import EmissionsTracker
+        except ImportError:
+            return ProfileResult(0.0, 0.0, "", [], {"error": "codecarbon not installed"})
+        tracker = EmissionsTracker(log_level="error", save_to_file=False)
+        tracker.start()
+        start = time.perf_counter()
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout)
+        elapsed = time.perf_counter() - start
+        emissions = tracker.stop()
+        energy = tracker._total_energy.kWh * 3_600_000  # kWh -> J
+        return ProfileResult(energy, elapsed, result.stdout, [],
+                             {"emissions_kg_co2": emissions, "energy_kwh": tracker._total_energy.kWh})
+
+    def is_available(self) -> bool:
+        try:
+            import codecarbon
+            return True
+        except ImportError:
+            return False
+
+
+class JoularJXProfiler(ProfilerInterface):
+    """Wraps JoularJX for Java energy measurement (requires JoularJX agent jar)."""
+    def __init__(self, agent_path: str = ""):
+        self.agent_path = agent_path or self._find_agent()
+
+    def _find_agent(self) -> str:
+        for p in [Path("joularjx-agent.jar"), Path.home() / ".joularjx" / "joularjx-agent.jar"]:
+            if p.exists():
+                return str(p)
+        return ""
+
+    def run(self, cmd: List[str], timeout: int = 300) -> ProfileResult:
+        if not self.agent_path:
+            return ProfileResult(0.0, 0.0, "", [], {"error": "JoularJX agent not found"})
+        jx_cmd = cmd.copy()
+        if cmd[0] == "java":
+            jx_cmd.insert(1, f"-javaagent:{self.agent_path}")
+        start = time.perf_counter()
+        result = subprocess.run(jx_cmd, capture_output=True, text=True, timeout=timeout)
+        elapsed = time.perf_counter() - start
+        energy = self._parse_joularjx_output()
+        return ProfileResult(energy, elapsed, result.stdout, [], {"agent": self.agent_path})
+
+    def _parse_joularjx_output(self) -> float:
+        csv_path = Path("joularJX-all-methods-energy.csv")
+        if not csv_path.exists():
+            return 0.0
+        total = 0.0
+        for line in csv_path.read_text().splitlines()[1:]:
+            parts = line.split(",")
+            if len(parts) >= 2:
+                try:
+                    total += float(parts[-1])
+                except ValueError:
+                    pass
+        return total
+
+    def is_available(self) -> bool:
+        return bool(self.agent_path) and Path(self.agent_path).exists()
+
+
 def get_profiler(name: str) -> ProfilerInterface:
     profilers = {
         "codegreen": CodeGreenProfiler,
         "perf": PerfProfiler,
         "native": NativeProfiler,
+        "codecarbon": CodeCarbonProfiler,
+        "joularjx": JoularJXProfiler,
     }
     if name not in profilers:
         raise ValueError(f"Unknown profiler: {name}. Available: {list(profilers.keys())}")

{codegreen-0.3.1 → codegreen-0.3.2}/benchmark/suites/__init__.py

@@ -2,10 +2,14 @@
 from benchmark.suites.base import Suite, Task
 from benchmark.suites.benchmarksgame import BenchmarksgameSuite
 from benchmark.suites.perfopt import PerfOptSuite
+from benchmark.suites.dacapo import DaCapoSuite
+from benchmark.suites.renaissance import RenaissanceSuite
 
 SUITES = {
     "benchmarksgame": BenchmarksgameSuite,
     "perfopt": PerfOptSuite,
+    "dacapo": DaCapoSuite,
+    "renaissance": RenaissanceSuite,
 }
 
 def get_suite(name: str, **kwargs) -> Suite:

codegreen-0.3.2/benchmark/suites/dacapo.py

@@ -0,0 +1,45 @@
+"""DaCapo benchmark suite for Java workloads.
+Requires: DaCapo jar downloaded from https://dacapobench.org/
+Usage: codegreen benchmark --suite dacapo --dataset-dir /path/to/dacapo.jar
+"""
+from pathlib import Path
+from typing import List, Optional
+from benchmark.suites.base import Suite, Task
+
+DACAPO_BENCHMARKS = [
+    "avrora", "batik", "biojava", "cassandra", "eclipse", "fop",
+    "graphchi", "h2", "h2o", "jme", "jython", "kafka",
+    "luindex", "lusearch", "pmd", "spring", "sunflow",
+    "tomcat", "tradebeans", "tradesoap", "xalan", "zxing",
+]
+
+
+class DaCapoSuite(Suite):
+    def __init__(self, dataset_dir: str = "", benchmarks: List[str] = None):
+        self.jar_path = Path(dataset_dir) if dataset_dir else None
+        self.benchmarks = benchmarks or DACAPO_BENCHMARKS
+
+    @property
+    def name(self) -> str:
+        return "dacapo"
+
+    def discover(self, filters: Optional[dict] = None) -> List[Task]:
+        if not self.jar_path or not self.jar_path.exists():
+            raise FileNotFoundError(f"DaCapo jar not found at {self.jar_path}. "
+                                    "Download from https://dacapobench.org/")
+        selected = self.benchmarks
+        if filters and "benchmarks" in filters:
+            selected = [b for b in selected if b in filters["benchmarks"]]
+        return [Task(
+            name=b, language="java",
+            run_command=["java", "-jar", str(self.jar_path), b],
+            variant="default",
+            metadata={"suite": "dacapo", "benchmark": b}
+        ) for b in selected]
+
+    def build(self, task: Task) -> Task:
+        return task  # DaCapo is pre-built
+
+    @property
+    def default_timeout(self) -> int:
+        return 600

codegreen-0.3.2/benchmark/suites/renaissance.py

@@ -0,0 +1,48 @@
+"""Renaissance benchmark suite for modern JVM workloads.
+Requires: Renaissance jar downloaded from https://renaissance.dev/
+Usage: codegreen benchmark --suite renaissance --dataset-dir /path/to/renaissance.jar
+"""
+from pathlib import Path
+from typing import List, Optional
+from benchmark.suites.base import Suite, Task
+
+RENAISSANCE_BENCHMARKS = [
+    "akka-uct", "als", "chi-square", "db-shootout", "dec-tree",
+    "dotty", "finagle-chirper", "finagle-http", "fj-kmeans",
+    "future-genetic", "gauss-mix", "log-regression", "mnemonics",
+    "movie-lens", "naive-bayes", "neo4j-analytics", "page-rank",
+    "par-mnemonics", "philosophers", "reactors", "rx-scrabble",
+    "scala-doku", "scala-kmeans", "scala-stm-bench7", "scrabble",
+]
+
+
+class RenaissanceSuite(Suite):
+    def __init__(self, dataset_dir: str = "", benchmarks: List[str] = None, repetitions: int = 1):
+        self.jar_path = Path(dataset_dir) if dataset_dir else None
+        self.benchmarks = benchmarks or RENAISSANCE_BENCHMARKS
+        self.repetitions = repetitions
+
+    @property
+    def name(self) -> str:
+        return "renaissance"
+
+    def discover(self, filters: Optional[dict] = None) -> List[Task]:
+        if not self.jar_path or not self.jar_path.exists():
+            raise FileNotFoundError(f"Renaissance jar not found at {self.jar_path}. "
+                                    "Download from https://renaissance.dev/")
+        selected = self.benchmarks
+        if filters and "benchmarks" in filters:
+            selected = [b for b in selected if b in filters["benchmarks"]]
+        return [Task(
+            name=b, language="java",
+            run_command=["java", "-jar", str(self.jar_path), b, "-r", str(self.repetitions)],
+            variant="default",
+            metadata={"suite": "renaissance", "benchmark": b, "repetitions": self.repetitions}
+        ) for b in selected]
+
+    def build(self, task: Task) -> Task:
+        return task
+
+    @property
+    def default_timeout(self) -> int:
+        return 900

{codegreen-0.3.1 → codegreen-0.3.2}/codegreen/__init__.py

@@ -5,7 +5,7 @@ A comprehensive energy measurement and code optimization tool for developers
 and researchers who need precise, fine-grained energy consumption analysis.
 """
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 __author__ = "Saurabhsingh Rajput"
 __email__ = "saurabh@dal.ca"
 __description__ = "Energy-aware software development tool"

{codegreen-0.3.1 → codegreen-0.3.2}/codegreen/cli/cli.py

@@ -2325,11 +2325,30 @@ def run_command(
             "budget_exceeded": budget is not None and e_stats.mean > budget
         }, indent=2))
     else:
+        # Coefficient of variation: signal-to-noise indicator
+        cv = (e_stats.std / e_stats.mean * 100) if e_stats.mean > 0 else 0
+        ci_width = e_stats.ci95_upper - e_stats.ci95_lower
+        ci_pct = (ci_width / e_stats.mean * 100) if e_stats.mean > 0 else 0
+
+        # Color-code by measurement quality
+        if cv < 5:
+            quality, color = "excellent", "green"
+        elif cv < 15:
+            quality, color = "good", "yellow"
+        elif cv < 30:
+            quality, color = "moderate", "bright_yellow"
+        else:
+            quality, color = "high noise", "red"
+
         console.print(f"\n[bold]Energy:[/bold] {e_stats.mean:.4f} J +/- {e_stats.std:.4f} J")
-        console.print(f"  Range: [{e_stats.min:.4f} .. {e_stats.max:.4f}] J, "
-                       f"CI95: [{e_stats.ci95_lower:.4f}, {e_stats.ci95_upper:.4f}] J")
+        console.print(f"  Range: [{e_stats.min:.4f} .. {e_stats.max:.4f}] J")
+        console.print(f"  CI95:  [{e_stats.ci95_lower:.4f}, {e_stats.ci95_upper:.4f}] J ({ci_pct:.1f}% width)")
+        console.print(f"  CV:    [{color}]{cv:.1f}% ({quality})[/{color}]")
         console.print(f"[bold]Time:[/bold]   {t_stats.mean:.4f} s +/- {t_stats.std:.4f} s")
+        console.print(f"[bold]Power:[/bold]  {e_stats.mean / t_stats.mean:.2f} W (avg)")
         console.print(f"  Runs: {len(energies)}, Outliers removed: {e_stats.outliers_removed}")
+        if cv > 20:
+            console.print(f"[yellow]  Tip: high variance -- try --repeat 30 or reduce background load[/yellow]")
         if budget is not None:
             if e_stats.mean > budget:
                 console.print(f"[red]BUDGET EXCEEDED: {e_stats.mean:.4f}J > {budget}J[/red]")

{codegreen-0.3.1 → codegreen-0.3.2/codegreen.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.3.1
+Version: 0.3.2
 Summary: Energy-aware software development tool for measuring and optimizing code energy consumption
 Author-email: Saurabhsingh Rajput <saurabh@dal.ca>
 Maintainer-email: Saurabhsingh Rajput <saurabh@dal.ca>

{codegreen-0.3.1 → codegreen-0.3.2}/codegreen.egg-info/SOURCES.txt

@@ -15,7 +15,9 @@ benchmark/results.py
 benchmark/suites/__init__.py
 benchmark/suites/base.py
 benchmark/suites/benchmarksgame.py
+benchmark/suites/dacapo.py
 benchmark/suites/perfopt.py
+benchmark/suites/renaissance.py
 benchmark/validation/__init__.py
 benchmark/validation/analysis.py
 benchmark/validation/experiments.py

{codegreen-0.3.1 → codegreen-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codegreen"
-version = "0.3.1"
+version = "0.3.2"
 description = "Energy-aware software development tool for measuring and optimizing code energy consumption"
 readme = "README.md"
 license = {file = "LICENSE"}

{codegreen-0.3.1 → codegreen-0.3.2}/tests/test_instrumentation.py

@@ -184,7 +184,7 @@ SAMPLES = {
     "java": (".java", JAVA_SAMPLE, 3),
     "c": (".c", C_SAMPLE, 3),
     "cpp": (".cpp", CPP_SAMPLE, 3),
-    "javascript": (".js", JS_SAMPLE, 2),
+    "javascript": (".js", JS_SAMPLE, 4),
 }
 
 
@@ -215,8 +215,7 @@ class TestInstrumentationPoints:
         ("java", ".java", JAVA_SAMPLE, 3),
         ("c", ".c", C_SAMPLE, 3),
         ("cpp", ".cpp", CPP_SAMPLE, 3),
-        pytest.param("javascript", ".js", JS_SAMPLE, 2,
-                     marks=pytest.mark.xfail(reason="JavaScript instrumentation incomplete")),
+        pytest.param("javascript", ".js", JS_SAMPLE, 4),
     ])
     def test_finds_instrumentation_points(self, lang, ext, code, min_points):
         path = _write_sample(lang, code, ext)