chore: Remove examples from CI and tooling paths

Author: SirStig

.github/workflows/publish.yml

@@ -89,11 +89,11 @@ jobs:
 
       - name: Check formatting
         run: |
-          black --check src tests examples
+          black --check src tests
 
       - name: Check import sorting
         run: |
-          isort --check-only --diff src tests examples
+          isort --check-only --diff src tests
 
       - name: Type check
         run: |

.github/workflows/test.yml

@@ -68,11 +68,11 @@ jobs:
 
     - name: Check formatting with black
       run: |
-        black --check src tests examples
+        black --check src tests
 
     - name: Check import sorting with isort
       run: |
-        isort --check-only --diff src tests examples
+        isort --check-only --diff src tests
 
     - name: Type check with mypy
       run: |
@@ -112,9 +112,28 @@ jobs:
         python -m pip install --upgrade pip
         pip install -e ".[dev,sqlalchemy,fuzzy]"
 
-    - name: Run integration tests
+    - name: Redis integration smoke
       run: |
-        python examples/basic_usage.py
+        python -c "
+        import asyncio
+        import os
+        from yokedcache import YokedCache
+        from yokedcache.config import CacheConfig
+
+        async def main():
+            url = os.environ.get('YOKEDCACHE_REDIS_URL', 'redis://127.0.0.1:6379/0')
+            c = YokedCache(CacheConfig(redis_url=url))
+            await c.connect()
+            await c.set('ci_smoke', {'ok': True}, ttl=60)
+            v = await c.get('ci_smoke')
+            assert v == {'ok': True}, v
+            await c.delete('ci_smoke')
+            await c.disconnect()
+
+        asyncio.run(main())
+        "
+      env:
+        YOKEDCACHE_REDIS_URL: redis://127.0.0.1:6379/0
     - name: Test CLI
       run: |
         python -m yokedcache ping

.pre-commit-config.yaml

@@ -18,7 +18,7 @@ repos:
     hooks:
       - id: mypy
         args: [--ignore-missing-imports, --no-strict-optional, --disable-error-code=unused-ignore]
-        exclude: ^(scripts/|examples/)
+        exclude: ^scripts/
         additional_dependencies:
           - types-PyYAML
           - types-redis

CONTRIBUTING.md

@@ -58,11 +58,11 @@ Run all checks before committing:
 
 ```bash
 # Format code
-black src tests examples
-isort src tests examples
+black src tests
+isort src tests
 
 # Check linting
-flake8 src tests examples
+flake8 src tests
 
 # Type checking
 mypy src --ignore-missing-imports
@@ -97,7 +97,6 @@ pytest tests/test_cache.py::TestYokedCache::test_basic_get_set
 - Update docstrings for all public functions and classes
 - Follow Google-style docstring format
 - Update README.md for new features
-- Add examples to the `examples/` directory
 - Update guides under `site-src/pages/` when you change user-facing behavior
 - Run `pip install -e ".[docs]"` then `python scripts/build_docs_site.py` to verify the static site builds
 - Preview: `cd site && python -m http.server 8000` (after copying `CHANGELOG.md` to `site/changelog.md` for the changelog page)
@@ -138,8 +137,8 @@ For new features:
 5. **Run the test suite** and ensure all tests pass:
    ```bash
    pytest
-   black src tests examples
-   flake8 src tests examples
+   black src tests
+   flake8 src tests
    mypy src --ignore-missing-imports
    python scripts/build_docs_site.py
    ```
@@ -195,7 +194,6 @@ yokedcache/
 │   ├── exceptions.py        # Custom exceptions
 │   └── cli.py               # Command-line interface
 ├── tests/                   # Test suite
-├── examples/                # Usage examples
 ├── site-src/                # Static site sources (Markdown, templates, assets)
 └── pyproject.toml           # Project configuration
 ```
@@ -214,7 +212,7 @@ yokedcache/
 
 ## Getting Help
 
-- **Documentation:** Check the README and examples
+- **Documentation:** Check the README and the docs site
 - **Issues:** Search existing issues or create a new one
 - **Discussions:** Use GitHub Discussions for questions
 - **Chat:** Join our community chat (link TBD)

MANIFEST.in

@@ -5,9 +5,6 @@ include CHANGELOG.md
 include CONTRIBUTING.md
 include requirements-*.txt
 
-# Include configuration examples
-recursive-include examples *.py *.yaml *.yml *.md
-
 # Include tests (optional, for source distributions)
 recursive-include tests *.py
 

Makefile

@@ -54,12 +54,12 @@ test-cov:
 
 # Code quality
 lint:
-	flake8 src tests examples
+	flake8 src tests
 	mypy src
 
 format:
-	black src tests examples
-	isort src tests examples
+	black src tests
+	isort src tests
 
 type-check:
 	mypy src

codecov.yml

@@ -39,7 +39,6 @@ comment:
 
 ignore:
   - "tests/"
-  - "examples/"
   - "site-src/"
   - "site/"
   - "htmlcov/"

site-src/pages/getting-started.md

@@ -530,7 +530,7 @@ redis-cli --latency
 ## Getting Help
 
 - **Documentation**: Explore the full documentation for detailed guides
-- **Examples**: Check the `examples/` directory for complete working examples
+- **Examples**: See the [FastAPI tutorial](tutorials/fastapi.html) and [usage patterns](usage-patterns.html)
 - **CLI Help**: Run `yokedcache --help` for command-line assistance
 - **Issues**: Report bugs or request features on GitHub