README-pt_br.md

Radashi

English | Português

Diga adeus ao peso do Lodash. Pare de reinventar a roda.

Radashi (pronunciado /ruh-DAH-shee/) é uma biblioteca de utilitários para TypeScript, repleta de funções leves, legíveis, performáticas e robustas.

Radashi é um fork mantido ativamente do Radash, uma alternativa ao Lodash com o crescimento mais rápido, acumulando mais de 100 mil downloads semanais.

“O que torna o Radashi tão especial?”

• funções únicas e bem projetadas
• tree-shakeable (use apenas o que precisar!)
• livre de dependências
• focado na comunidade (sua opinião é importante)
• preparado para o futuro (escrita com sintaxe moderna ES6+)
• mantido ativamente (com uma equipe de mantenedores apaixonados em crescer)
• segurança de tipos (melhores definições de tipos possíveis)
• cobertura completa de testes
• rastreamento de performance (monitoramos regressões de performance com benchmark contínuo)
• bem documentado
• lançamentos noturnos (radashi@beta)
• changelog (veja facilmente o que há de novo em cada versão)

Se você tem usado Radash (nosso predecessor), provavelmente está interessado em saber o que nos diferencia. Leia nosso post de comparação para descobrir como estamos elevando o Radash ao próximo nível, enquanto preservamos suas melhores características.

Instalação

pnpm add radashi

yarn add radashi

npm install radashi

Versão Beta

A versão radashi@beta é um lançamento noturno contendo tudo o que está na branch principal no momento (2:00AM BRT).

pnpm add radashi@beta

Suas mudanças são documentadas aqui. Se não houver uma seção radashi@beta no changelog, significa que nenhum pull request foi mesclado desde o último lançamento estável.

JSR.io

Radashi também é publicado no JSR registry, que fornece ao Radashi sua própria página.

jsr add @radashi-org/radashi

deno add jsr:@radashi-org/radashi

FAQ

• “Preciso de XYZ, mas o Radashi não tem isso.” Se você precisar de algo que não está no nosso conjunto atual de funções, nos queremos saber. Inicie uma discussão para que possamos explorar a ideia juntos!

• O que “comunidade em primeiro lugar” significa exatamente? Significa colocar as necessidades da comunidade em primeiro lugar, tendendo a adicionar suporte para casos de uso populares, ao invés de ser estritamente minimalista. Portanto, seu feedback é muito bem-vindo e valorizamos sua perspectiva. Especificamente, queremos que você contribua com seu ponto de vista nas discussões em nossa categoria de RFCs.

• Minhas contribuições são bem-vindas? Sim! Pull requests são encorajados, mas, por favor, mantenha-os pequenos e focados. Mudanças drásticas são desencorajadas e não serão mescladas (a menos que o motivo tenha sido discutido exaustivamente).

  Por favor, revise “O ethos do Radashi” antes de enviar um pull request:

  

• Posso ajudar a manter isso? Sim! Vou adicioná-lo como colaborador no repositório. Você pode revisar pull requests e até mesmo mesclá-los. Você também pode ajudar a fechar issues. commitar diretamente na branch principal é um privilégio que você pode conquistar, assim como publicar versões no NPM.

  

• Compatibilidade retroativa é um objetivo? Sim! Queremos que a transição do radash para esta biblioteca seja suave. Se você está vindo do Radash, recomendamos instalar radashi@^12. Esta versão continuará recebendo correções mesmo após o lançamento do Radashi v13. Você pode atualizar para a versão mais recente quando estiver pronto.

• Lançamentos automáticos Para garantir que as contribuições sejam rapidamente disponibilizadas, temos os seguintes processos automáticos:

  • Lançamentos Beta Sempre que a branch main recebe uma correção ou funcionalidade, uma versão beta é automaticamente publicada no NPM às 2:00AM BRT. Instalar radashi@beta sempre buscará a versão beta mais recente. Lançamentos beta são sempre auditados pela equipe Radashi.

  • Lançamentos de Preview Quando o dono de um PR comenta /publish (e nada mais), o PR é publicado no NPM sob uma versão como 1.0.0-pr123.f7a9c3b (ou seja, <versão mais recente>-pr<número do PR>.<commit SHA>) e uma tag como pr123. Isso permite que a comunidade use as mudanças no PR sem esperar que ele seja mesclado.

    • ⚠️ Atenção: Lançamentos de Preview não são auditados pela equipe Radashi. Sempre verifique as mudanças no PR para garantir que nenhum código malicioso foi introduzido.

Contribuindo

Contribuições são bem-vindas e apreciadas! De uma olhada no guia de contribuição antes de começar: