# Cheat Sheet

A quick reference for every random data generator function, grouped by domain. Every function
that accepts a keyword list of options ships with a default, so it works with zero arguments
too. For country-specific formats that don't fit a shared `:locale` option, like US Social
Security Numbers or Indonesian NIK/NPWP, see the [Locale Cheat Sheet](locale-cheat.html).

## [Address](`NeoFaker.Address`)

{: .col-2}

### [`building_number(range \\ 1..100)`](`NeoFaker.Address.building_number/1`)

```elixir
iex> NeoFaker.Address.building_number()
"42"

iex> NeoFaker.Address.building_number(1..100)
"25"
```

### [`city(opts \\ [])`](`NeoFaker.Address.city/1`)

```elixir
iex> NeoFaker.Address.city()
"Saint Marys City"

iex> NeoFaker.Address.city(locale: :id_id)
"Palu"
```

### [`country(opts \\ [])`](`NeoFaker.Address.country/1`)

```elixir
iex> NeoFaker.Address.country()
"United States"

iex> NeoFaker.Address.country(locale: :id_id)
"Amerika Serikat"
```

### [`coordinate(opts \\ [])`](`NeoFaker.Address.coordinate/1`)

```elixir
iex> NeoFaker.Address.coordinate()
{11.5831672, 165.3662683}

iex> NeoFaker.Address.coordinate(precision: 2)
{11.58, 165.37}
```

### [`latitude(opts \\ [])`](`NeoFaker.Address.latitude/1`) / [`longitude(opts \\ [])`](`NeoFaker.Address.longitude/1`)

```elixir
iex> NeoFaker.Address.latitude()
11.5831672

iex> NeoFaker.Address.longitude(precision: 4)
165.3663
```

## [App](`NeoFaker.App`)

{: .col-2}

### [`author(opts \\ [])`](`NeoFaker.App.author/1`)

```elixir
iex> NeoFaker.App.author()
"José Valim"

iex> NeoFaker.App.author(middle_name: true)
"José Carlos Valim"

iex> NeoFaker.App.author(sex: :female)
"Juliana Silva"
```

### [`description(opts \\ [])`](`NeoFaker.App.description/1`)

```elixir
iex> NeoFaker.App.description()
"Elixir library for generating fake data in tests and development."

iex> NeoFaker.App.description(locale: :id_id)
"Pustaka Elixir untuk menghasilkan data palsu dalam pengujian dan pengembangan."
```

### [`license()`](`NeoFaker.App.license/0`)

```elixir
iex> NeoFaker.App.license()
"MIT License"
```

### [`name(opts \\ [])`](`NeoFaker.App.name/1`)

```elixir
iex> NeoFaker.App.name()
"Neo Faker"

iex> NeoFaker.App.name(style: :camel_case)
"neoFaker"

iex> NeoFaker.App.name(style: :dashed)
"neo-faker"

iex> NeoFaker.App.name(locale: :id_id)
"Garuda Web"
```

### [`semver(opts \\ [])`](`NeoFaker.App.semver/1`)

```elixir
iex> NeoFaker.App.semver()
"1.2.3"

iex> NeoFaker.App.semver(type: :pre_release)
"1.2.3-beta.1"

iex> NeoFaker.App.semver(type: :build)
"1.2.3+20250325"

iex> NeoFaker.App.semver(type: :pre_release_build)
"1.2.3-rc.1+20250325"
```

### [`version()`](`NeoFaker.App.version/0`)

```elixir
iex> NeoFaker.App.version()
"1.2"
```

### [`bundle_id(opts \\ [])`](`NeoFaker.App.bundle_id/1`)

```elixir
iex> NeoFaker.App.bundle_id()
"com.example.neo_faker"

iex> NeoFaker.App.bundle_id(style: :dashed)
"com.example.neo-faker"

iex> NeoFaker.App.bundle_id(domain: "mycompany.io")
"io.mycompany.neo_faker"
```

