C# Generation that shares existing DTO project

[JohnGalt1717]

Hi all,

I have a C# minimal api server that generates an openapi.json file. All of our DTOs are in a separate shared project. I'd like to reuse that shared project instead of having Kiota generate a less accurate version of those DTOs so that our Maui/Uno project can just reference the shared library along with the shared client.

Is this possible?

[Bulletdev]

Yes, this is possible. With Kiota, you can customize the generation process to use your existing DTOs instead of generating new ones. Here are the key steps:

Configure Kiota to skip DTO generation
Point Kiota to your existing shared library
Reference the shared library in your Maui/Uno project

In your Kiota generation command or configuration, you'll want to use options that prevent regenerating DTOs and instead use your existing types. The exact method depends on your specific Kiota setup, but typically involves specifying a custom namespace mapping or using configuration flags to reference existing types.

[JohnGalt1717]

That's awesome! Could you give me a little more guidance? I can't find any parameters that allow skipping of the dtos or using the shared library (or how to get it to find the dto namespace pathing)

[Bulletdev]

sure bro,

I'll help you configure Kiota to use your existing DTOs. Here's a detailed approach:

{
  "openAPIFilePath": "path/to/openapi.json",
  "outputPath": "./generated",
  "clientClassName": "ApiClient",
  "namespaceMappings": {
    "Your.Existing.Namespace": "YourSharedProject.Models"
  },
  "excludedTypeNames": [
    "ListOfYourExistingDTOs"
  ],
  "additionalProperties": {
    "useExistingTypes": true,
    "skipTypeGeneration": true
  }
}

In your Kiota generation command, you'll want to add flags like:

kiota generate \
  --openapi path/to/openapi.json \
  --output ./generated \
  --namespace-mapping "Your.Existing.Namespace=YourSharedProject.Models" \
  --skip-generation-if-type-exists \
  --exclude-type-names "ListOfYourDTOsToSkip"

Key configuration points:

Use --namespace-mapping to tell Kiota about your existing types
--skip-generation-if-type-exists prevents regenerating existing types
--exclude-type-names lets you specifically exclude certain DTOs

In your project:

Reference your shared DTOs project
Include the generated Kiota client
Ensure namespace configurations match

[Trapulo]

but ListOfYourExistingDTOs may be a full list of every single class?
and YourSharedProject.Models?

thanks