Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/radashi-org/radashi

The modern, community-first TypeScript toolkit with all of the fast, readable, and minimal utility functions you need. Type-safe, dependency-free, tree-shakeable, fully tested.
https://github.com/radashi-org/radashi

functions typescript utility-library

Last synced: 13 days ago
JSON representation

The modern, community-first TypeScript toolkit with all of the fast, readable, and minimal utility functions you need. Type-safe, dependency-free, tree-shakeable, fully tested.

Host: GitHub
URL: https://github.com/radashi-org/radashi
Owner: radashi-org
License: mit
Created: 2024-06-09T01:23:51.000Z (9 months ago)
Default Branch: main
Last Pushed: 2025-02-02T09:12:10.000Z (19 days ago)
Last Synced: 2025-02-02T10:22:12.450Z (19 days ago)
Topics: functions, typescript, utility-library
Language: TypeScript
Homepage: https://radashi.js.org
Size: 3.05 MB
Stars: 415
Watchers: 4
Forks: 29
Open Issues: 41
Metadata Files:
- Readme: README-pt_br.md
- Changelog: CHANGELOG.md
- Contributing: .github/contributing.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

# 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](https://github.com/radashi-org/radashi/blob/main/CHANGELOG.md)** (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](https://radashi.js.org/blog/vs-radash) para descobrir como estamos elevando o Radash ao próximo nível, enquanto preservamos suas melhores características._

## Instalação

```sh
pnpm add radashi
```

```sh
yarn add radashi
```

```sh
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).

```sh
pnpm add radashi@beta
```

Suas mudanças são documentadas [aqui](https://github.com/radashi-org/radashi/blob/main/CHANGELOG.md#radashibeta). 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](https://jsr.io/docs/why), que fornece ao Radashi [sua própria página](https://jsr.io/@radashi-org/radashi).

```sh
jsr add @radashi-org/radashi
```

```sh
deno add @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](https://github.com/orgs/radashi-org/discussions/new?category=ideas) 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](https://github.com/orgs/radashi-org/discussions/categories/rfcs?discussions_q=is%3Aopen+category%3ARFCs) 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, `-pr.`) 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: