Improve CS rules and give doc snippets namespaces

DerManoMann · DerManoMann · commit a172d97841cd · 2025-11-24T15:55:01.000+13:00
diff --git a/.php-cs-fixer.dist.php b/.php-cs-fixer.dist.php
@@ -64,7 +64,7 @@
         'trim_array_spaces' => true,
         'single_space_around_construct' => true,
         'single_line_comment_spacing' => true,
-        'fully_qualified_strict_types' => true,
+        'fully_qualified_strict_types' => ['import_symbols' => true, 'leading_backslash_in_global_namespace' => true],
         'global_namespace_import' => ['import_classes' => false, 'import_constants' => null, 'import_functions' => null],
 
         'nullable_type_declaration_for_default_null_value' => true,
@@ -89,5 +89,7 @@
         'phpdoc_no_empty_return' => true,
         'phpdoc_no_alias_tag' => true,
         'phpdoc_param_order' => true,
+
+        // 'php_unit_attributes' => true,
     ])
     ->setFinder($finder);
diff --git a/docs/snippets/guide/augmentation/context_awareness_an.php b/docs/snippets/guide/augmentation/context_awareness_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Augmentation\Aware;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/augmentation/context_awareness_at.php b/docs/snippets/guide/augmentation/context_awareness_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Augmentation\Aware;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/augmentation/explicit_context_an.php b/docs/snippets/guide/augmentation/explicit_context_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Augmentation\Explicit;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/augmentation/explicit_context_at.php b/docs/snippets/guide/augmentation/explicit_context_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Augmentation\Explicit;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/cookbook/class_constants_an.php b/docs/snippets/guide/cookbook/class_constants_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ClassConstants;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/class_constants_at.php b/docs/snippets/guide/cookbook/class_constants_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ClassConstants;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/cookbook/default_security_an.php b/docs/snippets/guide/cookbook/default_security_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\DefaultSecurity;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/default_security_at.php b/docs/snippets/guide/cookbook/default_security_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\DefaultSecurity;
+
 use OpenApi\Attributes as OAT;
 
 #[OAT\OpenApi(
diff --git a/docs/snippets/guide/cookbook/enums_an.php b/docs/snippets/guide/cookbook/enums_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\Enums;
+
 use OpenApi\Annotations as OA;
 
 /** @OA\Schema() */
diff --git a/docs/snippets/guide/cookbook/enums_at.php b/docs/snippets/guide/cookbook/enums_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\Enums;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/cookbook/external_documentation_an.php b/docs/snippets/guide/cookbook/external_documentation_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ExternalDocumentation;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/external_documentation_at.php b/docs/snippets/guide/cookbook/external_documentation_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ExternalDocumentation;
+
 use OpenApi\Attributes as OA;
 
 #[OA\OpenApi(
