# `NeoFaker.Blood`
[🔗](https://github.com/muzhawir/neo_faker/blob/main/lib/neo_faker/blood.ex#L1)

Functions for generating blood types.

Provides utilities to generate random blood groups, blood types, and Rh factors following the
ABO and Rh blood group system classification.

# `all_rh_factors`
*since 0.3.1* 

```elixir
@spec all_rh_factors() :: [String.t()]
```

Returns both possible Rh factors.

## Examples

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

# `all_types`
*since 0.3.1* 

```elixir
@spec all_types() :: [String.t()]
```

Returns all 4 blood types in the ABO system.

## Examples

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

# `group`
*since 0.3.1* 

```elixir
@spec group(keyword()) :: String.t()
```

Generates a random blood group.

Combines a blood type (`A`, `B`, `AB`, or `O`) with an Rh factor (`+` or `-`).

## Options

  * `:format` (`:group`, `:type_only`, or `:rh_only`) - which part of the blood group to
    return. Defaults to `:group`.

## Examples

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

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

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

# `medical_notation`
*since 0.3.1* 

```elixir
@spec medical_notation(keyword()) :: String.t()
```

Generates a random blood type in medical notation.

Returns a descriptive string combining the ABO type and Rh factor.

## Options

  * `:verbose` (boolean) - when `true`, uses the full descriptive `"Type X, Rh Y"` form
    instead of `"X Y"`. Defaults to `false`.

## Examples

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

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

# `rh_factor`
*since 0.3.1* 

```elixir
@spec rh_factor() :: String.t()
```

Generates a random Rh factor.

Returns either `"+"` (positive) or `"-"` (negative).

## Examples

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

# `type`
*since 0.3.1* 

```elixir
@spec type() :: String.t()
```

Generates a random blood type.

Returns one of the four ABO blood types: `"A"`, `"B"`, `"AB"`, or `"O"`.

## Examples

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

---

*Consult [api-reference.md](api-reference.md) for complete listing*