### [`package_name(opts \\ [])`](`NeoFaker.App.package_name/1`)

```elixir
iex> NeoFaker.App.package_name()
"com.example.neofaker"

iex> NeoFaker.App.package_name(domain: "mycompany.id")
"id.mycompany.neofaker"
```

## [Blood](`NeoFaker.Blood`)

{: .col-2}

### [`group(opts \\ [])`](`NeoFaker.Blood.group/1`)

```elixir
iex> NeoFaker.Blood.group()
"B+"

iex> NeoFaker.Blood.group(format: :type_only)
"O"

iex> NeoFaker.Blood.group(format: :rh_only)
"-"
```

### [`type()`](`NeoFaker.Blood.type/0`)

```elixir
iex> NeoFaker.Blood.type()
"B"
```

### [`rh_factor()`](`NeoFaker.Blood.rh_factor/0`)

```elixir
iex> NeoFaker.Blood.rh_factor()
"+"
```

### [`medical_notation(opts \\ [])`](`NeoFaker.Blood.medical_notation/1`)

```elixir
iex> NeoFaker.Blood.medical_notation()
"B positive"

iex> NeoFaker.Blood.medical_notation(verbose: true)
"Type AB, Rh positive"
```

### [`all_types()`](`NeoFaker.Blood.all_types/0`)

```elixir
iex> NeoFaker.Blood.all_types()
["A", "B", "AB", "O"]
```

### [`all_rh_factors()`](`NeoFaker.Blood.all_rh_factors/0`)

```elixir
iex> NeoFaker.Blood.all_rh_factors()
["+", "-"]
```

## [Boolean](`NeoFaker.Boolean`)

{: .col-1}

### [`boolean(true_ratio \\ 50)`](`NeoFaker.Boolean.boolean/1`)

```elixir
iex> NeoFaker.Boolean.boolean()
false

iex> NeoFaker.Boolean.boolean(75)
true

iex> NeoFaker.Boolean.boolean(0)
false

iex> NeoFaker.Boolean.boolean(100)
true
```

## [Color](`NeoFaker.Color`)

{: .col-2}

### [`cmyk(opts \\ [])`](`NeoFaker.Color.cmyk/1`)

```elixir
iex> NeoFaker.Color.cmyk()
{0, 25, 50, 100}

iex> NeoFaker.Color.cmyk(format: :w3c)
"cmyk(0%, 25%, 50%, 100%)"
```

### [`hex(opts \\ [])`](`NeoFaker.Color.hex/1`)

```elixir
iex> NeoFaker.Color.hex()
"#613583"

iex> NeoFaker.Color.hex(format: :three_digit)
"#365"

iex> NeoFaker.Color.hex(format: :eight_digit)
"#613583FF"
```

### [`hsl(opts \\ [])`](`NeoFaker.Color.hsl/1`)

```elixir
iex> NeoFaker.Color.hsl()
{180, 50, 75}

iex> NeoFaker.Color.hsl(format: :w3c)
"hsl(180, 50%, 75%)"
```

### [`hsla(opts \\ [])`](`NeoFaker.Color.hsla/1`)

```elixir
iex> NeoFaker.Color.hsla()
{180, 50, 75, 0.8}

iex> NeoFaker.Color.hsla(format: :w3c)
"hsla(180, 50%, 75%, 0.8)"
```

### [`keyword(opts \\ [])`](`NeoFaker.Color.keyword/1`)

```elixir
iex> NeoFaker.Color.keyword()
"blueviolet"

iex> NeoFaker.Color.keyword(category: :basic)
"purple"

iex> NeoFaker.Color.keyword(locale: :id_id)
"ungu"
```

### [`rgb(opts \\ [])`](`NeoFaker.Color.rgb/1`)

```elixir
iex> NeoFaker.Color.rgb()
{255, 128, 64}

iex> NeoFaker.Color.rgb(format: :w3c)
"rgb(255, 128, 64)"
```

