What is the benefit of the Service Layer Wrapper?

It follows the Single Responsibility Principle (SRP) by keeping your extraction or processing functions 'pure.' The processing function doesn't need to know about the cache; the wrapper handles the check-then-process logic.

How does this pattern handle cache corruption?

The pattern is designed for graceful degradation. If a cache file is corrupted or contains invalid JSON, it is treated as a cache miss, and the file is re-processed and re-cached automatically.

Is this pattern safe for large files?

Yes, the pattern utilizes a chunked reading approach (64KB blocks) to compute SHA-256 hashes, preventing memory overflow by avoiding loading the entire file at once.

Why use content hashes instead of file paths for caching?

Content hashes identify files by their data rather than their location. This allows the cache to remain valid even if a file is moved or renamed, and ensures it updates instantly if the file content is modified.

Content-Hash Cache Pattern

Name: Content-Hash Cache Pattern
Author: flatrick

byflatrick

0•

개발자 도구

Implements path-independent, auto-invalidating cache systems for expensive file processing tasks using SHA-256 content hashing.

The Content-Hash Cache Pattern provides a robust architectural template for optimizing expensive file operations like PDF parsing, OCR, and image analysis within Claude Code environments. By using SHA-256 hashes of file contents as cache keys rather than fragile file paths, this skill ensures that cache hits occur even after files are moved or renamed, while guaranteeing automatic invalidation the moment content changes. It emphasizes clean code principles by separating caching logic into a service layer, keeping core processing functions pure and maintainable.

주요 기능

01Automatic cache invalidation triggered by file content changes

02SHA-256 content-based indexing for path-independent caching

03Memory-efficient chunked hashing for large file processing

04O(1) lookup performance using hash-based JSON storage

050 GitHub stars

06Service layer separation to maintain pure processing functions

사용 사례

01High-cost file processing pipelines such as PDF text extraction

02CLI tools requiring performance-boosting --cache options

03Batch processing workflows where identical files appear across runs

주요 기능

01Automatic cache invalidation triggered by file content changes

02SHA-256 content-based indexing for path-independent caching

03Memory-efficient chunked hashing for large file processing

04O(1) lookup performance using hash-based JSON storage

050 GitHub stars

06Service layer separation to maintain pure processing functions

사용 사례

01High-cost file processing pipelines such as PDF text extraction

02CLI tools requiring performance-boosting --cache options

03Batch processing workflows where identical files appear across runs