# 🦀 Mi Primera Lib - Rust Math & Text Utilities

A lightweight Rust library providing essential mathematical operations and text utilities with zero dependencies.

## 🚀 Features

✅ **Math Operations**: Addition, subtraction, multiplication, division with overflow handling  
✅ **Text Utilities**: String reversal and word counting  
✅ **Zero Dependencies**: Pure Rust implementation  
✅ **Comprehensive Testing**: Full test coverage  
✅ **Modular Design**: Clean, organized code structure  

## 📖 Usage

```rust
use mi_primera_lib::calc1::{add, sub};
use mi_primera_lib::calc2::{multiply, rate};

// Math operations
let sum = add(10, 20);           // 30
let diff = sub(20, 10);          // 10
let product = multiply(4, 5);    // 20
let quotient = rate(10, 2);      // 5

// Overflow handling
let overflow = add(u32::MAX, 1); // 0 (wrapping)
let safe_sub = sub(5, 10);       // 0 (no negative u32)
```

## 🛠️ Installation

```bash
cargo add mi_primera_lib
```

Or add to your `Cargo.toml`:

```toml
[dependencies]
mi_primera_lib = "0.1.0"
```

## 🔧 Development

```bash
# Build
cargo build

# Test
cargo test

# Documentation
cargo doc --open

# Lint
cargo clippy
```

## 📚 Documentation

- **Crates.io**: [mi_primera_lib](https://crates.io/crates/mi_primera_lib)
- **Docs.rs**: [docs.rs/mi_primera_lib](https://docs.rs/mi_primera_lib)
- **Repository**: [github.com/JennyT3/mi_primera_lib](https://github.com/JennyT3/mi_primera_lib)

## 🙏 Acknowledgments

Special thanks to:
- **Nearx** for the incredible learning experience
- **Lucas Bispo de Oliveira** for mentorship and guidance
- **#HackMeridian2025** community for inspiration and support

---

*Built with ❤️ and Rust*
