Allow skipping apispec validation check on app startup

docs/contrib/apispec.md

@@ -70,6 +70,9 @@ inner registry by class name. If any 2 classes have same name, APIspec struggles
 schema class for introspection and gives up. This results in invalid OpenAPI, where schema is mentioned,
 but its definition is missing.
 
+**Note**: Validation is performed on each `app` startup, which includes uvicorn worker restarts.
+To disable validation in production, set `settings.APISPEC_PERFORM_CHECKS_ON_STARTUP` to `False`.
+
 ### Camel case support
 
 `contrib.camel_case` provides helper methods and classes to convert `snake_case` to `camelCase` and vice versa.

starlette_web/common/conf/global_settings.py

@@ -58,6 +58,10 @@
 
 EMAIL_SENDER = None
 
+# Contrib.apispec
+
+APISPEC_PERFORM_CHECKS_ON_STARTUP = True
+
 # Contrib.auth
 
 AUTH_PASSWORD_HASHERS = [

starlette_web/contrib/apispec/apps.py

@@ -12,6 +12,9 @@ class AppConfig(BaseAppConfig):
     app_name = "apispec"
 
     def initialize(self):
+        if not settings.APISPEC_PERFORM_CHECKS_ON_STARTUP:
+            return
+
         try:
             __import__("openapi_spec_validator")
         except (SystemError, ImportError):
@@ -24,6 +27,9 @@ def initialize(self):
             )
 
     def perform_checks(self):
+        if not settings.APISPEC_PERFORM_CHECKS_ON_STARTUP:
+            return
+
         from openapi_spec_validator import validate
         from openapi_spec_validator.validation.exceptions import (
             OpenAPIValidationError,