Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.2.0

xxh3

Uma implementação (port) do algoritmo de hash XXH3 do xxHash em Dart.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
784 mil
Curtidas
15
Pontos Pub
160

Instalar pacote

flutter pub add xxh3

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Uma implementação em Dart do algoritmo de hash XXH3, originalmente desenvolvido por Yann Collet. Este pacote fornece hashing de alta velocidade e seguro, adequado para aplicações que exigem verificações rápidas e confiáveis de integridade de dados. É uma tradução direta da biblioteca original xxHash, otimizada para desempenho em múltiplas plataformas. Ideal para uso em cache, checksums e cenários de deduplicação de dados, onde velocidade e baixa taxa de colisão são críticas.

Casos de uso

  • Verificação de integridade de dados
  • Sistemas de cache
  • Hashing de arquivos e fluxos
  • Somas de verificação criptográficas
  • Deduplicação rápida de dados

Principais recursos

  • Hashing de alto desempenho
  • Compatibilidade multiplataforma
  • Baixa taxa de colisão
  • API simples
  • Otimizado para velocidade

Indicado para

  • aplicações críticas de desempenho
  • Processamento de grandes volumes de dados
  • Sistemas em tempo real
  • Ambientes sensíveis à segurança
  • Aplicações que precisam de geração rápida de hash

Considerações

  • Não adequado para segurança criptográfica (por exemplo, hash de senha)
  • Não fornece criptografia
  • Melhor usado para integridade, não para confidencialidade
  • Requer manuseio cuidadoso em contextos sensíveis
  • Não recomendado para derivação de chaves criptográficas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

xxh3 (for Dart)

Pub Publisher Pub Version GitHub Workflow Status Codecov MIT License

Port of the XXH3 hashing algorithm in Dart.

Presently, only the 64-bit version of XXH3 (XXH3-64) is supported. Please feel free to open a GitHub issue if you need support for XXH3-128.

import 'dart:convert' show utf8;
import 'dart:typed_data';

import 'package:xxh3/xxh3.dart';

void main() {
  // Get the string as UTF-8 bytes.
  final helloWorldBytes = utf8.encode("Hello, world!");
  
  // Use XXH3 to hash the byte array (returns an int).
  // XXH3 is a 64-bit hash, so the value is returned in the
  // form of a 64-bit integer.
  final int digest = xxh3(helloWorldBytes);
  print(digest); // -881777603154417559
  
  // Alternatively, in version 1.1.0+, you can use the
  // xxh3String convenience method to get a hexadecimal
  // string representation of the hash.
  final String hexDigest = xxh3String(helloWorldBytes);
  print(hexDigest); // f3c34bf11915e869

  // Similarly, in version 1.2.0+, you can use the
  // stream API to process your data in blocks.
  final hashStream = xxh3Stream();
  hashStream.update(helloWorldBytes);
  print(hashStream.digest()); // -881777603154417559
  print(hashStream.digestString()); // f3c34bf11915e869
  
  // See the examples and documentation for more...
}

Refer to the Example tab for a 'quick start guide', or for more details refer to the API Documentation.

Performance

As it stands, this is a port written entirely in Dart. At the time of writing it has a throughput of ~0.29 ns/byte (3.16 GB/s) on an Apple M-series processor in JIT mode or ~0.28 ns/byte (3.23 GB/s) in AOT mode.

The streaming APIs currently have no further optimization and are therefore about 0.4-0.6ns/byte slower than the buffered APIs.

You can run the benchmarks yourself on your machine with the following commands:

# For JIT mode
dart run tool/benchmark.dart
# For AOT mode
dart compile exe tool/benchmark.dart -o benchmark
./benchmark

If better performance is needed, dart:ffi can be used to call the original C implementation. This is not currently implemented in this package, but feel free to open a ticket on GitHub if you would like this.

This assumes that the int type is a 64-bit integer, so this will likely not provide correct results for Dart web (JavaScript), where after 2^53, integers become floating point numbers. If there is demand for this, that could probably be addressed by using a custom integer type or a JavaScript Uint8Array.

WebAssembly could also be a potential workaround, but I have not investigated this yet.

Categorias

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.