Calculator Catitodev 🦀

Uma biblioteca simples e eficiente para operações matemáticas básicas em Rust.

🚀 Funcionalidades

• ➕ Soma: Operações de adição com números inteiros
• ➖ Subtração: Operações de subtração com números inteiros
• ✖️ Multiplicação: Operações de multiplicação com números inteiros
• ➗ Divisão: Operações de divisão com números de ponto flutuante e tratamento de erro para divisão por zero

📦 Instalação

Adicione esta linha ao seu Cargo.toml:

[dependencies]
calculator-catitodev = "0.1.0"

Ou use o comando:
bashcargo add calculator-catitodev
🔧 Como usar
Exemplo básico:
rustuse calculator_catitodev::{somar, subtrair, multiplicar, dividir};

fn main() {
    // Operações com inteiros
    println!("2 + 3 = {}", somar(2, 3));           // 5
    println!("10 - 4 = {}", subtrair(10, 4));      // 6
    println!("6 × 7 = {}", multiplicar(6, 7));     // 42
    
    // Divisão com tratamento de erro
    match dividir(15.0, 3.0) {
        Ok(resultado) => println!("15 ÷ 3 = {}", resultado), // 5.0
        Err(erro) => println!("Erro: {}", erro),
    }
    
    // Exemplo de divisão por zero
    match dividir(10.0, 0.0) {
        Ok(resultado) => println!("10 ÷ 0 = {}", resultado),
        Err(erro) => println!("Erro: {}", erro), // "Divisão por zero não é permitida"
    }
}
📚 API Reference
somar(a: i32, b: i32) -> i32
Realiza a soma de dois números inteiros.
Exemplo:
rustlet resultado = somar(5, 3); // 8
subtrair(a: i32, b: i32) -> i32
Realiza a subtração de dois números inteiros.
Exemplo:
rustlet resultado = subtrair(10, 4); // 6
multiplicar(a: i32, b: i32) -> i32
Realiza a multiplicação de dois números inteiros.
Exemplo:
rustlet resultado = multiplicar(6, 7); // 42
dividir(a: f64, b: f64) -> Result<f64, String>
Realiza a divisão de dois números de ponto flutuante com tratamento de erro.
Retorna:

Ok(resultado) - Se a divisão for bem-sucedida
Err(mensagem) - Se tentar dividir por zero

Exemplo:
rustmatch dividir(15.0, 3.0) {
    Ok(resultado) => println!("Resultado: {}", resultado),
    Err(erro) => println!("Erro: {}", erro),
}

🧪 Executar testes
bashcargo test
A biblioteca inclui testes abrangentes para todas as funcionalidades:

Testes com números positivos e negativos
Testes com zero
Testes de divisão por zero
Testes de casos extremos

🏗️ Desenvolvimento
Clonar o repositório:
bashgit clone https://github.com/catitodev/calculator-rust.git
cd calculator-rust
Executar testes:
bashcargo test
Executar exemplo:
bashcargo run
📋 Requisitos

Rust 1.56.0 ou superior
Edition 2021

🤝 Contribuindo
Contribuições são sempre bem-vindas! Por favor:

Faça um fork do projeto
Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
Commit suas mudanças (git commit -m 'Add some AmazingFeature')
Push para a branch (git push origin feature/AmazingFeature)
Abra um Pull Request

📜 Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
👨‍💻 Autor
catitodev

GitHub: @catitodev
Crates.io: calculator-catitodev

📈 Versões

0.1.0 - Versão inicial com operações básicas de calculadora


Feito com ❤️ em Rust 🦀