cache\_s3\_based
================

.. note::

   **TTL and automatic S3 cleanup**

   When *ttl* is set, an expired entry is **deleted from S3** at the moment
   it is first read back after expiry, no S3 Lifecycle Rule or background
   job is required to keep the bucket clean.

   Because TTLs are typically set to hours or days, expirations are
   infrequent; the extra ``DeleteObject`` call on each expiry has negligible
   overhead compared to the cost of recomputing the cached value.

.. automodule:: core_aws.decorators.cache_s3_based
   :members:
   :undoc-members:
   :show-inheritance:
   :private-members: