halib 0.2.14__tar.gz → 0.2.16__tar.gz

{halib-0.2.14 → halib-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: halib
-Version: 0.2.14
+Version: 0.2.16
 Summary: Small library for common tasks
 Author: Hoang Van Ha
 Author-email: hoangvanhauit@gmail.com
@@ -41,6 +41,7 @@ Requires-Dist: tqdm
 Requires-Dist: tube_dl
 Requires-Dist: wandb
 Requires-Dist: ipynbname
+Requires-Dist: typed-argument-parser
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -53,8 +54,8 @@ Dynamic: summary
 
 # Helper package for coding and automation
 
-**Version 0.2.14**
-+ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically
+**Version 0.2.16**
++ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically, also add `measure` context manager to simplify measuring code blocks.
 
 **Version 0.2.13**
 + reorganize packages with most changes in `research` package; also rename `research` to `exp` (package for experiment management and utilities)

{halib-0.2.14 → halib-0.2.16}/README.md

@@ -1,7 +1,7 @@
 # Helper package for coding and automation
 
-**Version 0.2.14**
-+ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically
+**Version 0.2.16**
++ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically, also add `measure` context manager to simplify measuring code blocks.
 
 **Version 0.2.13**
 + reorganize packages with most changes in `research` package; also rename `research` to `exp` (package for experiment management and utilities)

{halib-0.2.14 → halib-0.2.16}/halib/exp/perf/profiler.py

@@ -12,6 +12,8 @@ from plotly.subplots import make_subplots
 import plotly.graph_objects as go
 import plotly.express as px  # for dynamic color scales
 
+from contextlib import contextmanager
+
 from ...common.common import ConsoleLog
 from ...system.path import *
 
@@ -43,6 +45,20 @@ def check_enabled(func):
 # ==========================================
 # 2. The Class
 # ==========================================
+class ContextScope:
+    """Helper to remember the current context name so you don't have to repeat it."""
+
+    def __init__(self, profiler, ctx_name):
+        self.profiler = profiler
+        self.ctx_name = ctx_name
+
+    @contextmanager
+    def step(self, step_name):
+        # Automatically passes the stored ctx_name + the new step_name
+        with self.profiler.measure(self.ctx_name, step_name):
+            yield
+
+
 class zProfiler:
     """A singleton profiler to measure execution time of contexts and steps.
 
@@ -52,13 +68,23 @@ class zProfiler:
         output_file (str): Path to save the profiling report.
         report_format (str): Output format for reports ("json" or "csv").
 
-    Example:
+    Example (using context manager):
+        prof = zProfiler()
+        with prof.measure("my_context") as ctx:
+            with ctx.step("step1"):
+                time.sleep(0.1)
+            with ctx.step("step2"):
+                time.sleep(0.2)
+
+    Example (using raw methods):
         prof = zProfiler()
         prof.ctx_start("my_context")
         prof.step_start("my_context", "step1")
         time.sleep(0.1)
         prof.step_end("my_context", "step1")
         prof.ctx_end("my_context")
+
+
     """
 
     _instance = None
@@ -127,6 +153,24 @@ class zProfiler:
             return
         self.time_dict[ctx_name]["step_dict"][step_name][-1].append(time.perf_counter())
 
+    @contextmanager
+    def measure(self, ctx_name, step_name=None):
+        if step_name is None:
+            # --- Context Mode ---
+            self.ctx_start(ctx_name)
+            try:
+                # Yield the helper object initialized with the current context name
+                yield ContextScope(self, ctx_name)
+            finally:
+                self.ctx_end(ctx_name)
+        else:
+            # --- Step Mode ---
+            self.step_start(ctx_name, step_name)
+            try:
+                yield
+            finally:
+                self.step_end(ctx_name, step_name)
+
     def _step_dict_to_detail(self, ctx_step_dict):
         """
                 'ctx_step_dict': {

{halib-0.2.14 → halib-0.2.16}/halib/filetype/videofile.py

@@ -96,6 +96,34 @@ class VideoUtils:
         return dfmk["video_meta"].copy()
 
 
+    # -----------------------------
+    # FFmpeg Horizontal Stack
+    # -----------------------------
+    @staticmethod
+    def video_hstack(video_files, output_file):
+        """Horizontally stack multiple videos using FFmpeg."""
+        tmp_file = "video_list.txt"
+        try:
+            with open(tmp_file, "w") as f:
+                for video in video_files:
+                    f.write(f"file '{video}'\n")
+
+            ffmpeg_cmd = (
+                f"ffmpeg -f concat -safe 0 -i {tmp_file} "
+                f'-filter_complex "[0:v][1:v][2:v]hstack=inputs={len(video_files)}[v]" '
+                f'-map "[v]" -c:v libx264 -preset fast -crf 22 {output_file}'
+            )
+
+            os.system(ffmpeg_cmd)
+            print(f"[INFO] Video stacked successfully: {output_file}")
+
+        except Exception as e:
+            print(f"[ERROR] Video stacking failed: {e}")
+        finally:
+            if os.path.exists(tmp_file):
+                os.remove(tmp_file)
+
+
 class VideoResolution(Enum):
     VR480p = "720x480"
     VR576p = "1280x720"
@@ -146,7 +174,6 @@ def trim_video(source, destination, start_time, end_time):
 
 progress_bar = None
 
-
 def on_progress(bytes_done, total_bytes):
     global progress_bar
     if progress_bar is None:

{halib-0.2.14 → halib-0.2.16}/halib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: halib
-Version: 0.2.14
+Version: 0.2.16
 Summary: Small library for common tasks
 Author: Hoang Van Ha
 Author-email: hoangvanhauit@gmail.com
@@ -41,6 +41,7 @@ Requires-Dist: tqdm
 Requires-Dist: tube_dl
 Requires-Dist: wandb
 Requires-Dist: ipynbname
+Requires-Dist: typed-argument-parser
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -53,8 +54,8 @@ Dynamic: summary
 
 # Helper package for coding and automation
 
-**Version 0.2.14**
-+ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically
+**Version 0.2.16**
++ update `exp.perf.profiler`: add `enabled` flag to enable/disable profiling dynamically, also add `measure` context manager to simplify measuring code blocks.
 
 **Version 0.2.13**
 + reorganize packages with most changes in `research` package; also rename `research` to `exp` (package for experiment management and utilities)

{halib-0.2.14 → halib-0.2.16}/halib.egg-info/requires.txt

@@ -29,3 +29,4 @@ tqdm
 tube_dl
 wandb
 ipynbname
+typed-argument-parser

{halib-0.2.14 → halib-0.2.16}/setup.py

@@ -8,7 +8,7 @@ with open("requirements.txt") as f:
 
 setuptools.setup(
     name="halib",
-    version="0.2.14",
+    version="0.2.16",
     author="Hoang Van Ha",
     author_email="hoangvanhauit@gmail.com",
     description="Small library for common tasks",