Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.0.0

autotrie

Um mecanismo de auto-completar para Dart/Flutter, baseado em uma implementação otimizada de Trie.

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
37,7 mil
Curtidas
42
Pontos Pub
150

Instalar pacote

flutter pub add autotrie

Visão geral do pacote

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

AutoTrie é um motor de auto-completar de alto desempenho para aplicativos Dart e Flutter, construído sobre uma estrutura de dados Trie otimizada. Ele suporta eficientemente pesquisas baseadas em prefixos, tornando-o ideal para sugestões em tempo real em campos de texto, barras de pesquisa e editores de código. O pacote foi projetado para uso mínimo de memória e consultas rápidas, garantindo experiências fluidas mesmo com grandes conjuntos de dados. AutoTrie é independente de plataforma, suportando Android, iOS, macOS, Windows e Linux. Sua natureza leve e API simples facilitam sua integração em projetos existentes.

Casos de uso

  • Sugestões de pesquisa em tempo real
  • Recursos de conclusão automática de código
  • Campos de texto com autocompletar
  • menus suspensoes dinâmicos
  • previsão de entrada

Principais recursos

  • Implementação otimizada de Trie
  • Correspondência de prefixo rápida
  • Baixo consumo de memória
  • Suporte multiplataforma
  • Integração simples da API

Indicado para

  • Desenvolvedores construindo interfaces de autocomplete
  • Aplicativos que exigem filtragem de texto rápida
  • Aplicações com foco em busca
  • Ferramentas educacionais ou de codificação
  • Componentes de entrada de alto desempenho

Considerações

  • Mais adequado para conjuntos de dados estáticos ou com atualizações infrequentes
  • Pode exigir pré-processamento para dados dinâmicos
  • Não ideal para busca de texto completo
  • Limitado à correspondência com prefixo
  • O uso de memória aumenta com o tamanho do conjunto de dados

README original

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

AutoTrie

A versatile library which solves autocompletion in Dart/Flutter. It is based around a space-efficient implementation of Trie which uses variable-length lists. With this, serving auto-suggestions is both fast and no-hassle. Suggestions are also sorted by how often they've been entered and subsorted by recency of entry, for search-engine-like results.

Read more about Trie here.

A Brief Note

It takes time, effort, and mental power to keep this package updated, useful, and improving. If you used or are using the package, I'd appreciate it if you could spare a few dollars to help me continue development.

PayPal

Usage

A usage example is provided below. Check the API Reference for detailed docs:

import 'package:autotrie/autotrie.dart';

void main() {
  // You are allowed to initialize with a starting databank by passing a `bank` parameter.
  var engine = AutoComplete(engine: SortEngine.configMulti(Duration(seconds: 1), 15, 0.5, 0.5));

  engine.enter('more'); // Enter more thrice.
  engine.enter('more');
  engine.enter('more');

  engine.enter('moody'); // Enter moody twice.
  engine.enter('moody');

  engine.enter('morose'); // Enter scattered words (with mo).
  engine.enter('morty');
  engine.enter('moment');
  engine.enter('momentum');

  engine.enter('sorose'); // Enter scattered words (without mo).
  engine.enter('sorty');

  engine.delete('morose'); // Delete morose.

  // Check if morose is deleted.
  print('Morose deletion check: ${!engine.contains('morose')}');

  // Check if engine is empty.
  print('Engine emptiness check: ${engine.isEmpty}');
 
  // They've been ranked by frequency and recency. Since they're all so similar
  // in recency, frequency takes priority.
  print("'mo' suggestions: ${engine.suggest('mo')}");
  // Result: [more, moody, momentum, moment, morty]

  // Get all entries.
  // They've *not* been sorted.
  // Use `engine.suggest('')` to get all entries sorted` 
  print('All entries: ${engine.allEntries}');
  // Result: [more, moody, sorty, sorose, momentum, moment, morty]
}

Sorting

The AutoComplete constructor takes a SortEngine, which it uses to sort the result of the autocompletion operation. There are a few different modes it can operate in:

  • SortEngine.entriesOnly() -> AutoComplete results are only sorted by number of entries in the engine (High to Low)
  • SortEngine.msOnly() -> AutoComplete results are only sorted by how much time has passed since their last entry (Low to High)
  • SortEngine.simpleMulti() ->
    • Sorted using two logistic curves, one for ms and one for entries
      • The ms curve is set to use 3 years (a LOT) as the upper end of how far back entries could have been entered
      • The entries curve is set to use 30 entries as the max amount of entries
      • These values are highly arbitrary and not likely to fit your project; this mode is not recommended unless you are just playing around.
    • Takes two weights (one for recency and one for entries) which can be used to balance how heavily each factor should affect the final sorting.
  • SortEngine.configMulti() ->
    • Sorted using two logistic curves, one for ms and one for entries
      • The ms curve is balanced using a parameter (a Duration) for the max time since entry in this engine.
      • The entries curve is balanced using a parameter (an int) for the max amount of entries in this engine.
      • If you know approximately how old and how big this AutoComplete engine is, it is highly recommended that you use this mode.
    • Takes two weights (one for recency and one for entries) which can be used to balance how heavily each factor should affect the final sorting.

Basic File Persistence

AutoComplete is natively capable of writing itself to and reading itself from a file. To do this, persist to a file using the persist method (it takes a File object): await engine.persist(myFile);

Then you can rebuild using AutoComplete.fromFile (it takes a File along with the mandatory SortEngine): var engine = AutoComplete.fromFile(file: myFile, engine: SortEngine.entriesOnly());

This persistence will preserve all the metadata (last insert, number of entries) in the table as well as the core data (the Strings themselves).

Hive Integration

  • Hive is a speedy, local, and key-value database for Dart/Flutter. Go check it out if you haven't already!
  • Hive integration is now available with autotrie:
    • Our way of integration uses extension methods.
    • Import Hive and AutoTrie, and create a normal Hive box using Hive.openBox('nameHere').
    • You can then call searchKeys(String prefix) and searchValues(String prefix) on that box to get auto-suggestions.
    • There is no sorting options: only entry-level sorting is available.

Features and bugs

Please file feature requests and bugs at the issue tracker.


This library and its contents are subject to the terms of the Mozilla Public License, v. 2.0.
© 2020 Aditya Kishore

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote