cache-kit 0.9.0

A type-safe, fully generic, production-ready caching framework for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# =============================================================================
# PERFORMANCE BENCHMARKS - make/perf.mk
# =============================================================================
# Criterion-based performance benchmarking

.PHONY: perf perf-save perf-diff _bench _open-report

# =============================================================================
# PRIVATE HELPERS
# =============================================================================

_bench:
	@echo "→ Running InMemory benchmarks..."
	@$(CARGO) bench --bench cache_benchmark --no-fail-fast
	@echo ""
	@echo "→ Running Redis benchmarks (requires Redis on localhost:6379)..."
	@$(CARGO) bench --bench redis_benchmark --features redis --no-fail-fast || echo "⚠ Redis benchmarks skipped (Redis not available or feature disabled)"
	@echo ""
	@echo "→ Running Memcached benchmarks (requires Memcached on localhost:11211)..."
	@$(CARGO) bench --bench memcached_benchmark --features memcached --no-fail-fast || echo "⚠ Memcached benchmarks skipped (Memcached not available or feature disabled)"

_open-report:
	@command -v open >/dev/null 2>&1 && open target/criterion/report/index.html || \
		(command -v xdg-open >/dev/null 2>&1 && xdg-open target/criterion/report/index.html) || \
		echo "→ View: target/criterion/report/index.html"

# =============================================================================
# PUBLIC TARGETS
# =============================================================================

perf: _check-rust _bench _open-report  ## Run benchmarks and open HTML report
	@echo ""
	@echo "✓ Benchmarks complete"

perf-save: _check-rust  ## Save current performance as baseline
	@echo "→ Saving InMemory baseline..."
	@$(CARGO) bench --bench cache_benchmark --no-fail-fast -- --save-baseline main
	@echo ""
	@echo "→ Saving Redis baseline (requires Redis on localhost:6379)..."
	@$(CARGO) bench --bench redis_benchmark --features redis --no-fail-fast -- --save-baseline main || echo "⚠ Redis baseline skipped"
	@echo ""
	@echo "→ Saving Memcached baseline (requires Memcached on localhost:11211)..."
	@$(CARGO) bench --bench memcached_benchmark --features memcached --no-fail-fast -- --save-baseline main || echo "⚠ Memcached baseline skipped"
	@echo ""
	@echo "✓ Baselines saved"

perf-diff: _check-rust  ## Compare current performance vs baseline
	@echo "→ Comparing InMemory vs baseline 'main'..."
	@$(CARGO) bench --bench cache_benchmark --no-fail-fast -- --baseline main
	@echo ""
	@echo "→ Comparing Redis vs baseline 'main' (requires Redis on localhost:6379)..."
	@$(CARGO) bench --bench redis_benchmark --features redis --no-fail-fast -- --baseline main || echo "⚠ Redis comparison skipped"
	@echo ""
	@echo "→ Comparing Memcached vs baseline 'main' (requires Memcached on localhost:11211)..."
	@$(CARGO) bench --bench memcached_benchmark --features memcached --no-fail-fast -- --baseline main || echo "⚠ Memcached comparison skipped"
	@echo ""
	@echo "✓ Comparison complete"