afrocache 0.1.0__py3-none-any.whl

afrocache/__init__.py

@@ -0,0 +1,25 @@
+import logging
+logger = logging.getLogger("afrocache")
+logger.addHandler(logging.NullHandler())
+
+from .config import init_cache
+from .core import afrocache
+from .api import (
+    invalidate_cache,
+    reset_cache,
+    get_all_cache_keys,
+    get_cache_metadata,
+    get_cache_info,
+    key_exists
+)
+
+__all__ = [
+    "init_cache",
+    "afrocache",
+    "invalidate_cache",
+    "reset_cache",
+    "get_all_cache_keys",
+    "get_cache_metadata",
+    "get_cache_info",
+    "key_exists"
+]

afrocache/api.py

@@ -0,0 +1,72 @@
+import os
+import time
+from datetime import datetime
+from .config import _config, _cache_store, _refresh_locks, queue
+from .storage import _get_storage, _save_storage
+
+
+def invalidate_cache(target_key: str):
+    """Manually removes a key and its associated background tasks."""
+    storage = _get_storage()
+    storage.pop(target_key, None)
+    _save_storage(storage)
+    _refresh_locks.pop(target_key, None)
+    queue.tasks = [t for t in queue.tasks if t.name != f"cache:{target_key}"]
+
+
+def reset_cache():
+    """Wipes the entire cache state and clears the background task queue."""
+    if _config["STORAGE_TYPE"] == "disk" and os.path.exists(_config["CACHE_FILE"]):
+        os.remove(_config["CACHE_FILE"])
+    _cache_store.clear()
+    _refresh_locks.clear()
+    queue.tasks.clear()
+
+
+def get_all_cache_keys() -> list:
+    """Returns a list of all active cache keys."""
+    return list(_get_storage().keys())
+
+
+def get_cache_metadata(key: str) -> dict:
+    """Returns metadata for a specific key (e.g., expiry)."""
+    storage = _get_storage()
+    if key not in storage or not isinstance(storage[key], dict):
+        return None
+    expires = storage[key].get("expires")
+    return {"key": key, "expires": expires}
+
+
+def get_cache_info() -> list:
+    """Returns the processed list of keys, expiration times, and performance metrics."""
+    now = time.time()
+    data = _get_storage()
+
+    active_keys = []
+    for key, cache_entry in data.items():
+        if isinstance(cache_entry, dict) and "expires" in cache_entry:
+            expires = cache_entry["expires"]
+            if now < expires:
+                active_keys.append(
+                    {
+                        "key": key,
+                        "hits": cache_entry.get("hits", 0),
+                        "modified": datetime.fromtimestamp(
+                            cache_entry.get("modified", now)
+                        ).strftime("%Y-%m-%d %H:%M:%S"),
+                        "expires": datetime.fromtimestamp(expires).strftime(
+                            "%Y-%m-%d %H:%M:%S"
+                        ),
+                    }
+                )
+
+    return active_keys
+
+
+def key_exists(key: str) -> bool:
+    """Checks if a specific key exists in the cache and is not expired."""
+    storage = _get_storage()
+    if key not in storage or not isinstance(storage[key], dict):
+        return False
+    expires = storage[key].get("expires", 0)
+    return time.time() < expires

afrocache/config.py

@@ -0,0 +1,32 @@
+import os
+import typing
+from qmate import Queue
+
+# Configuration & State
+_config = {
+    "STORAGE_TYPE": "memory",
+    "CACHE_DIR": "data",
+    "CACHE_FILE": "afrocache_store.json",
+}
+
+# Global State
+_cache_store: typing.Dict[str, typing.Any] = {}
+_refresh_locks: typing.Dict[str, float] = {}
+queue = Queue(printTask=True)
+DEFAULT_TTL = 86400
+
+
+def init_cache(
+    storage_type: str = "memory",
+    cache_dir: str = "data",
+    filename: str = "afrocache_store.json",
+):
+    """
+    Allows full control over where and how the cache is stored.
+    """
+    _config["STORAGE_TYPE"] = storage_type
+    _config["CACHE_DIR"] = cache_dir
+    _config["CACHE_FILE"] = os.path.join(cache_dir, filename)
+
+    if storage_type == "disk":
+        os.makedirs(cache_dir, exist_ok=True)