diff --git a/docs/snippets/guide/cookbook/file_upload_with_headers_an.php b/docs/snippets/guide/cookbook/file_upload_with_headers_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\FileUploadWithHeaders;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/file_upload_with_headers_at.php b/docs/snippets/guide/cookbook/file_upload_with_headers_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\FileUploadWithHeaders;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/multi_value_query_parameter_an.php b/docs/snippets/guide/cookbook/multi_value_query_parameter_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\MultiValueQueryParameter;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/multi_value_query_parameter_at.php b/docs/snippets/guide/cookbook/multi_value_query_parameter_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\MultiValueQueryParameter;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/nested_objects_an.php b/docs/snippets/guide/cookbook/nested_objects_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\NestedObjects;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/nested_objects_at.php b/docs/snippets/guide/cookbook/nested_objects_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\NestedObjects;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema(
diff --git a/docs/snippets/guide/cookbook/oneof_example_an.php b/docs/snippets/guide/cookbook/oneof_example_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\OneOf;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/oneof_example_at.php b/docs/snippets/guide/cookbook/oneof_example_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\OneOf;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/properties_with_union_types_an.php b/docs/snippets/guide/cookbook/properties_with_union_types_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\UnionTypes;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/properties_with_union_types_at.php b/docs/snippets/guide/cookbook/properties_with_union_types_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\UnionTypes;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema(
diff --git a/docs/snippets/guide/cookbook/response_examples_an.php b/docs/snippets/guide/cookbook/response_examples_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ResponseExamples;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/response_examples_at.php b/docs/snippets/guide/cookbook/response_examples_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ResponseExamples;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/reusing_response_an.php b/docs/snippets/guide/cookbook/reusing_response_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ReusingResponse;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/reusing_response_at.php b/docs/snippets/guide/cookbook/reusing_response_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\ReusingResponse;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Response(
diff --git a/docs/snippets/guide/cookbook/secure_endpoint_an.php b/docs/snippets/guide/cookbook/secure_endpoint_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecureEndpoint;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/secure_endpoint_at.php b/docs/snippets/guide/cookbook/secure_endpoint_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecureEndpoint;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/security_schema_tips_an.php b/docs/snippets/guide/cookbook/security_schema_tips_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecuritySchemaTips;
+
 use OpenApi\Annotations as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/security_schema_tips_at.php b/docs/snippets/guide/cookbook/security_schema_tips_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecuritySchemaTips;
+
 use OpenApi\Attributes as OA;
 
 class Controller
diff --git a/docs/snippets/guide/cookbook/security_schemas_an.php b/docs/snippets/guide/cookbook/security_schemas_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecuritySchemas;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/security_schemas_at.php b/docs/snippets/guide/cookbook/security_schemas_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\SecuritySchemas;
+
 use OpenApi\Attributes as OA;
 
 #[OA\SecurityScheme(
diff --git a/docs/snippets/guide/cookbook/set_xml_root_name_an.php b/docs/snippets/guide/cookbook/set_xml_root_name_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\XmlRootName;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/set_xml_root_name_at.php b/docs/snippets/guide/cookbook/set_xml_root_name_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\XmlRootName;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema(
diff --git a/docs/snippets/guide/cookbook/uploading_multipart_formdata_an.php b/docs/snippets/guide/cookbook/uploading_multipart_formdata_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\UploadingMultipartFormData;
+
 use OpenApi\Annotations as OA;
 
 class OpenApiSpec
diff --git a/docs/snippets/guide/cookbook/uploading_multipart_formdata_at.php b/docs/snippets/guide/cookbook/uploading_multipart_formdata_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\UploadingMultipartFormData;
+
 use OpenApi\Attributes as OA;
 
 class OpenApiSpec
diff --git a/docs/snippets/guide/cookbook/virtual_model_an.php b/docs/snippets/guide/cookbook/virtual_model_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\VirtualModel;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/virtual_model_at.php b/docs/snippets/guide/cookbook/virtual_model_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\VirtualModel;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema(
diff --git a/docs/snippets/guide/cookbook/x_tag_groups_an.php b/docs/snippets/guide/cookbook/x_tag_groups_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\XTagGroups;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/cookbook/x_tag_groups_at.php b/docs/snippets/guide/cookbook/x_tag_groups_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Cookbook\XTagGroups;
+
 use OpenApi\Attributes as OA;
 
 #[OA\OpenApi(
diff --git a/docs/snippets/guide/enums/backed_enum_names_as_schema_an.php b/docs/snippets/guide/enums/backed_enum_names_as_schema_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\BackedNameAsSchema;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/enums/backed_enum_names_as_schema_at.php b/docs/snippets/guide/enums/backed_enum_names_as_schema_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\BackedNameAsSchema;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/enums/backed_enum_values_as_schema_an.php b/docs/snippets/guide/enums/backed_enum_values_as_schema_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\BackedValueAsSchema;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/enums/backed_enum_values_as_schema_at.php b/docs/snippets/guide/enums/backed_enum_values_as_schema_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\BackedValueAsSchema;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema(type: 'integer')]
diff --git a/docs/snippets/guide/enums/enum_as_schema_an.php b/docs/snippets/guide/enums/enum_as_schema_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\AsSchema;
+
 use OpenApi\Annotations as OA;
 
 /**
diff --git a/docs/snippets/guide/enums/enum_as_schema_at.php b/docs/snippets/guide/enums/enum_as_schema_at.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\AsSchema;
+
 use OpenApi\Attributes as OA;
 
 #[OA\Schema()]
diff --git a/docs/snippets/guide/enums/enum_as_values_an.php b/docs/snippets/guide/enums/enum_as_values_an.php
@@ -1,5 +1,7 @@
 <?php
 
+namespace Openapi\Snippets\Enums\Value;
+
 use OpenApi\Annotations as OA;
 
 enum Suit
diff --git a/docs/snippets/guide/enums/enum_as_values_at.php b/docs/snippets/guide/enums/enum_as_values_at.php
diff --git a/docs/snippets/guide/faq/dummy_class_an.php b/docs/snippets/guide/faq/dummy_class_an.php
diff --git a/docs/snippets/guide/faq/dummy_class_at.php b/docs/snippets/guide/faq/dummy_class_at.php
diff --git a/docs/snippets/guide/shortcuts/response_json_content_an.php b/docs/snippets/guide/shortcuts/response_json_content_an.php
diff --git a/docs/snippets/guide/shortcuts/response_json_content_at.php b/docs/snippets/guide/shortcuts/response_json_content_at.php
diff --git a/docs/snippets/guide/shortcuts/response_media_type_an.php b/docs/snippets/guide/shortcuts/response_media_type_an.php
diff --git a/docs/snippets/guide/shortcuts/response_media_type_at.php b/docs/snippets/guide/shortcuts/response_media_type_at.php
diff --git a/docs/snippets/guide/vendor-extensions/custom_property_an.php b/docs/snippets/guide/vendor-extensions/custom_property_an.php
diff --git a/docs/snippets/guide/vendor-extensions/custom_property_at.php b/docs/snippets/guide/vendor-extensions/custom_property_at.php
diff --git a/docs/snippets/minimal_api_an.php b/docs/snippets/minimal_api_an.php
diff --git a/docs/snippets/minimal_api_at.php b/docs/snippets/minimal_api_at.php
diff --git a/tests/DocSnippetsTest.php b/tests/DocSnippetsTest.php

-Original file line number
+Diff line change
@@ @@ -1,5 +1,7 @@ @@
 <?php
 +namespace Openapi\Snippets\Augmentation\Aware;
++
 use OpenApi\Annotations as OA;
 /**