### [`rgba(opts \\ [])`](`NeoFaker.Color.rgba/1`)

```elixir
iex> NeoFaker.Color.rgba()
{255, 128, 64, 0.8}

iex> NeoFaker.Color.rgba(format: :w3c)
"rgba(255, 128, 64, 0.8)"
```

### [`random(opts \\ [])`](`NeoFaker.Color.random/1`)

```elixir
iex> NeoFaker.Color.random()
{255, 128, 64}

iex> NeoFaker.Color.random()
"#613583"

iex> NeoFaker.Color.random(format: :w3c)
"rgb(255, 128, 64)"
```

## [Crypto](`NeoFaker.Crypto`)

{: .col-2}

### [`md5(opts \\ [])`](`NeoFaker.Crypto.md5/1`)

```elixir
iex> NeoFaker.Crypto.md5()
"afc4c626c55e4166421d82732163857d"

iex> NeoFaker.Crypto.md5(case: :upper)
"AFC4C626C55E4166421D82732163857D"
```

### [`sha1(opts \\ [])`](`NeoFaker.Crypto.sha1/1`)

```elixir
iex> NeoFaker.Crypto.sha1()
"356a192b7913b04c54574d18c28d46e6395428ab"
```

### [`sha256(opts \\ [])`](`NeoFaker.Crypto.sha256/1`)

```elixir
iex> NeoFaker.Crypto.sha256()
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
```

### [`sha512(opts \\ [])`](`NeoFaker.Crypto.sha512/1`)

```elixir
iex> NeoFaker.Crypto.sha512()
"cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e"
```

### [`hash(type, opts \\ [])`](`NeoFaker.Crypto.hash/2`)

```elixir
iex> NeoFaker.Crypto.hash(:md5)
"afc4c626c55e4166421d82732163857d"

iex> NeoFaker.Crypto.hash(:sha256, case: :upper)
"E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855"
```

### [`token(length \\ 32, opts \\ [])`](`NeoFaker.Crypto.token/2`)

```elixir
iex> NeoFaker.Crypto.token()
"dGVzdF90b2tlbl9oZXJl"

iex> NeoFaker.Crypto.token(32, encoding: :hex)
"a1b2c3d4e5f6708192a3b4c5d6e7f8091a2b3c4d5e6f7081"
```

### [`uuid(opts \\ [])`](`NeoFaker.Crypto.uuid/1`)

```elixir
iex> NeoFaker.Crypto.uuid()
"550e8400-e29b-41d4-a716-446655440000"

iex> NeoFaker.Crypto.uuid(format: :compact)
"550e8400e29b41d4a716446655440000"

iex> NeoFaker.Crypto.uuid(case: :upper)
"550E8400-E29B-41D4-A716-446655440000"
```

## [Date](`NeoFaker.Date`)

{: .col-2}

Every function returns a `Date` struct; pipe through `Date.to_iso8601/1` for a string.

### [`add(range \\ -365..365)`](`NeoFaker.Date.add/1`)

```elixir
iex> NeoFaker.Date.add()
~D[2025-03-25]

iex> NeoFaker.Date.add(0..31)
~D[2025-03-30]
```

### [`between(start, finish)`](`NeoFaker.Date.between/2`)

```elixir
iex> NeoFaker.Date.between()
~D[2014-07-11]

iex> NeoFaker.Date.between(~D[2020-01-01], ~D[2025-01-01])
~D[2022-08-17]
```

### [`birthday(min_age \\ 18, max_age \\ 65)`](`NeoFaker.Date.birthday/2`)

```elixir
iex> NeoFaker.Date.birthday()
~D[1997-01-02]

iex> NeoFaker.Date.birthday(18, 65)
~D[1998-03-04]
```

### [`past(days \\ 365)`](`NeoFaker.Date.past/1`)

```elixir
iex> NeoFaker.Date.past()
~D[2024-10-01]

iex> NeoFaker.Date.past(30)
~D[2025-02-25]
```

### [`future(days \\ 365)`](`NeoFaker.Date.future/1`)

```elixir
iex> NeoFaker.Date.future()
~D[2026-01-10]

iex> NeoFaker.Date.future(30)
~D[2025-04-24]
```

### [`today()`](`NeoFaker.Date.today/0`)

```elixir
iex> NeoFaker.Date.today()
~D[2025-03-25]
```

## [Gravatar](`NeoFaker.Gravatar`)

{: .col-2}

### [`display(email \\ nil, opts \\ [])`](`NeoFaker.Gravatar.display/2`)

```elixir
iex> NeoFaker.Gravatar.display()
"https://gravatar.com/avatar/<hash>?d=identicon&s=80"

iex> NeoFaker.Gravatar.display("john.doe@example.com", size: 100)
"https://gravatar.com/avatar/<hash>?d=identicon&s=100"

iex> NeoFaker.Gravatar.display("john.doe@example.com", fallback: :monsterid)
"https://gravatar.com/avatar/<hash>?d=monsterid&s=80"

iex> NeoFaker.Gravatar.display("user@test.com", rating: :pg)
"https://gravatar.com/avatar/<hash>?d=identicon&s=80&r=pg"

iex> NeoFaker.Gravatar.display("user@test.com", force_default: true)
"https://gravatar.com/avatar/<hash>?d=identicon&s=80&f=y"
```

### [`profile(email \\ nil, opts \\ [])`](`NeoFaker.Gravatar.profile/2`)

```elixir
iex> NeoFaker.Gravatar.profile()
"https://gravatar.com/<hash>"

iex> NeoFaker.Gravatar.profile("user@example.com", format: :json)
"https://gravatar.com/<hash>.json"

iex> NeoFaker.Gravatar.profile(nil, format: :qr)
"https://gravatar.com/<hash>.qr"
```

### [`random_display()`](`NeoFaker.Gravatar.random_display/0`)

```elixir
iex> NeoFaker.Gravatar.random_display()
"https://gravatar.com/avatar/<hash>?d=monsterid&s=150"
```

### [`fallback_types()`](`NeoFaker.Gravatar.fallback_types/0`)

```elixir
iex> NeoFaker.Gravatar.fallback_types()
[:identicon, :monsterid, :wavatar, :robohash, :retro, :blank, :"404"]
```

### [`default_size()`](`NeoFaker.Gravatar.default_size/0`)

```elixir
iex> NeoFaker.Gravatar.default_size()
80
```

### [`size_range()`](`NeoFaker.Gravatar.size_range/0`)

```elixir
iex> NeoFaker.Gravatar.size_range()
1..2048
```

## [HTTP](`NeoFaker.HTTP`)

{: .col-2}

### [`user_agent(opts \\ [])`](`NeoFaker.HTTP.user_agent/1`)

```elixir
iex> NeoFaker.HTTP.user_agent()
"Mozilla/5.0 (X11; Linux x86_64; rv:136.0) Gecko/20100101 Firefox/136.0"

iex> NeoFaker.HTTP.user_agent(type: :browser)
"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:136.0) Gecko/20100101 Firefox/136.0"

iex> NeoFaker.HTTP.user_agent(type: :crawler)
"ahrefsbot"

iex> NeoFaker.HTTP.user_agent(type: :ai)
"claude-user"
```

### [`request_method(opts \\ [])`](`NeoFaker.HTTP.request_method/1`)

```elixir
iex> NeoFaker.HTTP.request_method()
"GET"

iex> NeoFaker.HTTP.request_method(common_only: false)
"OPTIONS"
```

### [`referrer_policy()`](`NeoFaker.HTTP.referrer_policy/0`)

```elixir
iex> NeoFaker.HTTP.referrer_policy()
"no-referrer"
```

