# Número por Extenso

Biblioteca Rust para conversão por extenso de valores numéricos.

[![Crates.io](https://img.shields.io/crates/v/numero-por-extenso)](https://crates.io/crates/numero-por-extenso) • [![Crates.io](https://img.shields.io/crates/l/numero-por-extenso)](https://github.com/andrelmlins/numero-por-extenso/blob/master/LICENSE) • [![Build Status](https://travis-ci.com/andrelmlins/numero-por-extenso.svg?branch=master)](https://travis-ci.com/andrelmlins/numero-por-extenso)

## Instalação

Adicione isso no seu `Cargo.toml`:

```toml
[dependencies]
numero-por-extenso = "0.1.0"
```

## Uso básico

Abaixo uma forma simples de como utilizar essa biblioteca:

```rust
extern crate numero_por_extenso;

use numero_por_extenso::por_extenso;
use numero_por_extenso::TipoExtenso;

println!("numero por extenso: {}", por_extenso(123456, TipoExtenso::DECIMAL));
// cento e vinte e três mil, quatrocentos e cinquenta e seis

println!("numero por extenso: {}", por_extenso(1234.56, TipoExtenso::MONETARIO));
// mil, duzentos e trinta e quatro reais e cinquenta e seis centavos

println!("numero por extenso: {}", por_extenso(23, TipoExtenso::PORCENTAGEM));
// vinte e três por cento
```

## Licença

Numero por Extenso é um software Open Source [licenciado pelo MIT](https://github.com/andrelmlins/numero-por-extenso/blob/master/LICENSE).