From 9cb731c16e991cc1dfe4311d841f7f260b1066f6 Mon Sep 17 00:00:00 2001 From: Honza Dvorsky Date: Fri, 19 Jan 2024 11:07:21 +0100 Subject: [PATCH 1/2] Update Project-scope-and-goals.md --- .../Documentation.docc/Articles/Project-scope-and-goals.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md b/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md index 4d3aedfa..e29cf0fb 100644 --- a/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md +++ b/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md @@ -38,9 +38,7 @@ Another example is the generation of empty structs within the input or output ty Some generators offer lots of options that affect the code generation process. In order to keep the project streamlined and maintainable, Swift OpenAPI Generator offers very few options. -One concrete example of this is that users cannot configure the access modifier for generated code, nor does the generated code make any provision for namespace collisions in the target into which it is generated. - -Instead, users are advised to generate code into its own target, and use Swift's module system to separate the generated code from code that uses it. +One concrete example of this is the lack of ability to configure the names of generated types, such as `APIProtocol`, or to customize how Swift names are computed from strings provided in the OpenAPI document. You can read more about this in . From 4398cfba042dd6d6f6db54ba047698ea81689575 Mon Sep 17 00:00:00 2001 From: Honza Dvorsky Date: Mon, 22 Jan 2024 15:47:56 +0100 Subject: [PATCH 2/2] Update Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md Co-authored-by: Si Beaumont --- .../Documentation.docc/Articles/Project-scope-and-goals.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md b/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md index e29cf0fb..d34dc231 100644 --- a/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md +++ b/Sources/swift-openapi-generator/Documentation.docc/Articles/Project-scope-and-goals.md @@ -38,7 +38,11 @@ Another example is the generation of empty structs within the input or output ty Some generators offer lots of options that affect the code generation process. In order to keep the project streamlined and maintainable, Swift OpenAPI Generator offers very few options. -One concrete example of this is the lack of ability to configure the names of generated types, such as `APIProtocol`, or to customize how Swift names are computed from strings provided in the OpenAPI document. +One concrete example of this is that users cannot configure the names of generated types, such as `Client` and `APIProtocol`, and there is no attempt to prevent namespace collisions in the target into which it is generated. + +Instead, users are advised to generate code into a dedicated target, and use Swift's module system to separate the generated code from code that depends on it. + +Another example is the lack of ability to customize how Swift names are computed from strings provided in the OpenAPI document. You can read more about this in .