### [`status_code(opts \\ [])`](`NeoFaker.HTTP.status_code/1`)

```elixir
iex> NeoFaker.HTTP.status_code()
"200"

iex> NeoFaker.HTTP.status_code(type: :detailed)
"200 OK"

iex> NeoFaker.HTTP.status_code(group: :client_error)
"404"

iex> NeoFaker.HTTP.status_code(type: :detailed, group: :success)
"201 Created"
```

### [`protocol_version(opts \\ [])`](`NeoFaker.HTTP.protocol_version/1`)

```elixir
iex> NeoFaker.HTTP.protocol_version()
"HTTP/1.1"

iex> NeoFaker.HTTP.protocol_version(include_http3: false)
"HTTP/1.0"
```

### [`header_name(opts \\ [])`](`NeoFaker.HTTP.header_name/1`)

```elixir
iex> NeoFaker.HTTP.header_name()
"Content-Type"

iex> NeoFaker.HTTP.header_name(type: :request)
"User-Agent"

iex> NeoFaker.HTTP.header_name(type: :response)
"Server"
```

### [`all_request_methods()`](`NeoFaker.HTTP.all_request_methods/0`)

```elixir
iex> NeoFaker.HTTP.all_request_methods()
["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "TRACE", "CONNECT", "QUERY"]
```

### [`all_referrer_policies()`](`NeoFaker.HTTP.all_referrer_policies/0`)

```elixir
iex> NeoFaker.HTTP.all_referrer_policies()
["no-referrer", "no-referrer-when-downgrade", "same-origin", ...]
```

## [Internet](`NeoFaker.Internet`)

{: .col-2}

### [`username(opts \\ [])`](`NeoFaker.Internet.username/1`)

```elixir
iex> NeoFaker.Internet.username()
"josé_valim"

iex> NeoFaker.Internet.username(word_count: 3, joiner: :dot)
"abigail.bethany.crawford"

iex> NeoFaker.Internet.username(username_type: :word, number: true, number_range: 1..2025)
"elixir_alchemist_2012"
```

### [`domain_name(opts \\ [])`](`NeoFaker.Internet.domain_name/1`)

```elixir
iex> NeoFaker.Internet.domain_name()
"example"

iex> NeoFaker.Internet.domain_name(word_count: 3)
"alpha-beta-gamma"

iex> NeoFaker.Internet.domain_name(type: :popular, popular_type: :email)
"gmail.com"

iex> NeoFaker.Internet.domain_name(type: :custom, domain_name: "elixir-lang.org")
"elixir-lang.org"
```

### [`tld(opts \\ [])`](`NeoFaker.Internet.tld/1`)

```elixir
iex> NeoFaker.Internet.tld()
".com"

iex> NeoFaker.Internet.tld(dot: false)
"org"

iex> NeoFaker.Internet.tld(type: :safe)
".example"

iex> NeoFaker.Internet.tld(type: :country_code)
".id"
```

### [`email(opts \\ [])`](`NeoFaker.Internet.email/1`)

```elixir
iex> NeoFaker.Internet.email()
"josé@example.com"

iex> NeoFaker.Internet.email(username_word_count: 3, joiner: :dot, number: true)
"abigail.bethany.crawford_202@example.com"

iex> NeoFaker.Internet.email(domain_type: :popular, popular_type: :email)
"jane.doe@gmail.com"

iex> NeoFaker.Internet.email(domain_type: :custom, domain_name: "elixir-lang.org")
"josé@elixir-lang.org"
```

### [`ipv4(opts \\ [])`](`NeoFaker.Internet.ipv4/1`)

```elixir
iex> NeoFaker.Internet.ipv4()
"183.235.34.108"

iex> NeoFaker.Internet.ipv4(private: true)
"192.168.1.42"

iex> NeoFaker.Internet.ipv4(private: true, class: :a)
"10.25.30.100"
```

### [`ipv6(opts \\ [])`](`NeoFaker.Internet.ipv6/1`)

```elixir
iex> NeoFaker.Internet.ipv6()
"E0E6:7E24:EC6E:E44C:FC69:9C25:CD85:CE08"

iex> NeoFaker.Internet.ipv6(uppercase: false)
"e0e6:7e24:ec6e:e44c:fc69:9c25:cd85:ce08"

iex> NeoFaker.Internet.ipv6(compressed: true)
"2001:db8::8a2e:370:7334"
```

### [`mac_address(opts \\ [])`](`NeoFaker.Internet.mac_address/1`)

```elixir
iex> NeoFaker.Internet.mac_address()
"74:4E:44:B0:D0:93"

iex> NeoFaker.Internet.mac_address(uppercase: false)
"74:4e:44:b0:d0:93"

iex> NeoFaker.Internet.mac_address(separator: "-")
"74-4E-44-B0-D0-93"
```

### [`url(opts \\ [])`](`NeoFaker.Internet.url/1`)

```elixir
iex> NeoFaker.Internet.url()
"https://example.com"

iex> NeoFaker.Internet.url(protocol: :http)
"http://neo-faker.org"

iex> NeoFaker.Internet.url(path: true)
"https://example.com/users/profile"

iex> NeoFaker.Internet.url(path: true, query: true)
"https://example.com/api/v1?key=value&id=123"
```

### [`slug(word_count \\ 3, opts \\ [])`](`NeoFaker.Internet.slug/2`)

```elixir
iex> NeoFaker.Internet.slug()
"neo-faker-elixir"

iex> NeoFaker.Internet.slug(5)
"the-quick-brown-fox-jumps"

iex> NeoFaker.Internet.slug(2, separator: "_")
"hello_world"
```

## [Lorem](`NeoFaker.Lorem`)

{: .col-2}

### [`paragraph(opts \\ [])`](`NeoFaker.Lorem.paragraph/1`)

```elixir
iex> NeoFaker.Lorem.paragraph()
"Suspendisse ac justo venenatis, tincidunt sapien nec, accumsan augue. Vestibulum urna
risus, egestas ut ultrices non, aliquet eget massa."

iex> NeoFaker.Lorem.paragraph(text: :meditations)
"Do the things external which fall upon thee distract thee? Give thyself time to learn
something new and good, and cease to be whirled around."
```

### [`sentence(opts \\ [])`](`NeoFaker.Lorem.sentence/1`)

```elixir
iex> NeoFaker.Lorem.sentence()
"Suspendisse ac justo venenatis, tincidunt sapien nec, accumsan augue."

iex> NeoFaker.Lorem.sentence(text: :meditations)
"Do the things external which fall upon thee distract thee?"
```

### [`word(opts \\ [])`](`NeoFaker.Lorem.word/1`)

```elixir
iex> NeoFaker.Lorem.word()
"suspendisse"

iex> NeoFaker.Lorem.word(text: :meditations)
"distract"
```

The plural functions return a list; join it yourself with `Enum.join/2`.

### [`paragraphs(count \\ 3, opts \\ [])`](`NeoFaker.Lorem.paragraphs/2`)

```elixir
iex> NeoFaker.Lorem.paragraphs(2)
["First paragraph...", "Second paragraph..."]
```

### [`sentences(count \\ 5, opts \\ [])`](`NeoFaker.Lorem.sentences/2`)

```elixir
iex> NeoFaker.Lorem.sentences(3)
["First sentence.", "Second sentence.", "Third sentence."]
```

### [`words(count \\ 10, opts \\ [])`](`NeoFaker.Lorem.words/2`)

```elixir
iex> NeoFaker.Lorem.words(5)
["suspendisse", "justo", "venenatis", "sapien", "accumsan"]
```

## [Number](`NeoFaker.Number`)

{: .col-2}

### [`between(min \\ 0, max \\ 100)`](`NeoFaker.Number.between/2`)

