Pakete, Repositories und App-Kategorien suchen

Paketdetailsv1.0.0

bible

Eine einfache Anwendung, um mit mehreren Bibel-APIs an einem einzigen Ort zu interagieren

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
101
Likes
21
Pub-Punkte
130

Paket installieren

flutter pub add bible

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das Bible-Paket ist eine Flutter/Dart-Bibliothek, die über eine einzige Schnittstelle einen einheitlichen Zugriff auf mehrere Bibel-APIs bietet. Es vereinfacht die Integration mit verschiedenen Bibeldatenquellen und ermöglicht Entwicklern die effiziente Abfrage von Bibelstellen, die Suche nach Texten und die Abrufung von Metadaten. Für den plattformübergreifenden Einsatz konzipiert, unterstützt es Android, iOS, Web, macOS, Windows und Linux. Das Paket abstrahiert Unterschiede zwischen APIs und bietet konsistente Methoden zum Abfragen von Bibelinhalt – ideal für gläubigkeitsbasierte Apps, Lernwerkzeuge oder devotio­nale Plattformen. Mit minimalem Setup über `flutter pub add bible` können Entwickler reichhaltigen biblischen Inhalt schnell in ihre Anwendungen integrieren.

Anwendungsfälle

  • Bibel-Leseprogramme
  • Bibelzitat-Tools
  • Andachts- und Gebets-Apps
  • Religiöse Bildungsplattformen
  • Plattformübergreifende Bibelintegrationen

Hauptmerkmale

  • Einheitliche API-Schnittstelle
  • Unterstützung für mehrere Bibelquellen
  • Plattformübergreifende Kompatibilität
  • Einfache Installation über pub
  • Konsistente Methoden zur Datenabrufung
  • Leicht und einfach zu integrieren

Geeignet für

  • Entwickler, die religiöse Apps erstellen
  • Entwickler von Bildungssoftware
  • Mobil- und Webanwendungsteams
  • Open-Source-Projektmitarbeiter
  • Apps, die biblische Daten erfordern

Hinweise

  • Abhängig von externen Bibel-APIs
  • Kann die Behandlung von Rate-Limits erfordern
  • Die Datenformatkonsistenz variiert je nach Quelle
  • Beschränkt auf textbasierte Bibelstellenabfrage
  • Kein integrierter Caching-Mechanismus
  • Benötigt Internetverbindung für Daten

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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.

Kategorien

Abhängigkeiten

Abhängigkeiten 2 Einträge

  • http^0.13.3
  • reference_parser^3.0.0

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.