OPDS Support (#526)

* Added some basic OPDS implementation

* Fixed an issue with feed href

* More changes

* Added library routes and moved user code to a method so we can hack in fixed code without authentication

* Images now load on the OPDS reusing our existing Image infrastructure.

* Added the ability to download and moved some download code to a dedicated service

* Download is working, pagination is implemented.

* Refactored libraries to use pagination

* Laid foundation for OpenSearch implementation

* Fixed up some serialization issues and some old code that wasn't referencing helper methods

* Ensure chapters are sorted when we send them over OPDS

* OpenSearch implemented

* Removed any support for OPDS-PS due to lack of apps supporting it.

* Don't distribute development.json nor stats directory on build.

* Implemented In Progress feed as well.

* Ability to enable OPDS for server. OPDS now accepts initial call as POST in case app uses username/password.

* UI now properly renders state for OPDS enablement. Added Collections routes.

* Fixed pagination startIndex on OPDS feeds when there is less than 1 page.

* Chunky Reader now works. It only accepts UTF-8 encodings

* More Chunky fixes

* More chunky changes, such a fussy client.

* Implemented the ability to have a custom api key assigned to a user and use that api key as your authentication token against OPDS routing.

* Implemented the ability to reset your API Key

* Fixed favicon not being sent back correctly

* Fixed an issue where images wouldn't send on OPDS feed.

* Implemented Page streaming and fixed a pagination bug

* Hooked in the ability to save progress in Kavita when Page Streaming

API/Services/DirectoryService.cs

@@ -432,5 +432,60 @@ namespace API.Services
                }
            }
        }
+
+        /// <summary>
+        /// Returns the human-readable file size for an arbitrary, 64-bit file size
+        /// <remarks>The default format is "0.## XB", e.g. "4.2 KB" or "1.43 GB"</remarks>
+        /// </summary>
+        /// https://www.somacon.com/p576.php
+        /// <param name="bytes"></param>
+        /// <returns></returns>
+       public static string GetHumanReadableBytes(long bytes)
+       {
+           // Get absolute value
+           var absoluteBytes = (bytes < 0 ? -bytes : bytes);
+           // Determine the suffix and readable value
+           string suffix;
+           double readable;
+           switch (absoluteBytes)
+           {
+               // Exabyte
+               case >= 0x1000000000000000:
+                   suffix = "EB";
+                   readable = (bytes >> 50);
+                   break;
+               // Petabyte
+               case >= 0x4000000000000:
+                   suffix = "PB";
+                   readable = (bytes >> 40);
+                   break;
+               // Terabyte
+               case >= 0x10000000000:
+                   suffix = "TB";
+                   readable = (bytes >> 30);
+                   break;
+               // Gigabyte
+               case >= 0x40000000:
+                   suffix = "GB";
+                   readable = (bytes >> 20);
+                   break;
+               // Megabyte
+               case >= 0x100000:
+                   suffix = "MB";
+                   readable = (bytes >> 10);
+                   break;
+               // Kilobyte
+               case >= 0x400:
+                   suffix = "KB";
+                   readable = bytes;
+                   break;
+               default:
+                   return bytes.ToString("0 B"); // Byte
+           }
+           // Divide by 1024 to get fractional value
+           readable = (readable / 1024);
+           // Return formatted number with suffix
+           return readable.ToString("0.## ") + suffix;
+       }
     }
 }