Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.1.1

properties

Uma biblioteca simples para gerenciar arquivos de propriedades (e algo mais) no Dart

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
924 mil
Curtidas
9
Pontos Pub
140

Instalar pacote

flutter pub add properties

Visão geral do pacote

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

O pacote properties é uma biblioteca leve em Dart projetada para gerenciar arquivos de propriedades, comumente usados para configuração e localização. Ele oferece suporte à leitura, escrita e análise de pares chave-valor no formato padrão .properties, com utilitários adicionais para lidar com comentários e codificação. A biblioteca é independente de plataforma, funcionando perfeitamente em Android, iOS, macOS, Windows e Linux. É ideal para aplicações que precisam de armazenamento de configuração simples e estruturado sem dependências externas.

Casos de uso

  • Carregando configuração do aplicativo a partir de arquivos .properties
  • Gerenciando strings de localização
  • Armazenando configurações específicas do ambiente
  • Análise e gravação de dados de configuração
  • Manipulando pares chave-valor em formato de texto simples

Principais recursos

  • Suporta o formato padrão de arquivo .properties
  • Lê e escreve pares chave-valor com comentários
  • Compatibilidade multiplataforma
  • API simples para operações comuns
  • Gerencia codificação UTF-8 e terminações de linha

Indicado para

  • Aplicativos pequenos a médios que precisam de arquivos de configuração
  • Fluxos de trabalho de localização
  • Configuração baseada em ambiente
  • Projetos Dart em múltiplas plataformas
  • Desenvolvedores que preferem dependências mínimas

Considerações

  • Não adequado para configurações aninhadas complexas
  • Limitado a estrutura plana de chave-valor
  • Sem suporte de validação ou esquema embutido
  • Melhor para casos de uso simples em vez de gerenciamento em grande escala de dados

README original

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

Properties

Properties is a simple library to manage properties files (and something more) in Dart.

The project aim is to provide a simple and lightweight implementation of properties file management for Dart adding some useful but not so common features. Code and usage are very straightforward, just have a look at the Getting Started section below.

To know something more about the released version have a look at the CHANGELOG to find the version that works best for you.

Getting started

The best way to get immediately started is to have a look at the unit tests provided along with the source code.

Anyway you can go on reading this quick intro.

Using Properties you can:

  • create a new properties instance from file
Properties p = Properties.fromFile(filepath);
  • get a property out of it
String value = p.get('test.key.1');

..optionally providing a default value..

String defval = p.get('test.key.X', defval:'value X');

..or a default key..

String defkey = p.get('test.key.X', defkey:'test.key.1');
  • get an int, a double or a bool value
int anInt = p.getInt('test.key.integer');
double aDouble = p.getDouble('test.key.double');
bool aBool = p.getBool('test.key.bool');
  • get a list
List<String> list = p.getList('test.key.listofvalues');
  • add a brand new property, choosing whether to overwrite an existing entry or not
bool added = p.add('test.key.3', 'value 3', true);

and then listen to "property added" or "property updated" events

p.onAdd.listen((AddEvent e) {
        eventType = e.type;
        key = e.key;
        value = e.value;
});
  • export the content as a JSON sting, optionally choosing to export key having a given prefix and/or suffix
String jsonexport = p.toJSON([prefix, suffix]);
  • filter and extract property entries that matches custom conditions
Map<String,String> filtered = p.every((s) => s.startsWith('test'));

Running Tests

To run the tests just run the test/properties_test.dart file.

Some Limits

Output on file is not supported (yet!).

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote