Dekiru.DtoGenerator 0.0.5

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

C# allows for grouping attributes: [Foo, Bar]. At runtime, there is no difference between this and [Foo] [Bar]. However, the source generator uses the grouping to determine which attributes are related to each other. The attributes [Dto.When] and [NoCopy] affect other property attributes in the same group. [Using] is used to add additional using directives to the generated code, and must be in the same group as a [Dto] attribute.

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. Each [Dto] attribute must be in a separate attribute group:

OK:

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

Not OK:

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

The attribute has the following parameters:

• name (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 (params string[]): The namespaces to add.

[Partial]

Indicates that the generated DTO should be a partial class. This attribute must be in the same attribute group as a [Dto] attribute.

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.

This attribute is only relevent when using [Type] to specify a different type for the property.

[Exclude]

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

[Include]

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

[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]

[For]

Used to conditionally apply other property attributes. The attribute has the following parameters:

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

[For("Foo"), Include] public string Name { get; set; }