crates.io

Mostra uma seleção atual de crates Rust para explorar pacotes e suas descrições.

Documentação

Resposta pública atual

Carregue uma nova resposta de crates.io; não é necessário digitar um termo.

O que a consulta retorna

Campos que merecem atenção

nome
descrição
downloads e versão

A busca devolve crates e metadados de paginação

/api/v1/crates aceita q, page e per_page. A resposta tem uma lista em crates e um objeto meta; em uma busca por serde, meta trouxe total e next_page. Use esse próximo caminho para continuar a navegação, em vez de calcular uma URL a partir de uma contagem que pode mudar entre consultas.

Mantenha q, page e per_page visíveis em filtros compartilháveis.
Use meta.next_page somente quando ele estiver presente.
Não apresente total como um resultado fixo sem registrar o contexto da busca.

Versão, downloads e descrição precisam de contexto

Um item pode trazer name, description, downloads, recent_downloads, max_version, updated_at, repository, documentation e homepage. downloads e recent_downloads são contagens de uso do registro, não uma revisão de segurança, compatibilidade ou qualidade. max_version aponta a versão máxima informada naquele instante; para avaliar uma dependência, abra a documentação e o repositório indicados pelo próprio crate.

Mostre a data junto de updated_at quando o leitor precisar de atualidade.
Não compare crates apenas por downloads.
Diferencie a página do pacote de links externos opcionais, como repository e documentation.

Use a rota do crate para aprofundar uma escolha

/api/v1/crates/{crate} retorna detalhes de um pacote e blocos como versions, keywords e categories. A rota de lista é boa para descoberta; a rota do crate é o lugar para conferir versões e classificação antes de sugerir uma dependência. Preserve o nome exato do crate na URL e trate uma resposta diferente de 200 como sinal para revisar o identificador ou a disponibilidade.

Pesquise antes de montar uma URL de detalhe para evitar nomes aproximados.
Leia as versões em vez de supor que max_version é compatível com seu projeto.
Não trate uma descrição curta como documentação de integração.