```elixir
iex> NeoFaker.Number.between()
27

iex> NeoFaker.Number.between(1, 100)
28

iex> NeoFaker.Number.between(20, 100.0)
29.481745280074264

iex> NeoFaker.Number.between(50, 50)
50
```

### [`float(left_digit \\ 10..100, right_digit \\ 10_000..100_000)`](`NeoFaker.Number.float/2`)

```elixir
iex> NeoFaker.Number.float()
30.94372

iex> NeoFaker.Number.float(1..9, 10..90)
1.44
```

### [`digit()`](`NeoFaker.Number.digit/0`)

```elixir
iex> NeoFaker.Number.digit()
5
```

### [`positive(max \\ 100)`](`NeoFaker.Number.positive/1`)

```elixir
iex> NeoFaker.Number.positive()
42

iex> NeoFaker.Number.positive(50)
27
```

### [`negative(min \\ -100)`](`NeoFaker.Number.negative/1`)

```elixir
iex> NeoFaker.Number.negative()
-42

iex> NeoFaker.Number.negative(-50)
-27
```

### [`decimal(min \\ 0.0, max \\ 100.0, precision \\ 2)`](`NeoFaker.Number.decimal/3`)

```elixir
iex> NeoFaker.Number.decimal()
42.73

iex> NeoFaker.Number.decimal(0.0, 10.0, 2)
5.47

iex> NeoFaker.Number.decimal(0.0, 1.0, 4)
0.7384
```

## [Person](`NeoFaker.Person`)

{: .col-2}

### [`first_name(opts \\ [])`](`NeoFaker.Person.first_name/1`)

```elixir
iex> NeoFaker.Person.first_name()
"Julia"

iex> NeoFaker.Person.first_name(sex: :male)
"José"

iex> NeoFaker.Person.first_name(locale: :id_id)
"Jaka"
```

### [`middle_name(opts \\ [])`](`NeoFaker.Person.middle_name/1`)

```elixir
iex> NeoFaker.Person.middle_name()
"Anne"

iex> NeoFaker.Person.middle_name(sex: :male)
"James"
```

### [`last_name(opts \\ [])`](`NeoFaker.Person.last_name/1`)

```elixir
iex> NeoFaker.Person.last_name()
"Smith"

iex> NeoFaker.Person.last_name(locale: :id_id)
"Wijaya"
```

### [`full_name(opts \\ [])`](`NeoFaker.Person.full_name/1`)

```elixir
iex> NeoFaker.Person.full_name()
"Abigail Bethany Crawford"

iex> NeoFaker.Person.full_name(sex: :male)
"Daniel Edward Fisher"

iex> NeoFaker.Person.full_name(middle_name: false)
"Gabriella Harrison"

iex> NeoFaker.Person.full_name(sex: :female, locale: :id_id, middle_name: false)
"Siti Nurhaliza"
```

### [`full_name_with_title(opts \\ [])`](`NeoFaker.Person.full_name_with_title/1`)

```elixir
iex> NeoFaker.Person.full_name_with_title(prefix: true)
"Dr. Abigail Bethany Crawford"

iex> NeoFaker.Person.full_name_with_title(suffix: true)
"Daniel Edward Fisher Jr."

iex> NeoFaker.Person.full_name_with_title(prefix: true, suffix: true, middle_name: false)
"Mr. John Smith III"
```

### [`prefix(opts \\ [])`](`NeoFaker.Person.prefix/1`)

```elixir
iex> NeoFaker.Person.prefix()
"Mr."

iex> NeoFaker.Person.prefix(locale: :id_id)
"Tn."
```

### [`suffix(opts \\ [])`](`NeoFaker.Person.suffix/1`)

```elixir
iex> NeoFaker.Person.suffix()
"Jr."

iex> NeoFaker.Person.suffix(locale: :id_id)
"S.Kom"
```

### [`gender(opts \\ [])`](`NeoFaker.Person.gender/1`)

