Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.0.6

fluri

Fluri é uma biblioteca de URI fluente criada para tornar a mutação de URI fácil.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
30,3 mil
Curtidas
6
Pontos Pub
140

Instalar pacote

flutter pub add fluri

Visão geral do pacote

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

Fluri é uma biblioteca de URI fluente projetada para simplificar a manipulação de URIs em aplicativos Dart e Flutter. Oferece uma API intuitiva e encadeável para criar, modificar e analisar URIs com facilidade. Os desenvolvedores podem anexar caminhos, parâmetros de consulta e fragmentos de forma transparente, mantendo um código limpo e legível. Desenvolvido pela Workiva, o Fluri suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, tornando-o ideal para projetos multiplataforma que exigem um manuseio robusto de URLs.

Casos de uso

  • Criando pontos de extremidade de API dinâmicos
  • Análise e modificação de URLs em tempo de execução
  • Construindo strings de consulta complexas
  • Manipulação de URIs relativas e absolutas
  • Testando clientes HTTP com URLs variadas
  • Gerenciando rotas de navegação com parâmetros

Principais recursos

  • API fluida e encadeável
  • Suporte para mutação de parâmetro de consulta
  • Manipulação fácil de caminho e fragmento
  • Compatibilidade multiplataforma
  • Construção de URI imutável
  • Análise e serialização robustas

Indicado para

  • Desenvolvedores Flutter que precisam de manipulação flexível de URI
  • clientes de API que exigem geração dinâmica de endpoint
  • Aplicativos com roteamento complexo ou link profundo
  • Equipes que priorizam uma lógica de URL limpa e sustentável
  • Projetos direcionados para múltiplas plataformas

Considerações

  • Não destinado à análise de URL de baixo nível
  • Requer compreensão da estrutura URI
  • Pode adicionar sobrecarga para URLs estáticas simples
  • Limitado a operações específicas de URI
  • Melhor usado em conjunto com clientes HTTP como dio ou http

README original

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

fluri

Pub Build Status documentation

Examples/Usage

Fluri is a fluent URI library for Dart built to make URI mutation easy.

The dart:core.Uri class provides an immutable representation of URIs, which makes it difficult to incrementally build them or update them at a later time. If you wanted to build a long URI from the individual pieces, you would do something like this:

var uri = Uri(
  scheme: 'https',
  host: 'example.com',
  path: 'path/to/resource'
);

If you later wanted to update the path and add a query parameter, you'd have to do this:

uri = uri.replace(
  path: 'new/path',
  query: 'foo=true'
);

Now let's say you want update the query without losing what you already have:

var query = Map.from(uri.queryParameters);
query['bar'] = '10';
uri = uri.replace(queryParameters: query);

As you can see, incremental or fluent-style URI mutations become a hassle with the core Uri class.

With fluri, the above interactions are easy:

import 'package:fluri/fluri.dart';

var fluri = Fluri()
  ..scheme = 'https'
  ..host = 'example.com'
  ..path = 'path/to/resource';

fluri
  ..path = 'new/path'
  ..query = 'foo=true';

fluri.updateQuery({'bar': '10'});

Additional methods like appendToPath and setQueryParam make it easy to build on top of a base URL:

import 'package:fluri/fluri.dart';

var base = Fluri('https://example.com/base/');

var fluri = Fluri.from(base)
  ..appendToPath('path/to/resource')
  ..setQueryParam('count', '10');

Fluri also supports multi-value parameters. To access the query parameters as Map<String, List<String>>, use queryParametersAll (just like the Uri class):

var fluri = Fluri('/resource?format=json&format=text');
print(fluri.queryParameters); // {'format': 'text'}
print(fluri.queryParametersAll); // {'format': ['json', 'text']}

To set a single query parameter to multiple values:

var fluri = Fluri('/resource');
fluri.setQueryParam('format', ['json', 'text']);
print(fluri.queryParametersAll); // {'format': ['json', 'text']}

Using setQueryParam will always replace existing values:

var fluri = Fluri('/resource');
fluri.setQueryParam('format', ['json', 'text']);
fluri.setQueryParam('format', ['binary', 'text']);
print(fluri.queryParametersAll); // {'format': ['binary', 'text']}

You can use the queryParametersAll setter to set the entire query with multi-value param support:

var fluri = Fluri('/resource');
fluri.queryParametersAll = {'format': ['json', 'text'], 'count': ['5']}
print(fluri.queryParametersAll); // {'format': ['json', 'text'], 'count': ['5']}

Again, if you need to preserve existing query parameters, you can use the updateQuery method to do so. Set mergeValues: true and any values that you provide will be merged with existing values:

var fluri = Fluri('/resource?format=json');
fluri.updateQuery({'format': ['binary', 'text'], 'count': '5'}, mergeValues: true);
print(fluri.queryParametersAll); // {'format': ['binary', 'json', 'text'], 'count': ['5']}

Categorias

Repositório-fonte

Projetos que usam este pacote