Speed up validate() with validator caching and optional schema-check …

[p1c2u]

…fast path

Large performance gain for repeated validate(...) calls on the same schema.

• oas32_simple_object: 1162.84/s -> 53903.94/s (+4535.56%)
• oas31_prefix_items: 852.47/s -> 41044.51/s (+4714.78%)
• oas32_registry_refs: 1160.15/s -> 19221.49/s (+1556.81%)
• oas30_nullable: 12597.89/s -> 175805.51/s (+1295.52%)
• oas30_discriminator: 9615.88/s -> 18475.32/s (+92.13%)

[Copilot]

Pull request overview

This PR optimizes the validate(...) shortcut for repeated validations by caching compiled validators and adds a check_schema flag to optionally skip schema validation, along with benchmark tooling and documentation to measure/track performance.

Changes:

• Add an internal LRU-style ValidatorCache for validate(...), plus clear_validate_cache() and check_schema support.
• Introduce settings plumbing (env-driven cache size) and tests covering cache behavior and schema-check skipping.
• Add benchmark runner/comparator scripts and document how to run them.

Reviewed changes

Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
openapi_schema_validator/shortcuts.py	Implements validator caching, check_schema parameter, and cache clearing API.
openapi_schema_validator/_caches.py	Adds thread-safe cache implementation and schema/kwargs keying.
openapi_schema_validator/settings.py	Adds env-driven settings (OPENAPI_SCHEMA_VALIDATOR_VALIDATE_CACHE_MAX_SIZE) with caching/reset.
tests/unit/test_shortcut.py	Adds tests for check_schema=False and cache behavior/max-size behavior.
benchmarks/run.py	Adds benchmark runner to measure compile/validate throughput and memory.
benchmarks/compare.py	Adds benchmark report comparison utility with regression detection.
benchmarks/cases.py	Defines benchmark cases and shared schemas/registries.
benchmarks/__init__.py	Initializes benchmark package.
docs/contributing.rst	Documents benchmark usage and cache-size tuning.
pyproject.toml	Adds settings dependencies (pydantic, pydantic-settings).
poetry.lock	Locks new dependencies and updates dependency grouping metadata.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[p1c2u]

@copilot open a new pull request to apply changes based on the comments in this thread

[Copilot]

@p1c2u I've opened a new pull request, #274, to work on those changes. Once the pull request is ready, I'll request review from you.