```elixir
iex> NeoFaker.Person.gender()
"Male"

iex> NeoFaker.Person.gender(format: :short_binary)
"M"

iex> NeoFaker.Person.gender(format: :non_binary)
"Non-binary"

iex> NeoFaker.Person.gender(locale: :id_id)
"Perempuan"
```

### [`age(min \\ 0, max \\ 120)`](`NeoFaker.Person.age/2`)

```elixir
iex> NeoFaker.Person.age()
44

iex> NeoFaker.Person.age(7, 44)
27

iex> NeoFaker.Person.age(18, 65)
35
```

## [Text](`NeoFaker.Text`)

{: .col-2}

### [`character(opts \\ [])`](`NeoFaker.Text.character/1`)

```elixir
iex> NeoFaker.Text.character()
"a"

iex> NeoFaker.Text.character(type: :digit)
"0"

iex> NeoFaker.Text.character(type: :alphabet_upper)
"A"

iex> NeoFaker.Text.character(type: :alphabet)
"X"
```

### [`characters(number \\ 11, opts \\ [])`](`NeoFaker.Text.characters/2`)

```elixir
iex> NeoFaker.Text.characters()
"XfELJU1mRMg"

iex> NeoFaker.Text.characters(20, type: :alphabet_upper)
"BVAJHRGSCEVJFNYSWCJE"

iex> NeoFaker.Text.characters(5, type: :digit)
"74392"

iex> NeoFaker.Text.characters(10, type: :alphabet_lower)
"xyzabcdefg"
```

### [`emoji(opts \\ [])`](`NeoFaker.Text.emoji/1`)

```elixir
iex> NeoFaker.Text.emoji()
"✨"

iex> NeoFaker.Text.emoji(category: :activities)
"🎉"

iex> NeoFaker.Text.emoji(category: :smileys_and_emotion)
"🤖"

iex> NeoFaker.Text.emoji(category: :animals_and_nature)
"🐶"
```

### [`word()`](`NeoFaker.Text.word/0`)

```elixir
iex> NeoFaker.Text.word()
"computer"
```

### [`words(count \\ 5)`](`NeoFaker.Text.words/1`)

```elixir
iex> NeoFaker.Text.words(3)
["computer", "elixir", "phoenix"]
```

## [Time](`NeoFaker.Time`)

{: .col-2}

Every function returns a `Time` struct; pipe through `Time.to_iso8601/1` for a string.

### [`add(range \\ -24..24, opts \\ [])`](`NeoFaker.Time.add/2`)

```elixir
iex> NeoFaker.Time.add()
~T[15:22:10]

iex> NeoFaker.Time.add(-2..2, unit: :minute)
~T[07:23:10]
```

### [`between(start, finish)`](`NeoFaker.Time.between/2`)

```elixir
iex> NeoFaker.Time.between()
~T[15:22:10]

iex> NeoFaker.Time.between(~T[00:00:00], ~T[23:59:59])
~T[19:30:11]
```

### [`morning()`](`NeoFaker.Time.morning/0`)

```elixir
iex> NeoFaker.Time.morning()
~T[08:30:15]
```

### [`afternoon()`](`NeoFaker.Time.afternoon/0`)

```elixir
iex> NeoFaker.Time.afternoon()
~T[14:30:15]
```

### [`evening()`](`NeoFaker.Time.evening/0`)

```elixir
iex> NeoFaker.Time.evening()
~T[20:30:15]
```

### [`night()`](`NeoFaker.Time.night/0`)

```elixir
iex> NeoFaker.Time.night()
~T[02:30:15]
```

### [`time_zone()`](`NeoFaker.Time.time_zone/0`)

```elixir
iex> NeoFaker.Time.time_zone()
"Asia/Makassar"
```

### [`now()`](`NeoFaker.Time.now/0`)

```elixir
iex> NeoFaker.Time.now()
~T[15:22:10.123456]
```