afrocache/core.py

@@ -0,0 +1,114 @@
+import asyncio
+import inspect
+import time
+import logging
+import typing
+from functools import wraps
+from qmate import Task
+
+from .config import DEFAULT_TTL, queue, _refresh_locks
+from .storage import _get_storage, _save_storage, _write_entry
+
+logger = logging.getLogger("afrocache")
+
+
+def afrocache(
+    refresh: typing.Optional[dict] = None, bypass: bool = False, ttl: int = DEFAULT_TTL
+):
+    """
+    Decorator: Caches function output and optionally schedules background refreshes.
+    """
+
+    def decorator(func):
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            key = generate_cache_key(func, *args, **kwargs)
+            now = time.time()
+            storage = _get_storage()
+
+            if not bypass:
+                cache_entry = storage.get(key)
+                if cache_entry is not None:
+                    try:
+                        if now < cache_entry["expires"]:
+                            logger.debug(f"CACHE HIT -> {key}")
+                            cache_entry["hits"] += 1
+                            _save_storage(storage)
+                            return cache_entry["value"]
+                    except (TypeError, KeyError, IndexError):
+                        logger.warning(
+                            f"STRUCTURE MISMATCH -> Evicting legacy schema --> {key}"
+                        )
+                        storage.pop(key, None)
+                        _save_storage(storage)
+
+            # CACHE MISS
+            logger.debug(f"CACHE MISS -> {key}")
+
+            result = _run(func(*args, **kwargs))
+            _write_entry(key, result, ttl, preserve_hits=False)
+
+            if refresh:
+                task_name = f"cache:{key}"
+                if not any(t.name == task_name for t in queue.tasks):
+
+                    def loader():
+                        return func(*args, **kwargs)
+
+                    queue.schedule(
+                        Task(
+                            func=_refresh,
+                            args=(key, loader, ttl),
+                            name=task_name,
+                            **refresh,
+                        )
+                    )
+                    logger.debug(f"SCHEDULE ADDED -> {key}")
+
+            return result
+
+        return wrapper
+
+    return decorator
+
+
+def generate_cache_key(func: typing.Callable, *args, **kwargs) -> str:
+    """Generates a deterministic, human-readable cache key."""
+    args_str = ",".join(repr(a) for a in args)
+    kwargs_str = ",".join(f"{k}={repr(v)}" for k, v in sorted(kwargs.items()))
+
+    parts = [f"{func.__module__}.{func.__qualname__}"]
+    if args_str:
+        parts.append(args_str)
+    if kwargs_str:
+        parts.append(kwargs_str)
+
+    return ":".join(parts)
+
+
+def _run(result: typing.Any) -> typing.Any:
+    """Resolves sync/async results into a single execution pattern."""
+    if inspect.isawaitable(result):
+        try:
+            asyncio.get_running_loop()
+            return asyncio.create_task(result)
+        except RuntimeError:
+            return asyncio.run(result)
+    return result
+
+
+def _refresh(key: str, loader: typing.Callable, ttl: int):
+    """Background task used to re-run the function and update the cache."""
+    now = time.time()
+
+    # Debounce to prevent multiple runs from the queue loop
+    if now - _refresh_locks.get(key, 0) < 1:
+        return
+    _refresh_locks[key] = now
+
+    try:
+        result = _run(loader())
+        _write_entry(key, result, ttl, preserve_hits=True)
+        logger.debug(f"CACHE REFRESH -> {key}")
+    except Exception as ex:
+        logger.error(f"CACHE REFRESH FAIL -> {key} | {ex}")

afrocache/storage.py

