faker

# Faker [![Gem Version][version-badge]][rubygems] [![Build Status][github-actions-badge]][github-actions] [![Total Downloads][downloads-total]][rubygems] [![Downloads][downloads-badge]][rubygems]

<div align="center">
  <img src="https://user-images.githubusercontent.com/36028424/40263395-4318481e-5b44-11e8-92e5-3dcc1ce169b3.png" width="400"/>
  <p>Generate (almost) realistic fake data for testing, demos, and populating your database during development.</p>
</div>

[version-badge]: https://img.shields.io/gem/v/faker.svg
[rubygems]: https://rubygems.org/gems/faker
[github-actions-badge]: https://img.shields.io/github/actions/workflow/status/faker-ruby/faker/.github/workflows/ruby.yml?branch=main
[github-actions]: https://github.com/faker-ruby/faker/actions
[downloads-total]: https://img.shields.io/gem/dt/faker.svg
[downloads-badge]: https://img.shields.io/gem/dtv/faker.svg

## Quick links

- 📖 **[Read the documentation for the latest version][rubydocs].**
- 📢 **[See what's changed in recent versions][changelog].**

[rubydocs]: https://www.rubydoc.info/gems/faker/
[changelog]: CHANGELOG.md

## Features

- Internet: Email addresses, Passwords, Domains, etc.
- Date and Time: Travel back in time or to the future.
- Person: Names, Genders, Bios, Job titles, and more.
- Number and String: Random numbers and strings.
- Location: Addresses, Zip Codes, Street Names, States, and Countries.
- Finance: Account Details, Transactions, and Crypto Addresses.
- Localization - Customize faker with over 40 locales to generate realistic-looking Names, Addresses, and Phone Numbers.

> **Note:** The generated names, addresses, emails, phone numbers, and/or other data might return valid information. Please be careful when using faker in your tests.

For a complete list of the generators, see [Generators](./GENERATORS.md).

## Getting Started

Start by including `faker` in your Gemfile:

```ruby
gem 'faker'
```

Then run `bundle install`.

## Usage

```ruby
require 'faker'

Faker::Name.name                      #=> "Christophe Bartell"
Faker::Internet.password              #=> "Vg5mSvY1UeRg7"
Faker::Internet.email                 #=> "eliza@mann.test"
Faker::Address.full_address           #=> "5479 William Way, East Sonnyhaven, LA 63637"
Faker::Markdown.emphasis              #=> "Quo qui aperiam. Amet corrupti distinctio. Sit quia *dolor.*"
Faker::Lorem.paragraph                #=> "Recusandae minima consequatur. Expedita sequi blanditiis. Ut fuga et."
Faker::Alphanumeric.alpha(number: 10) #=> "zlvubkrwga"
Faker::ProgrammingLanguage.name       #=> "Ruby"
```

## Table of Contents

- [Faker    ](#faker----)
  - [Quick links](#quick-links)
  - [Features](#features)
  - [Getting Started](#getting-started)
  - [Usage](#usage)
  - [Table of Contents](#table-of-contents)
    - [Notes](#notes)
    - [Ensuring unique values](#ensuring-unique-values)
    - [Deterministic Random](#deterministic-random)
    - [Localization](#localization)
    - [Minitest and Faker \>= 2.22](#minite