[BUG]: Expose correct python interfaces

[haochengxia]

Expose Python methods rather than unwrapped C++ bindings.

[Copilot]

Pull Request Overview

This PR refactors the Python interface to expose proper Python classes instead of C++ binding functions, replacing individual *_init functions with object-oriented cache policy classes that inherit from a common base class.

• Replaces C++ binding functions (e.g., FIFO_init, LRU_init) with proper Python classes (FIFO, LRU, etc.)
• Introduces EvictionPolicyBase as a common base class for all cache policies
• Adds new utility functions process_trace and process_trace_python_hook for trace processing

Comments suppressed due to low confidence (3)

libCacheSim-python/libcachesim/init.pyi:53

• Parameter type references PythonHookCache but the class is defined as PythonHookCachePolicy. This should be PythonHookCachePolicy to match the class definition.

    cache: PythonHookCache,

libCacheSim-python/libcachesim/init.pyi:149

• [nitpick] Parameter name ain_size_ratio is inconsistent with the original Ain_size_ratio (capitalized). Consider using Ain_size_ratio to maintain consistency with the original API.

    def __init__(self, cache_size: int, ain_size_ratio: float = 0.25, aout_size_ratio: float = 0.5) -> None: ...

libCacheSim-python/libcachesim/init.pyi:149

• [nitpick] Parameter name aout_size_ratio is inconsistent with the original Aout_size_ratio (capitalized). Consider using Aout_size_ratio to maintain consistency with the original API.

    def __init__(self, cache_size: int, ain_size_ratio: float = 0.25, aout_size_ratio: float = 0.5) -> None: ...

[1a1a11a]

LGTM