@@ -0,0 +1,36 @@
+import json
+import os
+import time
+import typing
+from .config import _config, _cache_store
+
+
+def _get_storage():
+    if _config["STORAGE_TYPE"] == "memory":
+        return _cache_store
+
+    # Disk mode
+    if not os.path.exists(_config["CACHE_FILE"]):
+        return {}
+
+    with open(_config["CACHE_FILE"], "r") as f:
+        return json.load(f)
+
+
+def _save_storage(data):
+    if _config["STORAGE_TYPE"] == "disk":
+        with open(_config["CACHE_FILE"], "w") as f:
+            json.dump(data, f, indent=4)
+
+
+def _write_entry(key: str, value: typing.Any, ttl: int, preserve_hits: bool = False):
+    """Internal master function for creating or updating a cache structure."""
+    storage = _get_storage()
+    now = time.time()
+
+    hits = 0
+    if preserve_hits and key in storage and isinstance(storage[key], dict):
+        hits = storage[key].get("hits", 0)
+
+    storage[key] = {"value": value, "expires": now + ttl, "hits": hits, "modified": now}
+    _save_storage(storage)

afrocache-0.1.0.dist-info/METADATA

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: afrocache
+Version: 0.1.0
+Summary: A lightweight, simple Python caching library that manages data storage, on disk or in memory, and automated background updates.
+Author-email: DigitalKelvin <developer@digitalkelvin.com>
+Project-URL: Homepage, https://github.com/digitalkelvin/afrocache
+Project-URL: Bug Tracker, https://github.com/digitalkelvin/afrocache/issues
+Keywords: caching,python,asyncio,background-tasks,disk-cache,memory-cache,qmate,performance
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qmate>=0.0.2
+Dynamic: license-file
+
+# AfroCache
+A lightweight, simple Python caching library that manages data storage, on disk or in memory, and automated background updates.
+
+## Features
+
+- **Storage Engines**: Supports both volatile memory caching and persistent disk caching using JSON files.
+- **Background Refresh**: Uses `QMate` to execute background re-validation tasks, ensuring data is updated without blocking the main execution path.
+- **Execution Handling**: Compatible with both def (synchronous) and async def (asynchronous) functions.
+- **Cache Management**: Provides utilities to invalidate specific keys, reset the entire cache, and track background task queues.
+- **Diagnostics**: Tracks cache hits, modification timestamps, and expiration times for monitoring.
+
+
+## Installation
+
+#### Using `uv`:
+
+```bash
+uv add afrocache
+```
+
+#### Or via `pip`:
+```bash
+pip install afrocache
+```
+
+
+## Quick Start
+### Basic Memory Caching
+```py
+import time
+import asyncio
+from afrocache import init_cache, afrocache
+
+# Initialize cache in memory mode (default)
+init_cache(storage_type="memory")
+
+# Decorate a standard synchronous function
+@afrocache(ttl=60)  # Cache results for 60 seconds
+def get_slow_data(user_id: int):
+    time.sleep(2)  # Simulate a heavy database lookup
+    return {"user_id": user_id, "status": "active"}
+
+# Decorate an asynchronous function
+@afrocache(ttl=300)
+async def fetch_api_payload(endpoint: str):
+    await asyncio.sleep(1)  # Simulate a slow network call
+    return {"endpoint": endpoint, "data": "payload"}
+```
+
+## 2. Enabling Disk Persistence
+### Survive script restarts with disk storage:
+
+```py
+from afrocache import init_cache, afrocache
+
+init_cache(
+    storage_type="disk", 
+    cache_dir="./.cache_data", 
+    filename="production_store.json"
+)
+
+@afrocache(ttl=3600)
+def heavy_computation():
+    return sum(i * i for i in range(10_000_000))
+```
+
+## 3. Scheduled Background Refresh (QMate Integration)
+`afrocache` integrates with `QMate` to schedule background updates. You can pass any valid `QMate` scheduling arguments (such as `every`, `at`, or `on`) directly into the `refresh` dictionary.
+
+```python
+from afrocache import init_cache, afrocache
+
+init_cache(storage_type="memory")
+
+# The cache entry will automatically re-fetch in the background 
+# following the provided QMate scheduling parameters.
+@afrocache(ttl=60, refresh={"at": ["06:00:00"], "on": ["Tuesday", "Thursday"]})
+def get_dashboard_metrics():
+    return {"active_users": 1250, "revenue_usd": 45000}
+```
+
+## API Reference
+
+### Configuration
+- `init_cache(storage_type="file", cache_dir="./.demo_data", filename="demo_store.json")`: Initializes the global cache manager configuration. Must be called once at application startup.
+    - `storage_type`: `"memory"` or `"disk"`. Defaults to `"memory"`.
+    - `cache_dir`: The directory path where disk files are kept. Defaults to `"data"`. [*Required if `storage_type="disk"`*]
+    - `filename`: The JSON database file name for disk tracking. Defaults to `"afrocache_store.json"`.
+
+
+### Decorator
+- `@afrocache(ttl=86400, refresh={"at": ["20:00"]}, bypass=False)`:
+    - `ttl`: Time-to-live for cached results in seconds. Defaults to 86400 (1 day).
+    - `refresh`: Pass `{"at": ["06:00:00"]` to allow asynchronous stale-while-revalidate execution.
+    - `bypass`: If set to True, forces the decorator to always hit the underlying function and ignore the cache entirely.
+
+### Management
+- `key_exists(key: str) -> bool`: Checks if a specific key or function execution footprint currently resides alive inside the cache.
+- `invalidate_cache(key: str)`: Manually removes a specific key and cancels its associated background refresh tasks.
+- `reset_cache()`: Wipes all stored data, clears background queues, and deletes the cache file if in `disk` mode.
+- `get_all_cache_keys() -> list`: Returns a list of all keys currently in the cache.
+- `get_cache_metadata(key: str) -> dict`: Retrieves basic metadata (key name and expiration timestamp) for a specific entry.
+- `get_cache_info` -> list: Returns a detailed list of active keys, including:
+    - `hits`: Number of times the cache was successfully accessed.
+    - `modified`: The last time the entry was updated (formatted string).
+    - `expires`: The calculated expiration time (formatted string).
+
+
+## Logging & Debugging
+`AfroCache` uses the standard Python logging module. Enable it to monitor cache activity.
+```py
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+```
+
+
+## Development & Testing
+#### If you are contributing to `afrocache` or running tests locally, clone the repository and leverage uv for environment management:
+
+```bash
+# Clone and enter the repo
+git clone git@github.com:digitalkelvin/qmate.git
+cd afrocache
+
+# Install dependencies and sync environment
+uv sync
+
+# Run the automated test suite
+uv run pytest -v
+
+# Launch the interactive testing demo script
+uv run demo/app.py
+```
+
+## License
+This project is open-source software released under the MPL-2.0 License.

