Kekik 1.6.1__py3-none-any.whl → 1.6.2__py3-none-any.whl

Kekik/cache.py

@@ -0,0 +1,164 @@
+# ! https://github.com/Fatal1ty/aiocached
+
+import asyncio
+from functools import wraps
+from time      import time
+
+UNLIMITED = None
+
+class Cache:
+    """
+    Basit in-memory cache yapısı.
+    TTL (time-to-live) süresi dolan veriler otomatik olarak temizlenir.
+    """
+    def __init__(self, ttl=UNLIMITED):
+        self._data  = {}
+        self._ttl   = ttl
+        self._times = {}
+
+    def _is_expired(self, key):
+        """Belirtilen key'in süresi dolduysa True döner."""
+        if self._ttl is UNLIMITED:
+            return False
+
+        timestamp = self._times.get(key)
+
+        return timestamp is not None and (time() - timestamp > self._ttl)
+
+    def remove_if_expired(self, key):
+        """
+        Eğer key'in cache süresi dolmuşsa, ilgili entry'yi temizler.
+        """
+        if self._is_expired(key):
+            self._data.pop(key, None)
+            self._times.pop(key, None)
+
+    def __getitem__(self, key):
+        self.remove_if_expired(key)
+        return self._data[key]
+
+    def __setitem__(self, key, value):
+        self._data[key] = value
+        if self._ttl is not UNLIMITED:
+            self._times[key] = time()
+
+
+class AsyncCache(Cache):
+    """
+    Asenkron işlemleri destekleyen cache yapısı.
+    Aynı key için gelen eşzamanlı çağrılar, futures kullanılarak tek sonuç üzerinden paylaşılır.
+    """
+    def __init__(self, ttl=UNLIMITED):
+        super().__init__(ttl)
+        self.futures = {}
+
+    async def get(self, key):
+        """
+        Belirtilen key için cache'de saklanan değeri asenkron olarak döndürür.
+        Eğer key bulunamazsa, ilgili future üzerinden beklemeyi sağlar.
+        """
+        self.remove_if_expired(key)
+
+        try:
+            return self._data[key]
+        except KeyError as e:
+            future = self.futures.get(key)
+            if future:
+                await future
+                return future.result()
+
+            raise e
+
+    def remove_if_expired(self, key):
+        """
+        Belirtilen key'in süresi dolduysa, cache ve futures içerisinden temizler.
+        """
+        if self._ttl is not UNLIMITED and self._is_expired(key):
+            self._data.pop(key, None)
+            self._times.pop(key, None)
+            self.futures.pop(key, None)
+
+
+def _sync_maybe_cache(func, key, result, unless):
+    """Senkron sonuç için cache kaydını oluşturur (unless koşuluna bakarak)."""
+    if unless is None or not unless(result):
+        func.__cache[key] = result
+
+
+async def _async_compute_and_cache(func, key, unless, *args, **kwargs):
+    """
+    Asenkron fonksiyon sonucu hesaplandıktan sonra, sonucu cache’e ekler.
+    Eğer `unless` koşulu sağlanıyorsa cache kaydı atlanır.
+    """
+    cache              = func.__cache
+    future             = asyncio.Future()
+    cache.futures[key] = future
+
+    try:
+        result = await func(*args, **kwargs)
+    except Exception as exc:
+        cache.futures.pop(key, None)
+        future.cancel()
+        raise exc
+
+    future.set_result(result)
+
+    if unless is None or not unless(result):
+        cache[key] = result
+    else:
+        cache.futures.pop(key, None)
+
+    return result
+
+def make_cache_key(args, kwargs):
+    """Fonksiyon argümanlarından cache için kullanılacak key’i oluşturur."""
+    return (args, tuple(sorted(kwargs.items())))
+
+
+def kekik_cache(ttl=UNLIMITED, unless=None):
+    """
+    Bir fonksiyon veya coroutine'in sonucunu cache'ler.
+    
+    :param ttl: Cache’in geçerlilik süresi (saniye). UNLIMITED ise süresizdir.
+    :param unless: Fonksiyonun sonucunu argüman olarak alan bir callable. 
+                   Eğer True dönerse, sonuç cache'e alınmaz.
+    
+    Örnek kullanım:
+    
+        @kekik_cache(ttl=15, unless=lambda res: res is None)
+        async def my_func(param):
+            ...
+    """
+    # Parametresiz kullanıldığında
+    if callable(ttl):
+        return kekik_cache(UNLIMITED, unless=unless)(ttl)
+
+    def decorator(func):
+        func.__cache = AsyncCache(ttl)
+
+        if asyncio.iscoroutinefunction(func):
+            @wraps(func)
+            async def async_wrapper(*args, **kwargs):
+                key = make_cache_key(args, kwargs)
+
+                try:
+                    return await func.__cache.get(key)
+                except KeyError:
+                    return await _async_compute_and_cache(func, key, unless, *args, **kwargs)
+
+            return async_wrapper
+        else:
+            @wraps(func)
+            def sync_wrapper(*args, **kwargs):
+                key = make_cache_key(args, kwargs)
+
+                try:
+                    return func.__cache[key]
+                except KeyError:
+                    result = func(*args, **kwargs)
+                    _sync_maybe_cache(func, key, result, unless)
+                    return result
+
+            return sync_wrapper
+
+    return decorator

