AzuxirenLeadGuy / Aionian-Project

This project contains a library that can utilize Bible Resources distributed by Aionian, and apps utilizing the said library

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Aionian Bible

This library and tool is a small attempt to bring Aionian Bible to the dotnet

Aionian Library

Aionian Library contains simplistic features to consume the bible resources. As of now, the following is provided

The BibleLink struct which defines the bible link as provided in http://resources.aionianbible.org/, The Bible struct which contains all the content of bible using nested Dictionaries, and BibleBook enum which has all the books of the bible defined within it.

Provided with these are static utility methods, most importantly for getting all links from the website (link given above) and a method for deserializing the Bible struct from downloaded link

var links = BibleLink.GetAllUrlsFromWebsite();//Gets all download links available from the website
BibleLink mylink = links[0].Link; //Taking the first link
var stream = mylink.DownloadStream();//Downloads the stream of the bible database
var bible = Bible.ExtractBible(stream);//Now the bible is ready to use
									   
//Alternatively, you can also use the following:

var AnotherBible = Bible.ExtractBible(mylink.DownloadStream());//One line 
string verse = AnotherBible[BibleBook.John, 3, 16];

By using a stream, there is an additional option of downloading the file by the URL in the BibleLink object and opening it via a Stream to load the Bible. There is now also an Async method for downloading the bible with events that are fired on the update on progress.

The bible struct can also be serialized in Json using System.Text.Jsonpackage.

You can add this package from Nuget

Aionian Tool

This is a basic terminal application (dotnet tool) to showcase the Aionian Library. It features the following:

  1. Bible reading
  2. Bible word search
  3. Download/Manage any Aionian bible package

You can install it from Nuget

Pending work and Contributing

These are some of the major tasks that are to be done

  • Working on a cross-platform Aionian app (preferrably on the Uno platform)
  • Improving the Cross-refernces support
  • Populating the unit tests (using package Microsoft.NET.Test.Sdk) for the existing Aionian and AionianApp.Core projects.
  • Creating wrappers for other language
  • Creating a helpful wiki and/or Github page
  • Any bug-fixes
  • Typos and grammatical mistakes
  • Raising an Issue for any existing bug, or a feature/idea

Help/feedback on any aspect of the project is always welcome.

Release Notes:

Building

Building the projects requires dotnet-sdk, available for download from Microsoft's dotnet-sdk official site. It is recommended to use the latest stable version of dotnet. The currently recommended version is dotnet-sdk-6

To generate executable of the terminal tool, run the following command

dotnet publish "path/to/Terminal.csproj" -f=net6.0 -c Release -o "path/of/output/files"

Running

To build and run the Terminal Tool, use the script dotnet run -f=net5.0 for the Terminal.csproj Project file.

Packing

Packing both the projects into .nupkg files

At the project's root folder, where Aionian.sln is located, use the script

dotnet build -c Release

to begin packing. The nuget files are generated in the folder Nuget. You can use the packages to add dependancy to your project, or install the terminal tool using dotnet tool

License/Copyright

Both the projects in these repositories are under Creative Commons Attribution-No Derivatives 4.0.

About

This project contains a library that can utilize Bible Resources distributed by Aionian, and apps utilizing the said library

License:Other


Languages

Language:C# 100.0%