afrocache-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+afrocache/__init__.py,sha256=Zr4TT0Lx0vLj5tEL2beD6rYGaOpkZ8eLP3NIRacBVzo,482
+afrocache/api.py,sha256=RFxGl6uLvGiJhf_bo5YXgvbEXxy-x7da8qo-uggj8SU,2448
+afrocache/config.py,sha256=eYWr6ew2Pz0zEPJfrMO6YX1FTc5ovX_rpM1fVDKykI0,771
+afrocache/core.py,sha256=jeMYxMeTsfbXvimg4ZLXhbFF8dRTEGlkclwX6gPSdyI,3610
+afrocache/storage.py,sha256=Ih_T8N-Mtpph5wfpHZQ_3zCN_ME1n0HAf5ztrBSJDPw,976
+afrocache-0.1.0.dist-info/licenses/LICENSE,sha256=S4nUUYvRNatO4VSnvOciJGtXqYw9fvwaCUCYmBYMK9E,16724
+afrocache-0.1.0.dist-info/METADATA,sha256=efljHzImJZcMHFCIO1aU4QxBLTJmp6x_9s2kVrpohx0,6008
+afrocache-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+afrocache-0.1.0.dist-info/top_level.txt,sha256=dOOkEpVj7Osf7S1qQjxXLd48iZl6-gqNt02v5ukFS1M,10
+afrocache-0.1.0.dist-info/RECORD,,

