Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.0.0

bible

Um aplicativo simples para interagir com múltiplas APIs da Bíblia de um único local

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
101
Curtidas
21
Pontos Pub
130

Instalar pacote

flutter pub add bible

Visão geral do pacote

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

O pacote Bible é uma biblioteca Flutter/Dart que fornece acesso unificado a múltiplas APIs de Bíblia por meio de uma única interface. Simplifica a integração com várias fontes de dados bíblicos, permitindo que desenvolvedores recuperem passagens bíblicas, pesquisem textos e obtenham metadados de forma eficiente. Projetado para uso em múltiplas plataformas, suporta Android, iOS, Web, macOS, Windows e Linux. O pacote abstrai as diferenças das APIs, oferecendo métodos consistentes para consultar conteúdo bíblico, tornando-o ideal para aplicativos baseados na fé, ferramentas de estudo ou plataformas devocionais. Com configuração mínima via `flutter pub add bible`, os desenvolvedores podem incorporar rapidamente conteúdo bíblico rico em seus aplicativos.

Casos de uso

  • aplicativos de leitura da Bíblia
  • Ferramentas de referência bíblica
  • Aplicativos de devoção e oração
  • Plataformas de educação religiosa
  • Integrações de Bíblia multiplataforma

Principais recursos

  • Interface de API unificada
  • Suporte para várias fontes bíblicas
  • Compatibilidade multiplataforma
  • Instalação simples por meio do pub
  • Métodos consistentes de recuperação de dados
  • Leve e fácil de integrar

Indicado para

  • Desenvolvedores construindo aplicativos religiosos
  • Criadores de software educacional
  • Equipes de aplicativos móveis e web
  • colaboradores de projetos de código aberto
  • Aplicativos que exigem dados bíblicos

Considerações

  • Depende de APIs externas da Bíblia
  • Pode exigir o tratamento de limites de taxa
  • A consistência do formato de dados varia conforme a fonte
  • Limitado à recuperação de textos sagrados baseados em texto
  • Sem mecanismo de cache integrado
  • Requer conexão com a internet para dados

README original

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

bible

This package provides a simple interface for interacting with different bible APIs.

Usage

This package currently only supports querying these APIs:

Name Requires API key notes
esvapi yes
getbible no Does not support verse references that cross chapters. Genesis 2-3 ✅ Gensis 2:1 - 3:5 ❌
bibleorg no
bibleapi no

Simple example:

import 'package:bible/bible.dart' as Bible;
...
var passage = await Bible.queryPassage('John 3:16'); // Will default to the GetBible API
print(passage.passage) // The text from the query

An example requiring an API key:

Bible.addKeys({'esvapi': 'APITOKEN'});
var passage = await Bible.queryPassage('John 3:16', providerName:'esvapi');

You can also pass the API key as an optional parameter:

Bible.addKeys({'esvapi': 'APITOKEN'});
var passage = await Bible.queryPassage('John 3:16', key: 'APITOKEN');

You can also pass query parameters through a map. See specific API documentation for those parameters.

Bible.addKeys({'esvapi': 'APITOKEN'});
var passage = await Bible.queryPassage('John 3:16', key: 'APITOKEN', parameters: {'Map': 'of params'});

You can specify the version or provider with optional parameters.

var passage = await Bible.queryPassage('John 3:16', providerName: 'getbible', version: 'asv');

**Note:**The providerName coresponds to that in the table at the beginning of this documentation.

Every time a passage is queried, the reference_parser library tries to parse the query (i.e mispelling will automatically be corrected, shortened verse forms will be allowed). To prevent this just pass false to the useParser parameter.

var passage = await Bible.queryPassage('John 3:16', useParser: false);

If you import the providers library you can use can directly query every the providers or pass them to the queryPassage function as an optional parameter

import 'package:bible/bible.dart' as Bible;
import 'package:bible/providers.dart';
//...
var prov = GetBible();
var passage = await Bible.queryPassage('John 3:16', provider: prov);

This is the same as using the providerName parameter but if you were to create your own provider you could pass it to the function.

Note: If you create your own provider please consider contributing it back to the repository :).

Contributing

Implementing an API isn't hard, so I'm open to having people implementing and sending pull requests for different bible APIs. This is a great first issue and doesn't require extensive dart knowledge, just copy a provider already created and go from there!

APIs that need implementing:

Name Difficulty
nltapi easy
bibliaapi moderate
scriptureapi hard

For more specific information look at the contributing guidlines.

Categorias

Dependências

Lista de dependências 2 itens

  • http^0.13.3
  • reference_parser^3.0.0

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.