codegreen 0.3.7__tar.gz → 0.3.9__tar.gz

{codegreen-0.3.7/codegreen.egg-info → codegreen-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.3.7
+Version: 0.3.9
 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>
@@ -461,8 +461,7 @@ cd codegreen
 # Linux: RAPL sensor access (one-time, requires sudo):
 sudo ./install.sh   # or: sudo codegreen init-sensors
 
-# macOS: energy measurement requires sudo (IOReport access):
-sudo codegreen run -- python script.py
+# macOS: no setup needed, energy measurement works out of the box
 ```
 
 ### Platform support
@@ -482,7 +481,7 @@ sudo codegreen run -- python script.py
 
 - Python 3.9+
 - Linux: kernel 5.0+, Intel/AMD CPU with RAPL support
-- macOS: Apple Silicon (M1-M5) or Intel, sudo for energy measurement
+- macOS: Apple Silicon (M1-M5) or Intel, no setup needed
 - Windows 11: Intel/AMD CPU (EMI via inbox intelpep.sys driver, zero install)
 - Source builds: CMake 3.16+, C++17 compiler
 
@@ -585,13 +584,11 @@ cd codegreen && git pull && ./install.sh --upgrade   # source
 ## Citation
 
 ```bibtex
-@software{Rajput_CodeGreen_2026,
-  author = {Rajput, Saurabhsingh},
-  doi = {10.5281/zenodo.18371772},
-  title = {{CodeGreen: Per-Function Energy Measurement for Multi-Language Software}},
-  url = {https://smart-dal.github.io/codegreen/},
-  version = {v0.2.0},
-  year = {2026}
+@article{rajput2026codegreen,
+  title={CodeGreen: Towards Improving Precision and Portability in Software Energy Measurement},
+  author={Rajput, Saurabhsingh and Sharma, Tushar},
+  journal={arXiv preprint arXiv:2603.17924},
+  year={2026}
 }
 ```
 

{codegreen-0.3.7 → codegreen-0.3.9}/README.md

@@ -29,8 +29,7 @@ cd codegreen
 # Linux: RAPL sensor access (one-time, requires sudo):
 sudo ./install.sh   # or: sudo codegreen init-sensors
 
-# macOS: energy measurement requires sudo (IOReport access):
-sudo codegreen run -- python script.py
+# macOS: no setup needed, energy measurement works out of the box
 ```
 
 ### Platform support
@@ -50,7 +49,7 @@ sudo codegreen run -- python script.py
 
 - Python 3.9+
 - Linux: kernel 5.0+, Intel/AMD CPU with RAPL support
-- macOS: Apple Silicon (M1-M5) or Intel, sudo for energy measurement
+- macOS: Apple Silicon (M1-M5) or Intel, no setup needed
 - Windows 11: Intel/AMD CPU (EMI via inbox intelpep.sys driver, zero install)
 - Source builds: CMake 3.16+, C++17 compiler
 
@@ -153,13 +152,11 @@ cd codegreen && git pull && ./install.sh --upgrade   # source
 ## Citation
 
 ```bibtex
-@software{Rajput_CodeGreen_2026,
-  author = {Rajput, Saurabhsingh},
-  doi = {10.5281/zenodo.18371772},
-  title = {{CodeGreen: Per-Function Energy Measurement for Multi-Language Software}},
-  url = {https://smart-dal.github.io/codegreen/},
-  version = {v0.2.0},
-  year = {2026}
+@article{rajput2026codegreen,
+  title={CodeGreen: Towards Improving Precision and Portability in Software Energy Measurement},
+  author={Rajput, Saurabhsingh and Sharma, Tushar},
+  journal={arXiv preprint arXiv:2603.17924},
+  year={2026}
 }
 ```
 

{codegreen-0.3.7 → codegreen-0.3.9}/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.7"
+__version__ = "0.3.9"
 __author__ = "Saurabhsingh Rajput"
 __email__ = "saurabh@dal.ca"
 __description__ = "Energy-aware software development tool"

{codegreen-0.3.7 → codegreen-0.3.9}/codegreen/cli/cli.py

@@ -2290,6 +2290,7 @@ def run_command(
         subprocess.run(command, capture_output=True, timeout=300)
 
     energies, times = [], []
+    domain_runs = []  # per-domain breakdown per run
     for i in range(repeat):
         if not json_output:
             console.print(f"[dim]Run {i+1}/{repeat}[/dim]")
@@ -2297,11 +2298,15 @@ def run_command(
         times.append(elapsed)
         if energy_j is not None and energy_j > 0:
             energies.append(energy_j)
+            if isinstance(backend, _NEMBBackend):
+                domains = backend.get_last_domain_breakdown()
+                if domains:
+                    domain_runs.append(domains)
 
     if not energies:
         msg = f"No energy data from {backend.name}"
         if isinstance(backend, _TimeOnlyBackend):
-            msg += " (need perf on Linux or sudo powermetrics on macOS)"
+            msg += " (need perf on Linux, or NEMB library not found)"
         if json_output:
             t_mean = sum(times) / len(times) if times else 0
             print(json.dumps({"success": False, "error": msg,
@@ -2347,6 +2352,26 @@ def run_command(
         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}")
+
+        # Per-domain energy breakdown (averaged across runs, same as total)
+        if domain_runs:
+            all_domains = set()
+            for dr in domain_runs:
+                all_domains.update(dr.keys())
+            avg_domains = {}
+            for d in all_domains:
+                vals = [dr.get(d, 0) for dr in domain_runs if dr.get(d, 0) > 0]
+                if vals:
+                    avg_domains[d] = sum(vals) / len(vals)
+            if avg_domains:
+                console.print(f"\n[bold]Domain Breakdown (avg of {len(domain_runs)} runs):[/bold]")
+                total_reported = sum(avg_domains.values())
+                for domain, joules in sorted(avg_domains.items(), key=lambda x: -x[1]):
+                    pct = (joules / total_reported * 100) if total_reported > 0 else 0
+                    bar_len = int(pct / 5)
+                    bar = "[green]" + "=" * bar_len + "[/green]" + " " * (20 - bar_len)
+                    console.print(f"  {domain:<25} {joules:>10.4f} J  {bar} {pct:5.1f}%")
+
         if cv > 20:
             console.print(f"[yellow]  Tip: high variance -- try --repeat 30 or reduce background load[/yellow]")
         if budget is not None:
@@ -2427,8 +2452,22 @@ class _NEMBBackend(_EnergyBackend):
         energy = ctypes.c_double(0)
         power = ctypes.c_double(0)
         ok = lib.nemb_stop_session(sid, ctypes.byref(energy), ctypes.byref(power))
+        # Fetch per-domain breakdown (post-hoc, no measurement overhead)
+        self._last_domains = {}
+        try:
+            buf = ctypes.create_string_buffer(4096)
+            lib.nemb_get_domain_energy_json.restype = ctypes.c_int
+            lib.nemb_get_domain_energy_json.argtypes = [ctypes.c_char_p, ctypes.c_int]
+            n = lib.nemb_get_domain_energy_json(buf, 4096)
+            if n > 0:
+                self._last_domains = json.loads(buf.value.decode())
+        except Exception:
+            pass
         return (energy.value if ok and energy.value > 0 else None, elapsed)
 
+    def get_last_domain_breakdown(self) -> dict:
+        return getattr(self, '_last_domains', {})
+
     def wrap_command(self, cmd_str: str, energy_file: str, checkpoint_file: str) -> str:
         # NEMB measures in-process; for project mode, just run the command and
         # let the coordinator's background thread capture energy during execution

{codegreen-0.3.7 → codegreen-0.3.9/codegreen.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.3.7
+Version: 0.3.9
 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>
@@ -461,8 +461,7 @@ cd codegreen
 # Linux: RAPL sensor access (one-time, requires sudo):
 sudo ./install.sh   # or: sudo codegreen init-sensors
 
-# macOS: energy measurement requires sudo (IOReport access):
-sudo codegreen run -- python script.py
+# macOS: no setup needed, energy measurement works out of the box
 ```
 
 ### Platform support
@@ -482,7 +481,7 @@ sudo codegreen run -- python script.py
 
 - Python 3.9+
 - Linux: kernel 5.0+, Intel/AMD CPU with RAPL support
-- macOS: Apple Silicon (M1-M5) or Intel, sudo for energy measurement
+- macOS: Apple Silicon (M1-M5) or Intel, no setup needed
 - Windows 11: Intel/AMD CPU (EMI via inbox intelpep.sys driver, zero install)
 - Source builds: CMake 3.16+, C++17 compiler
 
@@ -585,13 +584,11 @@ cd codegreen && git pull && ./install.sh --upgrade   # source
 ## Citation
 
 ```bibtex
-@software{Rajput_CodeGreen_2026,
-  author = {Rajput, Saurabhsingh},
-  doi = {10.5281/zenodo.18371772},
-  title = {{CodeGreen: Per-Function Energy Measurement for Multi-Language Software}},
-  url = {https://smart-dal.github.io/codegreen/},
-  version = {v0.2.0},
-  year = {2026}
+@article{rajput2026codegreen,
+  title={CodeGreen: Towards Improving Precision and Portability in Software Energy Measurement},
+  author={Rajput, Saurabhsingh and Sharma, Tushar},
+  journal={arXiv preprint arXiv:2603.17924},
+  year={2026}
 }
 ```
 

{codegreen-0.3.7 → codegreen-0.3.9}/pyproject.toml

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