afrocache-0.1.0.dist-info/WHEEL

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

afrocache-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,373 @@
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+    means each individual or legal entity that creates, contributes to
+    the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+    means the combination of the Contributions of others (if any) used
+    by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+    means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+    means Source Code Form to which the initial Contributor has attached
+    the notice in Exhibit A, the Executable Form of such Source Code
+    Form, and Modifications of such Source Code Form, in each case
+    including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+    means
+
+    (a) that the initial Contributor has attached the notice described
+        in Exhibit B to the Covered Software; or
+
+    (b) that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the
+        terms of a Secondary License.
+
+1.6. "Executable Form"
+    means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+    means a work that combines Covered Software with other material, in
+    a separate file or files, that is not Covered Software.
+
+1.8. "License"
+    means this document.
+
+1.9. "Licensable"
+    means having the right to grant, to the maximum extent possible,
+    whether at the time of the initial grant or subsequently, any and
+    all of the rights conveyed by this License.
+
+1.10. "Modifications"
+    means any of the following:
+
+    (a) any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered
+        Software; or
+
+    (b) any new file in Source Code Form that contains any Covered
+        Software.
+
+1.11. "Patent Claims" of a Contributor
+    means any patent claim(s), including without limitation, method,
+    process, and apparatus claims, in any patent Licensable by such
+    Contributor that would be infringed, but for the grant of the
+    License, by the making, using, selling, offering for sale, having
+    made, import, or transfer of either its Contributions or its
+    Contributor Version.
+
+1.12. "Secondary License"
+    means either the GNU General Public License, Version 2.0, the GNU
+    Lesser General Public License, Version 2.1, the GNU Affero General
+    Public License, Version 3.0, or any later versions of those
+    licenses.
+
+1.13. "Source Code Form"
+    means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+    means an individual or a legal entity exercising rights under this
+    License. For legal entities, "You" includes any entity that
+    controls, is controlled by, or is under common control with You. For
+    purposes of this definition, "control" means (a) the power, direct
+    or indirect, to cause the direction or management of such entity,
+    whether by contract or otherwise, or (b) ownership of more than
+    fifty percent (50%) of the outstanding shares or beneficial
+    ownership of such entity.
+
+2. License Grants and Conditions
+--------------------------------
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free,
+non-exclusive license:
+
+(a) under intellectual property rights (other than patent or trademark)
+    Licensable by such Contributor to use, reproduce, make available,
+    modify, display, perform, distribute, and otherwise exploit its
+    Contributions, either on an unmodified basis, with Modifications, or
+    as part of a Larger Work; and
+
+(b) under Patent Claims of such Contributor to make, use, sell, offer
+    for sale, have made, import, and otherwise transfer either its
+    Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 with respect to any Contribution
+become effective for each Contribution on the date the Contributor first
+distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+The licenses granted in this Section 2 are the only rights granted under
+this License. No additional rights or licenses will be implied from the
+distribution or licensing of Covered Software under this License.
+Notwithstanding Section 2.1(b) above, no patent license is granted by a
+Contributor:
+
+(a) for any code that a Contributor has removed from Covered Software;
+    or
+
+(b) for infringements caused by: (i) Your and any other third party's
+    modifications of Covered Software, or (ii) the combination of its
+    Contributions with other software (except as part of its Contributor
+    Version); or
+
+(c) under Patent Claims infringed by Covered Software in the absence of
+    its Contributions.
+
+This License does not grant any rights in the trademarks, service marks,
+or logos of any Contributor (except as may be necessary to comply with
+the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+No Contributor makes additional grants as a result of Your choice to
+distribute the Covered Software under a subsequent version of this
+License (see Section 10.2) or under the terms of a Secondary License (if
+permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+Each Contributor represents that the Contributor believes its
+Contributions are its original creation(s) or it has sufficient rights
+to grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+This License is not intended to limit any rights You have under
+applicable copyright doctrines of fair use, fair dealing, or other
+equivalents.
+
+2.7. Conditions
+
+Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
+in Section 2.1.
+
+3. Responsibilities
+-------------------
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under
+the terms of this License. You must inform recipients that the Source
+Code Form of the Covered Software is governed by the terms of this
+License, and how they can obtain a copy of this License. You may not
+attempt to alter or restrict the recipients' rights in the Source Code
+Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+(a) such Covered Software must also be made available in Source Code
+    Form, as described in Section 3.1, and You must inform recipients of
+    the Executable Form how they can obtain a copy of such Source Code
+    Form by reasonable means in a timely manner, at a charge no more
+    than the cost of distribution to the recipient; and
+
+(b) You may distribute such Executable Form under the terms of this
+    License, or sublicense it under different terms, provided that the
+    license for the Executable Form does not attempt to limit or alter
+    the recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a Larger Work under terms of Your choice,
+provided that You also comply with the requirements of this License for
+the Covered Software. If the Larger Work is a combination of Covered
+Software with a work governed by one or more Secondary Licenses, and the
+Covered Software is not Incompatible With Secondary Licenses, this
+License permits You to additionally distribute such Covered Software
+under the terms of such Secondary License(s), so that the recipient of
+the Larger Work may, at their option, further distribute the Covered
+Software under the terms of either this License or such Secondary
+License(s).
+
+3.4. Notices
+
+You may not remove or alter the substance of any license notices
+(including copyright notices, patent notices, disclaimers of warranty,
+or limitations of liability) contained within the Source Code Form of
+the Covered Software, except that You may alter any license notices to
+the extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+You may choose to offer, and to charge a fee for, warranty, support,
+indemnity or liability obligations to one or more recipients of Covered
+Software. However, You may do so only on Your own behalf, and not on
+behalf of any Contributor. You must make it absolutely clear that any
+such warranty, support, indemnity, or liability obligation is offered by
+You alone, and You hereby agree to indemnify every Contributor for any
+liability incurred by such Contributor as a result of warranty, support,
+indemnity or liability terms You offer. You may include additional
+disclaimers of warranty and limitations of liability specific to any
+jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+---------------------------------------------------
+
+If it is impossible for You to comply with any of the terms of this
+License with respect to some or all of the Covered Software due to
+statute, judicial order, or regulation then You must: (a) comply with
+the terms of this License to the maximum extent possible; and (b)
+describe the limitations and the code they affect. Such description must
+be placed in a text file included with all distributions of the Covered
+Software under this License. Except to the extent prohibited by statute
+or regulation, such description must be sufficiently detailed for a
+recipient of ordinary skill to be able to understand it.
+
+5. Termination
+--------------
+
+5.1. The rights granted under this License will terminate automatically
+if You fail to comply with any of its terms. However, if You become
+compliant, then the rights granted under this License from a particular
+Contributor are reinstated (a) provisionally, unless and until such
+Contributor explicitly and finally terminates Your grants, and (b) on an
+ongoing basis, if such Contributor fails to notify You of the
+non-compliance by some reasonable means prior to 60 days after You have
+come back into compliance. Moreover, Your grants from a particular
+Contributor are reinstated on an ongoing basis if such Contributor
+notifies You of the non-compliance by some reasonable means, this is the
+first time You have received notice of non-compliance with this License
+from such Contributor, and You become compliant prior to 30 days after
+Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+infringement claim (excluding declaratory judgment actions,
+counter-claims, and cross-claims) alleging that a Contributor Version
+directly or indirectly infringes any patent, then the rights granted to
+You by any and all Contributors for the Covered Software under Section
+2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all
+end user license agreements (excluding distributors and resellers) which
+have been validly granted by You or Your distributors under this License
+prior to termination shall survive termination.
+
+************************************************************************
+*                                                                      *
+*  6. Disclaimer of Warranty                                           *
+*  -------------------------                                           *
+*                                                                      *
+*  Covered Software is provided under this License on an "as is"       *
+*  basis, without warranty of any kind, either expressed, implied, or  *
+*  statutory, including, without limitation, warranties that the       *
+*  Covered Software is free of defects, merchantable, fit for a        *
+*  particular purpose or non-infringing. The entire risk as to the     *
+*  quality and performance of the Covered Software is with You.        *
+*  Should any Covered Software prove defective in any respect, You     *
+*  (not any Contributor) assume the cost of any necessary servicing,   *
+*  repair, or correction. This disclaimer of warranty constitutes an   *
+*  essential part of this License. No use of any Covered Software is   *
+*  authorized under this License except under this disclaimer.         *
+*                                                                      *
+************************************************************************
+
+************************************************************************
+*                                                                      *
+*  7. Limitation of Liability                                          *
+*  --------------------------                                          *
+*                                                                      *
+*  Under no circumstances and under no legal theory, whether tort      *
+*  (including negligence), contract, or otherwise, shall any           *
+*  Contributor, or anyone who distributes Covered Software as          *
+*  permitted above, be liable to You for any direct, indirect,         *
+*  special, incidental, or consequential damages of any character      *
+*  including, without limitation, damages for lost profits, loss of    *
+*  goodwill, work stoppage, computer failure or malfunction, or any    *
+*  and all other commercial damages or losses, even if such party      *
+*  shall have been informed of the possibility of such damages. This   *
+*  limitation of liability shall not apply to liability for death or   *
+*  personal injury resulting from such party's negligence to the       *
+*  extent applicable law prohibits such limitation. Some               *
+*  jurisdictions do not allow the exclusion or limitation of           *
+*  incidental or consequential damages, so this exclusion and          *
+*  limitation may not apply to You.                                    *
+*                                                                      *
+************************************************************************
+
+8. Litigation
+-------------
+
+Any litigation relating to this License may be brought only in the
+courts of a jurisdiction where the defendant maintains its principal
+place of business and such litigation shall be governed by laws of that
+jurisdiction, without reference to its conflict-of-law provisions.
+Nothing in this Section shall prevent a party's ability to bring
+cross-claims or counter-claims.
+
+9. Miscellaneous
+----------------
+
+This License represents the complete agreement concerning the subject
+matter hereof. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent
+necessary to make it enforceable. Any law or regulation which provides
+that the language of a contract shall be construed against the drafter
+shall not be used to construe this License against a Contributor.
+
+10. Versions of the License
+---------------------------
+
+10.1. New Versions
+
+Mozilla Foundation is the license steward. Except as provided in Section
+10.3, no one other than the license steward has the right to modify or
+publish new versions of this License. Each version will be given a
+distinguishing version number.
+
+10.2. Effect of New Versions
+
+You may distribute the Covered Software under the terms of the version
+of the License under which You originally received the Covered Software,
+or under the terms of any subsequent version published by the license
+steward.
+
+10.3. Modified Versions
+
+If you create software not governed by this License, and you want to
+create a new license for such software, you may create and use a
+modified version of this License if you rename the license and remove
+any references to the name of the license steward (except to note that
+such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+Licenses
+
+If You choose to distribute Source Code Form that is Incompatible With
+Secondary Licenses under the terms of this version of the License, the
+notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+  This Source Code Form is subject to the terms of the Mozilla Public
+  License, v. 2.0. If a copy of the MPL was not distributed with this
+  file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular
+file, then You may include the notice in a location (such as a LICENSE
+file in a relevant directory) where a recipient would be likely to look
+for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+---------------------------------------------------------
+
+  This Source Code Form is "Incompatible With Secondary Licenses", as
+  defined by the Mozilla Public License, v. 2.0.

afrocache-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+afrocache