Olá, hoje vou apresentar uma biblioteca muito interessante capaz de gerar dados aleatórios muito precisos na nossa língua portuguesa (e outras línguas também) chamada Bogus.
Problema a ser solucionado
Frequentemente nos vemos diante de um teste ou criação de uma POC (proof of concept) onde necessitamos de uma massa de dados para validar nosso código, esses dados necessitam ser o mais parecido possível com o que esperamos para não deixarmos passar nenhum detalhe em nossas validações. Muitas vezes optamos por criar esses dados na mão, mas dependendo da quantidade necessária levamos muito tempo criando, as vezes até duplicando dados.
Nesse contexto a biblioteca Bogus nos auxilia muito, ela é capaz de gerar uma massa de dados do tamanho que você necessita, de forma rápida sem repetir nenhum registro, com suporte a diferentes línguas e muitas opções de dados para que o teste fique o mais real possível.
Demonstração
Para demonstrar o uso da biblioteca, iremos criar um projeto console em .Net e adicionar a biblioteca através do gerenciador de pacotes nuget ou da execução do comando:
dotnet add package Bogus
Vamos também criar nossa classe Pessoa
(mais clássico impossível hahahaha), que será utilizada para gerar nossa massa de dados.
public class Pessoa
{
public int Id { get; set; }
public string Nome { get; set; }
public string Email { get; set; }
public DateTime DataNascimento { get; set; }
public string Telefone { get; set; }
}
Pronto, vamos agora começar a usar a biblioteca para gerar alguns dados. Dentro da classe Program
da nossa aplicação console iremos configurar para ser gerado um objeto Pessoa.
Pessoa pessoa = new Faker<Pessoa>("pt_BR")
.RuleFor(x => x.Id, f => f.Random.Int(1))
.RuleFor(x => x.Nome, f => f.Name.FullName())
.RuleFor(x => x.Email, (f, u) => f.Internet.Email(u.Nome))
.RuleFor(x => x.DataNascimento, f => f.Date.Past(50))
.RuleFor(x => x.Telefone, f => f.Phone.PhoneNumberFormat())
.Generate();
Console.WriteLine(JsonConvert.SerializeObject(pessoa, Formatting.Indented));
Se você já utilizou a biblioteca FluentValidation
deve estar reconhecendo a forma de configurar, é praticamente igual.
Olhando o código podemos ver que estamos instanciando a classe Faker
passando Pessoa como tipo genérico e setando a língua para português do Brasil, isso ajuda muito a termos dados mais precisos.
A partir dai criamos uma regra para cada propriedade da classe Pessoa.
.RuleFor(x => x.Id, f => f.Random.Int(1))
Setando para a propriedade Id
um valor aleatório inteiro sendo o valor mínimo 1.
.RuleFor(x => x.Nome, f => f.Name.FullName())
Setando para a propriedade Nome
um nome completo aleatório.
Veja no exemplo abaixo que a biblioteca é tão legal que podemos até especificar se queremos um nome do sexo masculino ou feminino.
.RuleFor(x => x.Nome, f => f.Name.FullName(Bogus.DataSets.Name.Gender.Male))
.RuleFor(x => x.Email, (f, u) => f.Internet.Email(u.Nome))
Setando para a propriedade Email
um email aleatório baseado no nome gerado anteriormente.
.RuleFor(x => x.DataNascimento, f => f.Date.Past(50))
Setando para a propriedade DataNascimento
uma data baseada nos últimos 50 anos.
.RuleFor(x => x.Telefone, f => f.Phone.PhoneNumberFormat())
Setando para a propriedade Telefone
um número já formatado no padrão utilizado aqui no Brasil.
Rodando a aplicação teremos no console o resultado:
Como podemos ver nos exemplos acima são muitas opções de customização para os dados fazendo com que o resultado seja muito próximo de um dado real.
Criando uma grande quantidade de dados
Olhando novamente o exemplo anterior, quem faz de fato o objeto ser criado é o método Generate()
, sendo assim se você precisar de 500 registros, basta você setar Generate(500)
que ele irá gerar 500 registros sendo nenhum deles repetido, segue um exemplo.
List<Pessoa> pessoaLista = new Faker<Pessoa>("pt_BR")
.RuleFor(x => x.Id, f => f.Random.Int(1,100))
.RuleFor(x => x.Nome, f => f.Name.FullName())
.RuleFor(x => x.Email, (f, u) => f.Internet.Email(u.Nome))
.RuleFor(x => x.DataNascimento, f => f.Date.Between(Convert.ToDateTime("01/01/1990"), Convert.ToDateTime("01/01/2000")))
.RuleFor(x => x.Telefone, f => f.Phone.PhoneNumberFormat())
.Generate(500);
Projeto de exemplo
Caso tenha ficado ainda alguma dúvida no código, você pode ver o exemplo que eu criei nesse repositório do Github.
Se gostou utilize os botões do lado esquerdo para que eu possa saber. Caso tenha alguma dúvida, sugestão ou crítica, deixe um comentário logo abaixo.
Muito obrigado!
Top comments (5)
Opa Marcos beleza?
Sabe como posso passar os parâmetros para gerar o cpf sem os caracteres "." e "-"?
Obrigado
E ae Leandro, tudo tranquilo? Você pode gerar o CPF e depois remover os pontos por conta própria, algo assim:
Fala, Marcos! Beleza?
Segunda-feira vou precisar gerar algumas massas para teste e seu artigo veio na hora certa.
Parabéns e muito obrigado por compartilhar!
Olá João, que bom que lhe será útil, obrigado por passar por aqui!
Boa Nelson, já li alguns artigos seu no Medium buscando alguns temas no Google, muito bom! 👏
Agradeço por ter passado por aqui!