{Kekik-1.6.1.dist-info → Kekik-1.6.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: Kekik
-Version: 1.6.1
+Version: 1.6.2
 Summary: İşlerimizi kolaylaştıracak fonksiyonların el altında durduğu kütüphane..
 Home-page: https://github.com/keyiflerolsun/Kekik
 Author: keyiflerolsun
@@ -26,6 +26,17 @@ Requires-Dist: simplejson
 Requires-Dist: rich
 Requires-Dist: tabulate
 Requires-Dist: pycryptodome
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # <img src="https://www.akashtrehan.com/assets/images/emoji/terminal.png" height="42" align="center"> Kekik
 

{Kekik-1.6.1.dist-info → Kekik-1.6.2.dist-info}/RECORD

@@ -2,6 +2,7 @@ Kekik/BIST.py,sha256=gFvEFdLGgsxUq33AkqOr5pVGsSm9jR0v6DVwoSzhX7w,1375
 Kekik/Domain2IP.py,sha256=dMDatPElTMfLORzC_QN9znex8Se1eid3EPsxAe5S1aQ,4851
 Kekik/Nesne.py,sha256=33pp49cZkRCoa0aUFfzVMpx5FSJchSdiKhm97Nkol1Q,7020
 Kekik/__init__.py,sha256=Iy-O4c_DuY2ttQJv6j7xoVk3IS9EcC0Aqx3vhFvCgd8,1057
+Kekik/cache.py,sha256=n15Ltoh068iFPK3ANDLz11eisOQXHLwUQA2eB3hjiiY,4861
 Kekik/cli.py,sha256=I--MV8-okBSUYAaV4fRsMeB2n57OJITrgbEnK1OdTPY,3648
 Kekik/csv2dict.py,sha256=HO0AgREXE0yM7cL4OwqpkCGm2pz31RTb0mhnTg6gdwo,423
 Kekik/dict2csv.py,sha256=AcGvEg9i5MXtwMwg7WiDxOj8h9LldNjjcRiWFwA9XJU,560
@@ -33,9 +34,9 @@ Kekik/kisi_ver/__init__.py,sha256=gH613YZC3ziE7f67dViefRSuwDwsHyVvXHpM5CzZ2q4,13
 Kekik/kisi_ver/biyografiler.py,sha256=5Xv1ixaDGHGtl5Nf92jo9dPgF3jDXOGEPmWgoEsn9j8,189486
 Kekik/kisi_ver/isimler.py,sha256=zHVimWL_4TvoLE3qzWQslDBc8-IJZSB02s0vRwsVM1g,88066
 Kekik/kisi_ver/soyisimler.py,sha256=YQJYp2SjENgwOaCa9mmShxPYeeUll2cq8Vox-d8_kB8,78485
-Kekik-1.6.1.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-Kekik-1.6.1.dist-info/METADATA,sha256=rv39RXF7ENLk-GXhDt-SeVwhFSXaFP4EpKzW1HzwUmA,43727
-Kekik-1.6.1.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-Kekik-1.6.1.dist-info/entry_points.txt,sha256=yjBifxtRlqfg8lPkH4Bu-urSa5ecptCHsuth-DcyWcg,59
-Kekik-1.6.1.dist-info/top_level.txt,sha256=NotddscfgxawvuRyAa7xkgnMhyteFDcBxb5aU5GY3BM,6
-Kekik-1.6.1.dist-info/RECORD,,
+Kekik-1.6.2.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+Kekik-1.6.2.dist-info/METADATA,sha256=6ZwkPdUXWuo-lBZTi2r0EyGfALiayeDYAeaJMVEu8bk,43959
+Kekik-1.6.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+Kekik-1.6.2.dist-info/entry_points.txt,sha256=yjBifxtRlqfg8lPkH4Bu-urSa5ecptCHsuth-DcyWcg,59
+Kekik-1.6.2.dist-info/top_level.txt,sha256=NotddscfgxawvuRyAa7xkgnMhyteFDcBxb5aU5GY3BM,6
+Kekik-1.6.2.dist-info/RECORD,,

{Kekik-1.6.1.dist-info → Kekik-1.6.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any