Metadata-Version: 2.4
Name: cogcache
Version: 0.0.0
Summary: Reserved name for the upcoming CogCache semantic LLM-answer cache library.
Project-URL: Homepage, https://github.com/AaronharveyHan/AI_Cost_Optimization
Project-URL: Repository, https://github.com/AaronharveyHan/AI_Cost_Optimization
Project-URL: Issues, https://github.com/AaronharveyHan/AI_Cost_Optimization/issues
Author: CogCache Team
License: MIT
Keywords: ai,cache,langchain,llm,redis,semantic-cache
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# cogcache (reserved)

PyPI name placeholder for the upcoming **CogCache** library — a semantic
LLM-answer cache with Redis Stack and LangChain integration.

The functional release lands in **v0.2** from
[`AI_Cost_Optimization`](https://github.com/AaronharveyHan/AI_Cost_Optimization),
where it currently develops under the working name `cognicache`.

```python
>>> import cogcache
>>> cogcache.__version__
'0.0.0'
>>> cogcache.placeholder_notice()
'cogcache 0.0.0 — name reserved. ...'
```

## Uploading this placeholder to PyPI

This subdirectory is self-contained — build and upload from here, not
from the repo root.

```bash
cd packaging/cogcache_stub

# Build the sdist + wheel
python -m pip install --upgrade build twine
python -m build

# Local verification (recommended before upload)
python -m pip install dist/cogcache-0.0.0-py3-none-any.whl --force-reinstall
python -c "import cogcache; print(cogcache.placeholder_notice())"

# Upload to PyPI (needs a PyPI API token)
twine upload dist/*

# OR upload to TestPyPI first to dry-run the whole flow
twine upload --repository testpypi dist/*
```

`twine` will prompt for credentials. Recommended: use a project-scoped
API token (`__token__` as username, `pypi-...` as password) and store it
in `~/.pypirc` or the `TWINE_PASSWORD` env var.

After upload, visit https://pypi.org/project/cogcache/ to confirm the
0.0.0 placeholder is live.
