[CLEANUP]: Detach python binding code to individual repo

Author: haochengxia

.github/workflows/pypi-release.yml

@@ -255,9 +255,6 @@ else()
     message(STATUS "Building without test")
 endif()
 
-# Export variables for scikit-build -> build/export_vars.cmake
-add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/libCacheSim-python/export)
-
 # libCacheSim unified library compilation and installation
 # Create a single library that combines all modular libraries
 add_library(${PROJECT_NAME} STATIC

.github/workflows/python.yml

@@ -11,7 +11,7 @@ A high-performance library for building and running cache simulations
 ---
 
 [![build](https://github.com/1a1a11a/libCacheSim/actions/workflows/build.yml/badge.svg)](https://github.com/1a1a11a/libCacheSim/actions/workflows/build.yml)
-[![Python Release](https://github.com/1a1a11a/libCacheSim/actions/workflows/pypi-release.yml/badge.svg)](https://github.com/1a1a11a/libCacheSim/actions/workflows/pypi-release.yml)
+[![Python Release](https://github.com/cacheMon/libCacheSim-python/actions/workflows/pypi-release.yml/badge.svg)](https://github.com/1a1a11a/libCacheSim/actions/workflows/pypi-release.yml)
 [![NPM Release](https://github.com/1a1a11a/libCacheSim/actions/workflows/npm-release.yml/badge.svg)](https://github.com/1a1a11a/libCacheSim/actions/workflows/npm-release.yml)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/1a1a11a/libCacheSim/badge)](https://scorecard.dev/viewer/?uri=github.com/1a1a11a/libCacheSim)
 
@@ -291,12 +291,14 @@ If you are not extremely sensitive to the performance, our python binding can of
 pip install libcachesim
 ```
 
+
+
 ### Simulation with python
 
 ```python
 import libcachesim as lcs
 
-reader = lcs.create_zipf_requests(num_objects=1000, num_requests=10000) # synthetic trace
+reader = lcs.SyntheticReader(num_objects=1000, num_of_req=10000) # synthetic trace
 # reader = lcs.open_trace("./data/cloudPhysicsIO.oracleGeneral.bin") # real trace
 cache = lcs.FIFO(cache_size=1024*1024)
 obj_miss_ratio, byte_miss_ratio = cache.process_trace(reader)
@@ -310,42 +312,30 @@ With python package, you can extend new algorithm to test your own eviction desi
 <summary> See an example below </summary>
 
 ```python
-import libcachesim as lcs
-from collections import deque
-from contextlib import suppress
-
-cache = lcs.PythonHookCachePolicy(cache_size=1024, cache_name="CustomFIFO")
-
-def init_hook(cache_size):
-    return deque()  # Use deque for FIFO order
-
-def hit_hook(fifo_queue, obj_id, obj_size):
-    pass  # FIFO doesn't reorder on hit
-
-def miss_hook(fifo_queue, obj_id, obj_size):
-    fifo_queue.append(obj_id)  # Add to end of queue
-
-def eviction_hook(fifo_queue, obj_id, obj_size):
-    return fifo_queue[0]  # Return first item (oldest)
-
-def remove_hook(fifo_queue, obj_id):
-    with suppress(ValueError):
-        fifo_queue.remove(obj_id)
-
-# Set the hooks and test
-cache.set_hooks(init_hook, hit_hook, miss_hook, eviction_hook, remove_hook)
-
-reader = lcs.open_trace(
-    trace_path="./data/cloudPhysicsIO.oracleGeneral.bin",
-    params=lcs.ReaderInitParam(ignore_obj_size=True)
+from collections import OrderedDict
+from libcachesim import PluginCache, LRU
+
+plugin_lru_cache = PluginCache(
+    cache_size=128,
+    cache_name="LRU",
+    cache_init_hook=lambda _: OrderedDict(),
+    cache_hit_hook=lambda data, req: data.move_to_end(req.obj_id, last=True) if req.obj_id in data else None,
+    cache_miss_hook=lambda data, req: data.__setitem__(req.obj_id, req.obj_size),
+    cache_eviction_hook=lambda data, _: data.popitem(last=False)[0],
+    cache_remove_hook=lambda data, obj_id: data.pop(obj_id, None),
+    cache_free_hook=lambda data: data.clear(),
 )
-obj_miss_ratio, byte_miss_ratio = cache.process_trace(reader)
-print(f"Obj miss ratio: {obj_miss_ratio:.4f}, byte miss ratio: {byte_miss_ratio:.4f}")
+
+reader = lcs.SyntheticReader(num_objects=1000, num_of_req=10000, obj_size=1)
+req_miss_ratio, byte_miss_ratio = plugin_lru_cache.process_trace(reader)
+ref_req_miss_ratio, ref_byte_miss_ratio = LRU(128).process_trace(reader)
+print(f"plugin req miss ratio {req_miss_ratio}, ref req miss ratio {ref_req_miss_ratio}")
+print(f"plugin byte miss ratio {byte_miss_ratio}, ref byte miss ratio {ref_byte_miss_ratio}")
 ```
 
 </details>
 
-See more information in [README.md](./libCacheSim-python/README.md) of the Python binding.
+See more information in [README.md](https://github.com/cacheMon/libCacheSim-python) of the Python binding.
 
 ---
 ## Open source cache traces