Download the PHP package inovanti-bank/inovanti-toolkit without Composer

🛠️ Inovanti Toolkit

Biblioteca de utilitários para Laravel 11

O Inovanti Toolkit é um componente projetado para simplificar tarefas comuns em aplicações Laravel 11. Ele fornece um conjunto de helpers reutilizáveis para formatação, validação e manipulação de strings, números, datas, arrays, e muito mais.

📌 Índice

1. 🚀 Instalação
2. ⚙️ Configuração
3. 📩 Uso
   • Manipulação de Strings
   • Manipulação de Números
   • Manipulação de Datas
   • Formatação de Dados
   • Validação de Documentos
   • Conversão de Unidades
4. 🧪 Testes
5. 🤝 Contribuindo
6. 📜 Licença

🚀 Instalação

O pacote pode ser instalado via Composer:

⚙️ Configuração

Atualmente, não há configuração obrigatória. No entanto, o pacote se integra automaticamente ao Laravel via ToolkitServiceProvider.

📩 Uso

🔠 Manipulação de Strings (StringHelper)

📌 Métodos Disponíveis

• formatName(string $name, bool $abbreviate = false, bool $firstAndLast = false): string
• limitString(string $text, int $limit, string $suffix = '...'): string
• removeAccents(string $text): string
• onlyNumbers(string $text): string
• isPalindrome(string $text): bool

✅ Exemplo de Uso

🔢 Manipulação de Números (NumberHelper)

📌 Métodos Disponíveis

• formatCurrency(float $amount, string $prefix = 'R$'): string
• padZero(int $number, int $length): string
• numberToWords(float $value, bool $isCurrency = true): string
• formatPercentage(float $value, int $decimals = 2): string

✅ Exemplo de Uso

📅 Manipulação de Datas (DateHelper)

📌 Métodos Disponíveis

• formatDate(string $date, string $formatFrom = 'Y-m-d', string $formatTo = 'd/m/Y'): string
• addBusinessDays(string $date, int $days): string

✅ Exemplo de Uso

📑 Formatação de Dados (FormatterHelper)

📌 Métodos Disponíveis

• formatCpfCnpj(string $number): string
• formatDateHuman(string $date): string
• formatDateShortHuman(string $date): string
• formatDateTimeHuman(string $date): string
• formatDateRelative(string $date): string
• formatDateWeekday(string $date): string
• formatDateCustom(string $date, string $format): string

✅ Exemplo de Uso

✅ Validação de Documentos (ValidatorHelper)

📌 Métodos Disponíveis

• isValidCPF(string $cpf): bool
• isValidCNPJ(string $cnpj): bool
• isValidPIS(string $pis): bool
• isValidTitle(string $title): bool
• isValidRENAVAM(string $renavam): bool
• isValidCNH(string $cnh): bool
• isValidEmail(string $email): bool
• isValidDate(string $date, string $format = 'Y-m-d'): bool
• isValidCEP(string $cep): bool
• isValidCreditCard(string $number): bool

✅ Exemplo de Uso

🧮 Conversão de Unidades (UnitConverter)

📌 Métodos Disponíveis

• bytesToHumanReadable(int $bytes, int $precision = 2): string

✅ Exemplo de Uso

🧪 Testes

O pacote inclui testes unitários para garantir que todas as funcionalidades funcionem conforme o esperado.

Para testes unit:

🤝 Contribuindo

Contribuições são bem-vindas! Se você deseja reportar um bug, solicitar um novo recurso ou contribuir com código, fique à vontade para abrir uma issue ou enviar um Pull Request.

1. Faça um Fork do projeto
2. Crie sua feature branch: git checkout -b minha-nova-feature
3. Commit suas mudanças: git commit -m 'Adiciona nova feature'
4. Faça o push para a branch: git push origin minha-nova-feature
5. Crie um novo Pull Request

📜 Licença

Este projeto está licenciado sob a MIT license. Sinta-se livre para usá-lo e modificá-lo conforme necessário.

💡 Dúvidas ou sugestões? Abra uma issue. 🚀