[Feature]: Improve performance by using a faster library for parsing json schemas #1086

Activity

1. mikicz

   added

   kind/enhancement

   on Jan 16, 2026
2. p1c2u commented on Jan 30, 2026

   

   p1c2u

   on Jan 30, 2026

   Last edited by p1c2u

   Collaborator

   More actions

   Hi @mikicz , thanks for your comment. I see in your profiling that your bottleneck is specification validation on the OpenAPI initialization. You can turn off the validation if you are sure your specification is valid. Please read the documentation how to disable spec validation.

   If your intention is it use specification validation feature but make it faster then that would require changes in openapi-spec-validator and openapi-schema-validator which are entirely based on jsonschema.
3. p1c2u commented on Feb 1, 2026

   

   p1c2u

   on Feb 1, 2026

   Last edited by p1c2u

   Collaborator

   More actions

   After little bit more investigation and profiling I found out the issue with suboptimal reference resolution in jsonschema-path library. The fix should have more impact than switching to jsonschema-rs.

   p1c2u/jsonschema-path#208
4. p1c2u commented on Feb 17, 2026

   

   p1c2u

   on Feb 17, 2026

   Collaborator

   More actions

   Betea version with performance improvements was released. Feel free to test it.

   👍React with 👍1Reacted by Vincent Privat
5. mikicz commented on Feb 17, 2026

   

   mikicz

   on Feb 17, 2026

   Author

   More actions

   Hi! Thanks for still looking at this! I have indeed found that just disabling spec validation does help quite a bit. Nonetheless I have tried to profile the current release and the pre-release with our spec file.

   With validation:

   from openapi_core import OpenAPI
   
   if __name__ == "__main__":
       OpenAPI.from_file_path("schema.yaml")

   Without validation:

   from openapi_core import OpenAPI, Config
   
   if __name__ == "__main__":
       config = Config(spec_validator_cls=None)
       OpenAPI.from_file_path("schema.yaml", config=config)

   Old dependencies:

   $ uv pip freeze | grep 'openapi\|jsonschema\|pathable'
   fastjsonschema==2.21.2
   jsonschema==4.26.0
   jsonschema-path==0.3.4
   jsonschema-specifications==2025.9.1
   openapi-core==0.22.0
   openapi-schema-validator==0.6.3
   openapi-spec-validator==0.7.2
   pathable==0.4.4
   

   New dependencies:

   $ uv pip freeze | grep 'openapi\|jsonschema\|pathable'
   fastjsonschema==2.21.2
   jsonschema==4.24.1
   jsonschema-path==0.4.0b8
   jsonschema-specifications==2025.9.1
   openapi-core==0.23.0b1
   openapi-schema-validator==0.6.3
   openapi-spec-validator==0.8.0b3
   pathable==0.5.0b6
   

   The headline is that I do not see any major time improvement - tho I can imagine my setup being less than ideal - I only ran once per variant instead of running multiple times. See pyinstrument profiling:

   old.txt
   new.txt
   new_without_validation.txt
   old_without_validation.txt

   👍React with 👍1Reacted by Artur Maciag
6. p1c2u commented on Feb 17, 2026

   

   p1c2u

   on Feb 17, 2026

   Collaborator

   More actions

   Thanks for sharing your results. The improvement should only be visible when the spec validation is enabled.

   I’ve prepared a PoC for the jsonschema-rs version. It’s definitely worth moving forward, but it requires more time.

   👍React with 👍1Reacted by Vincent Privat