nextstage-brasil/ns-util

Metodos e classes de utilidades diversas

1.88.7 2025-10-09 21:31 UTC

Requires

• php: >=7.4
• firebase/php-jwt: ^6.10
• laravel/serializable-closure: ^1.3 || ^2
• league/flysystem: ^1.0 || ^2.0 || ^3.0
• league/flysystem-aws-s3-v3: ^1.0 || ^2.0 || ^3.0
• nelexa/zip: ^3.3 || ^4.0
• phpmailer/phpmailer: ^6.9
• predis/predis: ^2.3
• sendgrid/sendgrid: ^7 || ^8
• smottt/wideimage: ^1.1

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpunit/phpunit: *

Apache-2.0

• Nextstage

README

Em construção constante - nunca estara pronto

Testes Unitários

Para executar todos os testes unitários:

Como Executar os Testes Agora Para executar todos os testes de sessão seguros: vendor/bin/phpunit --testdox --testsuite="Session Tests" Para executar apenas o teste problemático: vendor/bin/phpunit --testdox tests/SessionNativeRedisTtlTest.php Para executar todos os testes (incluindo o problemático separadamente):

vendor/bin/phpunit --testdox --testsuite="Session Tests"
vendor/bin/phpunit --testdox tests/SessionNativeRedisTtlTest.php

# Executar todos os testes (exceto queues)
vendor/bin/phpunit --configuration phpunit.xml --filter '/^((?!QueueRunTest).)*$/'

# Executar testes específicos
vendor/bin/phpunit tests/HelperTest.php
vendor/bin/phpunit tests/LoadArgsTest.php
vendor/bin/phpunit tests/AbstractRouterTest.php

# Executar com Docker
docker exec -it <container_name> vendor/bin/phpunit --configuration phpunit.xml

Análise de Qualidade de Código

O projeto inclui análise estática de código com PHPStan integrada aos testes unitários:

# Executar PHPStan diretamente
vendor/bin/phpstan analyse

# PHPStan está integrado aos testes unitários
vendor/bin/phpunit tests/PhpStanTest.php

Estrutura do Projeto

• src/ - Código fonte principal
• tests/ - Testes unitários
• phpstan.neon - Configuração do PHPStan
• phpunit.xml - Configuração do PHPUnit

Funcionalidades Principais

• Helper: Funções utilitárias gerais
• LoadArgs: Parser de argumentos de linha de comando
• AbstractRouter: Sistema de roteamento com injeção de dependências
• Redis: Cliente Redis com retry logic
• Connection: Factories para PostgreSQL e SQLite
• Crypto: Criptografia e hash
• Date: Manipulação de datas
• Log: Sistema de logging
• Minify: Minificação de HTML, CSS e JS
• RateLimiter: Controle de taxa de requisições
• Validate: Validações diversas
• Template: Sistema de templates
• LoadCSVToArray: Carregamento de arquivos CSV
• PgLoadCSV: Carregamento de CSV para PostgreSQL

Qualidade de Código

O projeto mantém alta qualidade de código através de:

• ✅ 497 testes unitários passando
• ✅ Análise estática com PHPStan (sem erros)
• ✅ Cobertura de código abrangente
• ✅ Padrões de código consistentes
• ✅ Documentação inline

Docker

Para executar em ambiente Docker:

# Executar testes
docker exec -it <container_name> vendor/bin/phpunit --configuration phpunit.xml

# Executar PHPStan
docker exec -it <container_name> vendor/bin/phpstan analyse