Dekiru.DtoGenerator 0.0.9

DTO Generator

A Source Generator that generates DTO classes from existing classes. Configuration is done via attributes, as described below. All generated code should be compatible with .NET Standard 2.0 or later.

The DTO generator will, by design, not include properties from any base class. If you have that need, generate a DTO from the base class and have your other DTO inherit from that one.

The DTO generator will also only include public instance properties.

Attributes

The following attributes are used to configure the DTO generator:

Class attributes

[Dto]

Marks a class for DTO generation. A class may have multiple DTOs generated for it, each with a different set of properties.

[Dto("Foo", "DtoNamespace")]
[Dto("Bar", "DtoNamespace2")]

Or

[Dto(["Foo", "Bar"], "DtoNamespace")]

The attribute has the following parameters:

• name (string | string[]): The name of the DTO. This is used as the class name of the generated DTO. The $ variable can be used to reference the name of the source class.
• namespace (string): The namespace of the generated DTO. The $ variable can be used to reference the namespace of the source class.
• baseClass (string, optional): The base class of the generated DTO.
• propertyStrategy (PropertyStrategy, optional): The strategy to use when generating properties. Default is PropertyStrategy.Implicit.
  • Implicit: Generate all properties that are not marked with [Dto.Exclude].
  • Explicit: Generate only properties that are marked with [Dto.Include].

[Using]

Adds any number of using directives to the generated code. This attribute must be in the same attribute group as a [Dto] attribute. The attribute has the following parameters:

• namespaces (string[]): The namespaces to add.
• appliesTo (params string[], optional): A list of DTO names to which the using directives apply.

[Partial]

Indicates that the generated DTO should be a partial class. The attribute has the following parameters:

• appliesTo (params string[], optional): A list of DTO names to which the partial class attribute applies.

Property attributes

[Type]

Specifies a conversion function to use when copying a property. The attribute has the following parameters:

• type (string): The type of the property in the generated DTO.
• expression (string): An expression that converts the property value. The expression is evaluated in the context of the source object. The expression must return a value of the same type as the property. The expression may reference the property value using the $ variable.
• appliesTo (params string[], optional): A list of DTO names to which the type conversion applies.

[Exclude]

Excludes a property from the generated DTO. This attribute has no effect when the property strategy is PropertyStrategy.Explicit. The attribute has the following parameters:

• appliesTo (params string[], optional): A list of DTO names from which to exclude the property.

[Include]

Includes a property in the generated DTO. This attribute has no effect when the property strategy is PropertyStrategy.Implicit. The attribute has the following parameters:

• appliesTo (params string[], optional): A list of DTO names to which to include the property.

[NoCopy]

The default behavior of the DTO generator is to copy all other attributes of a property to the generated DTO. This attribute prevents this behavior:

[NoCopy, JsonIgnore]

The attribute has the following parameters:

• appliesTo (params string[], optional): A list of DTO names to which the no-copy attribute applies.