NBuilder é uma biblioteca .NET que simplifica a geração de dados de teste. Com sua interface intuitiva, os desenvolvedores podem criar grafos de objetos complexos sem esforço. Oferece flexibilidade, eficiência e integração perfeita com as estruturas de teste mais populares. Neste artigo, exploraremos os recursos do NBuilder, como instalá-lo e demonstraremos suas capacidades com exemplos práticos de código.
Para instalar o NBuilder no Console do Gerenciador de Pacotes NuGet , use o seguinte comando.
O comando acima instalará o NBuilder com todas as suas dependências.
O NBuilder oferece uma maneira fluida de criar objetos dinamicamente. Vamos começar com um exemplo simples de criação de um objeto.
Aqui está o código-fonte da classe do modelo Pessoa.
class Person
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
public bool IsMarried { get; set; }
}Friend Class Person
Public Property Id() As Integer
Public Property Name() As String
Public Property Email() As String
Public Property IsMarried() As Boolean
End Class// Create a new person object with default values using NBuilder
var person = Builder<Person>
.CreateNew()
.Build();
// By default, NBuilder can provide values like
// Id = 1, Name = Name1, Email = Email1, IsMarried = false' Create a new person object with default values using NBuilder
Dim person = Builder(Of Person) .CreateNew().Build()
' By default, NBuilder can provide values like
' Id = 1, Name = Name1, Email = Email1, IsMarried = false
Aqui está um exemplo de como usar o NBuilder para criar e configurar um objeto Pessoa com propriedades personalizadas:
// Initialize a custom builder for the Person object with specific values
var customPersonBuilder = Builder<Person>.CreateNew()
.With(p => p.Name = "Tom")
.With(p => p.Email = "Tom@email.com");
// Build the custom person object with the specified properties
var objTom = customPersonBuilder.Build();' Initialize a custom builder for the Person object with specific values
Dim customPersonBuilder = Builder(Of Person).CreateNew().With(Sub(p) p.Name = "Tom").With(Sub(p) p.Email = "Tom@email.com")
' Build the custom person object with the specified properties
Dim objTom = customPersonBuilder.Build()O código acima cria um novo objeto Pessoa com propriedades personalizadas. Inicializa um customPersonBuilder para um objeto Person, definindo o Nome como "Tom" e o Email como "Tom@email.com". Finalmente, ele constrói o objeto e o atribui a objTom.
// Create a list of 10 Person objects with default values using NBuilder
var personList = Builder<Person>
.CreateListOfSize(10)
.Build();' Create a list of 10 Person objects with default values using NBuilder
Dim personList = Builder(Of Person) .CreateListOfSize(10).Build()
Aqui, a lista personList contém 10 objetos com seus valores padrão e os imprime.
// Creating a list of 10 Person objects with default values
var personList = Builder<Person>
.CreateListOfSize(10)
.Build();
// Print details of each Person object in the list
foreach (var person in personList)
{
Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}");
}' Creating a list of 10 Person objects with default values
Dim personList = Builder(Of Person) .CreateListOfSize(10).Build()
' Print details of each Person object in the list
For Each person In personList
Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}")
Next person
Às vezes, pode ser necessário personalizar os objetos que estão sendo criados. Você também pode personalizar o valor de um objeto utilizando o método With().
// Customize properties for all Person objects in the list
var personList = Builder<Person>
.CreateListOfSize(10)
.All()
.With(p => p.Name = "Kim")
.With(p => p.Email = "abc@email.com")
.With(p => p.IsMarried = false)
.Build();' Customize properties for all Person objects in the list
Dim personList = Builder(Of Person) .CreateListOfSize(10).All().With(Sub(p) p.Name = "Kim").With(Sub(p) p.Email = "abc@email.com").With(Sub(p) p.IsMarried = False).Build()Isso cria um personList com cada objeto tendo seu valor padrão substituído para Nome = "Kim", Email = "abc@email.com" e IsMarried = false.
Para obter valores de dados realistas na Lista de Pessoas, você pode usar a biblioteca Faker .NET para gerar dados realistas.
// Creating a list of Person objects with random yet realistic values using Faker
var personList = Builder<Person>
.CreateListOfSize(10)
.All()
.With(p => p.Name = Faker.Name.FullName())
.With(p => p.Id = Faker.RandomNumber.Next(20, 60))
.Build();' Creating a list of Person objects with random yet realistic values using Faker
Dim personList = Builder(Of Person) .CreateListOfSize(10).All().With(Sub(p) p.Name = Faker.Name.FullName()).With(Sub(p) p.Id = Faker.RandomNumber.Next(20, 60)).Build()Exemplo 6: Criando uma lista de objetos Pessoa com dados sequenciais
Existem momentos em que você pode precisar gerar objetos com dados sequenciais. O NBuilder .NET facilita isso usando o método Do.
// Creating a list of 10 sequential Person objects using NBuilder
var personList = Builder<Person>.CreateListOfSize(10)
.All()
.Do((p, i) => p.Id = 501 + i)
.Do((p, i) => p.Name = $"Person {i + 1}")
.Build();' Creating a list of 10 sequential Person objects using NBuilder
Dim personList = Builder(Of Person).CreateListOfSize(10).All().Do(Sub(p, i) p.Id = 501 + i).Do(Sub(p, i) p.Name = $"Person {i + 1}").Build()Aqui, o método All() garante que as operações subsequentes sejam aplicadas a todos os 10 objetos pessoa criados na memória. O método Do() executa o delegado Action em cada objeto Person. Este ajuste atribui a propriedade Id sequencialmente começando do 501, e, de forma semelhante, nomeia cada pessoa sequencialmente como "Pessoa 1" até "Pessoa 10".
Exemplo 7: NBuilder com testes unitários usando Xunit
O NBuilder no .NET é amplamente utilizado em ambientes de teste, onde os desenvolvedores precisam gerar um conjunto de dados realista e diversificado para os testes. Isso facilita e simplifica a manutenção dos testes com objetos complexos, permitindo que os desenvolvedores definam lógica de inicialização personalizada usando expressões lambda e funções delegadas, atendendo àqueles interessados em geração de dados de teste eficiente e flexível.
class Person
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
public bool IsMarried { get; set; }
}
class PersonService
{
public string GetPersonEmail(Person person)
{
return person.Email;
}
}Friend Class Person
Public Property Id() As Integer
Public Property Name() As String
Public Property Email() As String
Public Property IsMarried() As Boolean
End Class
Friend Class PersonService
Public Function GetPersonEmail(ByVal person As Person) As String
Return person.Email
End Function
End ClassAqui, a classe Person tem várias propriedades, tais como Id, Name, Email e IsMarried, enquanto PersonService contém um método GetPersonEmail() que retorna o email de um determinado Person.
using Xunit;
public class PersonTests
{
[Fact]
public void GetPersonEmail_ReturnCorrectEmail()
{
// Arrange
var service = new PersonService();
string expectedEmail = "Tom@email.com";
// Create a person with specific name and email using NBuilder
var person = Builder<Person>.CreateNew()
.With(p => p.Name = "Tom")
.With(p => p.Email = "Tom@email.com")
.Build();
// Act
var actualEmail = service.GetPersonEmail(person);
// Assert
Assert.Equal(expectedEmail, actualEmail);
}
}Imports Xunit
Public Class PersonTests
<Fact>
Public Sub GetPersonEmail_ReturnCorrectEmail()
' Arrange
Dim service = New PersonService()
Dim expectedEmail As String = "Tom@email.com"
' Create a person with specific name and email using NBuilder
Dim person = Builder(Of Person).CreateNew() _
.With(Function(p) p.Name = "Tom") _
.With(Function(p) p.Email = "Tom@email.com") _
.Build()
' Act
Dim actualEmail = service.GetPersonEmail(person)
' Assert
Assert.Equal(expectedEmail, actualEmail)
End Sub
End ClassEste teste unitário verifica se o método GetPersonEmail da classe PersonService retorna corretamente o endereço de email de um objeto Person com o email esperado "Tom@email.com". Ele utiliza o padrão Arrange-Act-Assert para configurar os dados de teste, executar o método e, em seguida, verificar se o resultado real corresponde ao resultado esperado.
Saiba mais sobre o IronPDF , uma poderosa biblioteca C# projetada para criar PDFs a partir de HTML em aplicativos .NET . Com sua API intuitiva, os desenvolvedores podem integrar facilmente a funcionalidade de PDF em seus projetos, seja para gerar faturas, relatórios ou formulários interativos.
Abra o console do Gerenciador de Pacotes NuGet e execute o seguinte comando:
// Generating instances of the Person class with NBuilder
var people = Builder<Person>.CreateListOfSize(5).Build();' Generating instances of the Person class with NBuilder
Dim people = Builder(Of Person).CreateListOfSize(5).Build()Este código define a chave de licença do IronPDF e gera conteúdo HTML a partir de uma lista de objetos Person.
// Setting the IronPDF license key
IronPdf.License.LicenseKey = "Your-License-Key";
// Building HTML content from Person object list
var htmlContent = "<h1>Person List</h1>";
foreach (var person in people)
{
htmlContent += $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>";
}' Setting the IronPDF license key
IronPdf.License.LicenseKey = "Your-License-Key"
' Building HTML content from Person object list
Dim htmlContent = "<h1>Person List</h1>"
For Each person In people
htmlContent &= $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>"
Next personO IronPdf.License.LicenseKey é configurado com uma chave de licença específica para habilitar os recursos do IronPDF. O conteúdo HTML é dinamicamente construído iterando sobre a lista people, anexando os detalhes de cada objeto Person (Id, Nome, Email, IsMarried) à estrutura HTML.
Este código converte conteúdo HTML em um documento PDF usando o ChromePdfRenderer do IronPDF.
// Rendering HTML content into a PDF document using IronPDF
var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf(htmlContent);
pdfDoc.SaveAs("PersonList.pdf");' Rendering HTML content into a PDF document using IronPDF
Dim renderer = New ChromePdfRenderer()
Dim pdfDoc = renderer.RenderHtmlAsPdf(htmlContent)
pdfDoc.SaveAs("PersonList.pdf")ChromePdfRenderer é instanciado para renderizar o conteúdo HTML armazenado em htmlContent em um documento PDF. O documento PDF resultante é salvo no sistema de arquivos com o nome "PersonList.pdf".
Abaixo está o resultado da lista de pessoas (PersonList) gerada pelo IronPDF. Contém cinco pessoas, cada uma com valores padrão.
Em resumo, o NBuilder é uma ferramenta robusta e flexível para gerar dados de teste em .NET, simplificando a criação de grafos de objetos complexos e aumentando a eficiência dos processos de teste. Ao integrar-se com o IronPDF, os desenvolvedores podem facilmente estender seus aplicativos para incluir recursos de geração de PDF para aqueles que consideram isso valioso para seus projetos. Em conjunto, o NBuilder e o IronPDF podem aprimorar significativamente os fluxos de trabalho de desenvolvimento, tornando os testes e a geração de documentos mais simples e eficientes.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
