# Configuration

## Project Configuration

You can configure the source generator via properties in your `csproj` or `Directory.build.props`.

```xml
<PropertyGroup>
    <ValidlyConfiguration>
        <AutoRequired>enabled</AutoRequired>
        <AutoInEnum>enabled</AutoInEnum>
        <ExitEarly>disabled</ExitEarly>
    </ValidlyConfiguration>
</PropertyGroup>
```

### AutoRequire

The `AutoRequire` property allows you to automatically apply the `[Required]` attribute to your objects. When enabled, it ensures that all properties in your object that need to be non-nullable have this attribute applied. This makes it easier to enforce validation rules without manually adding the `[Required]` attribute to each property.&#x20;

This property is <mark style="color:blue;">enabled by default</mark>. Use `<AutoRequired>disabled</AutoRequired>` in your project configuration to disable this feature.

### AutoInEnum

The `AutoInEnum` property allow you to automatically apply the \[InEnum] attribute to yout objects. When enabled, it ensures that all enum properties in your object have this attribute applied.&#x20;

This property is <mark style="color:blue;">enabled by default</mark>. Use `<AutoInEnum>disabled</AutoInEnum>` in your project configuration to disable this feature.

### ExitEarly

The `ExitEarly` property modifies the validation behavior: when enabled, validation stops at the first error encountered, and no further validations are executed.

This property is <mark style="color:blue;">disabled by default</mark>. Use `<ExitEarly>enabled</``ExitEarly>` in your project configuration to enable this feature.

## Override Project Configuration via Validatable Attribute

In addition to the global project configuration, you can use properties of the `[Validatable]` attribute to customize validation behavior on a per-object basis. The attribute provides two properties:

* `UseAutoValidators`: Enabling this option overrides the project configuration, applying automatic validators to the particular object even if they are disabled globally.
* `NoAutoValidators`: This option prevents the automatic validators from being applied, even if they are enabled by default in the project configuration.

These options offer flexibility, allowing you to fine-tune validation requirements for specific objects without altering the overall project settings.

```csharp
[Validatable(NoAutoValidators = true)]
public partial class CreateUserRequest
{
    public required string Username { get; init; }
}
```

## Runtime Options

To configure the runtime of the validation you can use static class `ValidlyOptions`.

```csharp
ValidlyOptions.Configure(cfg =>
    cfg.WithObjectPoolSize(16)
        .WithGlobalMessagesPoolSize(16)
        .WithPropertyMessagesPoolSize(16)
);
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://validly.gitbook.io/docs/getting-started/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.