wideholy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5e1eeabe5d87f51d1a6b7e9ba708f2dd03cb484d7649cf7e278e27fda65ece35
+  data.tar.gz: f1f2ccaf8cd30f6573fc246edace4ad5e5540374aed2bc29e45ec0c87702b07d
+SHA512:
+  metadata.gz: 79cf6ac1fb33e538a22350d6ac0afacb5bf741f77536bae52d22554ba8ac48bc1aea710148297caba383098c8dd48b0f081fefd3f97aaf91c70eba5efaec4dca
+  data.tar.gz: ef04078ac338c50ac3e567d0a66b385dd6586f7576a5d5d5637f9aa55c05b7bc0065ff5129ca4affbef5d1d3ad8e354ca9dee5a280b862b76c7c1e0dad67c1b8

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WideHoly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,224 @@
+# wideholy
+
+[![Gem Version](https://badge.fury.io/rb/wideholy.svg)](https://rubygems.org/gems/wideholy)
+[![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%203.0-red)](https://www.ruby-lang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://rubygems.org/gems/wideholy)
+
+Ruby client for the [WideHoly](https://wideholy.com) hub API. Cross-religion scripture search and comparison across 5 world religions -- Bible, Quran, Torah, Bhagavad Gita, and Buddhist Sutras. Features verse of the day, random verse, side-by-side verse comparison, search suggestions, topic verses, religious calendar events, and commentary lookup. Zero runtime dependencies -- uses only Ruby stdlib (`net/http`, `json`, `uri`).
+
+WideHoly is the unified hub connecting 5 scripture platforms into a single cross-religion search and comparison engine, enabling interfaith study and thematic exploration across traditions.
+
+> **Explore world scriptures at [wideholy.com](https://wideholy.com)** -- [Bible](https://widebible.com), [Quran](https://widequran.com), [Torah](https://widetorah.com), [Gita](https://widegita.com), [Sutra](https://widesutra.com)
+
+## Table of Contents
+
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [What You Can Do](#what-you-can-do)
+  - [Get Verse of the Day](#get-verse-of-the-day)
+  - [Get a Random Verse](#get-a-random-verse)
+  - [Compare Verses Across Religions](#compare-verses-across-religions)
+  - [Search Across All Scriptures](#search-across-all-scriptures)
+  - [Explore Topics Across Religions](#explore-topics-across-religions)
+  - [Browse Religious Calendar](#browse-religious-calendar)
+  - [Read Commentary](#read-commentary)
+- [API Reference](#api-reference)
+- [Supported Religions](#supported-religions)
+- [Learn More About World Scriptures](#learn-more-about-world-scriptures)
+- [WideHoly Scripture Family](#wideholy-scripture-family)
+- [Also Available](#also-available)
+- [License](#license)
+
+## Install
+
+```bash
+gem install wideholy
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "wideholy"
+```
+
+## Quick Start
+
+```ruby
+require "wideholy"
+
+# Create a client (zero configuration needed)
+client = WideHoly::Client.new
+
+# Get today's verse of the day from the Bible
+votd = client.verse_of_the_day("bible")
+puts votd["text"]
+
+# Compare verses across religions
+result = client.compare("bible:genesis.1.1", "quran:al-fatihah.1")
+puts result["verse_a"]["text"]
+puts result["verse_b"]["text"]
+
+# Search across all scriptures
+suggestions = client.search_suggest("love")
+suggestions["suggestions"].each { |s| puts "#{s["religion"]}: #{s["text"]}" }
+```
+
+## What You Can Do
+
+### Get Verse of the Day
+
+A curated daily verse from any of the 5 supported religions. Deterministic per religion per date -- the same verse is returned for the same religion and date combination.
+
+```ruby
+# Bible verse of the day
+votd = client.verse_of_the_day("bible")
+puts votd["reference"]  # => "John 3:16"
+puts votd["text"]
+
+# Quran verse of the day
+votd = client.verse_of_the_day("quran")
+
+# Get a specific date's verse
+votd = client.verse_of_the_day("torah", date: "2026-03-24")
+```
+
+### Get a Random Verse
+
+A randomly selected verse from any or all religions -- useful for daily inspiration or interfaith discovery.
+
+```ruby
+# Random verse from any religion
+verse = client.random_verse
+puts "#{verse["religion"]}: #{verse["text"]}"
+
+# Random verse from a specific religion
+verse = client.random_verse(religion: "gita")
+```
+
+### Compare Verses Across Religions
+
+Side-by-side comparison of two verses -- from the same scripture or across different religions. Use the `religion:reference` format for cross-religion references.
+
+```ruby
+# Cross-religion comparison: Genesis 1:1 vs Al-Fatihah 1
+result = client.compare("bible:genesis.1.1", "quran:al-fatihah.1")
+puts result["verse_a"]["text"]
+puts result["verse_b"]["text"]
+puts result["same_religion"]  # => false
+
+# Same-religion comparison
+result = client.compare("bible:genesis.1.1", "bible:john.1.1")
+```
+
+### Search Across All Scriptures
+
+Autocomplete suggestions that span all 5 religions -- returning matching topics, people, and glossary terms.
+
+```ruby
+# Search suggestions across all religions
+suggestions = client.search_suggest("creation")
+suggestions["suggestions"].each do |s|
+  puts "#{s["type"]} (#{s["religion"]}): #{s["text"]}"
+end
+
+# Filter to a specific religion
+suggestions = client.search_suggest("mercy", religion: "quran")
+```
+
+### Explore Topics Across Religions
+
+Universal spiritual themes -- love, creation, prayer, compassion, justice -- with relevant verses from each religion that addresses the topic.
+
+```ruby
+# Get verses about "love" from all religions
+love = client.topic_verses("love")
+puts "Found in #{love["religions_found"]} religions"
+
+# Cross-religion analysis of a theme
+creation = client.cross_religion("creation")
+creation["religions"].each do |r|
+  puts "#{r["religion"]}: #{r["summary"]}"
+end
+```
+
+### Browse Religious Calendar
+
+Religious holidays and observances across traditions -- Easter, Ramadan, Passover, Diwali, Vesak -- with dates and descriptions.
+
+```ruby
+# Get all religious events for March 2026
+events = client.calendar(year: 2026, month: 3)
+events["events"].each do |e|
+  puts "#{e["date"]}: #{e["name"]} (#{e["religion"]})"
+end
+
+# Filter to a specific religion
+islamic = client.calendar(religion: "quran", year: 2026)
+```
+
+### Read Commentary
+
+Scholarly commentary for verses across traditions -- Quran tafsir (Ibn Kathir), Torah commentary (Rashi), and Gita commentaries (Shankaracharya).
+
+```ruby
+# Get tafsir for a Quran verse
+commentary = client.commentary("quran:al-fatihah.1")
+commentary["commentaries"].each do |c|
+  puts "#{c["author"]}: #{c["text"]}"
+end
+
+# Get Rashi commentary for a Torah verse
+commentary = client.commentary("torah:genesis.1.1")
+```
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `verse_of_the_day(religion, date:)` | Daily curated verse per religion |
+| `random_verse(religion:)` | Random verse from any/all religions |
+| `compare(ref_a, ref_b)` | Side-by-side verse comparison |
+| `search_suggest(query, religion:)` | Autocomplete across religions |
+| `topic_verses(topic)` | Verses for a topic across religions |
+| `cross_religion(topic)` | Cross-religion theme analysis |
+| `calendar(religion:, year:, month:)` | Religious calendar events |
+| `commentary(verse_ref)` | Scholarly commentary for a verse |
+
+## Supported Religions
+
+| Key | Religion | Scripture | Site |
+|-----|----------|-----------|------|
+| `bible` | Christianity | Bible (66 books, 31,102 verses) | [widebible.com](https://widebible.com) |
+| `quran` | Islam | Quran (114 surahs, 6,236 ayahs) | [widequran.com](https://widequran.com) |
+| `torah` | Judaism | Tanakh (24 books) + Talmud | [widetorah.com](https://widetorah.com) |
+| `gita` | Hinduism | Bhagavad Gita (18 chapters, 700 verses) | [widegita.com](https://widegita.com) |
+| `sutra` | Buddhism | Tipitaka + Mahayana Sutras | [widesutra.com](https://widesutra.com) |
+
+## Learn More About World Scriptures
+
+- **Compare**: [Cross-Religion Topics](https://wideholy.com/topics/) -- [Verse Comparison](https://wideholy.com/compare/)
+- **Explore**: [Religious Calendar](https://wideholy.com/calendar/) -- [Commentary](https://wideholy.com/commentary/)
+- **API**: [REST API Docs](https://wideholy.com/developers/) -- [OpenAPI Spec](https://wideholy.com/api/openapi.json)
+
+## WideHoly Scripture Family
+
+| Site | Domain | Focus |
+|------|--------|-------|
+| WideBible | [widebible.com](https://widebible.com) | 66 books, 31,102 verses, KJV/ASV/BBE/YLT, cross-references |
+| WideQuran | [widequran.com](https://widequran.com) | 114 surahs, 6,236 ayahs, hadith collections, tafsir |
+| WideTorah | [widetorah.com](https://widetorah.com) | Tanakh, Talmud tractates, parashot, Rashi commentary |
+| WideGita | [widegita.com](https://widegita.com) | 18 chapters, 700 verses, Upanishads, Yoga Sutras |
+| WideSutra | [widesutra.com](https://widesutra.com) | Tipitaka, Pali Canon, Mahayana sutras, Buddhist figures |
+| **WideHoly** | [wideholy.com](https://wideholy.com) | **Cross-religion search, verse comparison, shared topics** |
+
+## Also Available
+
+| Platform | Install | Link |
+|----------|---------|------|
+| **PyPI** | `pip install wideholy` | [PyPI](https://pypi.org/project/wideholy/) |
+| **npm** | `npm install wideholy` | [npm](https://www.npmjs.com/package/wideholy) |
+
+## License
+
+MIT

data/lib/wideholy/client.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module WideHoly
+  # HTTP client for the WideHoly hub REST API.
+  #
+  # Cross-religion scripture search and comparison across Bible, Quran,
+  # Torah, Gita, and Buddhist sutras.
+  #
+  # Zero runtime dependencies -- uses only Ruby stdlib (net/http, json, uri).
+  #
+  #   client = WideHoly::Client.new
+  #   votd = client.verse_of_the_day("bible")
+  #   result = client.compare("bible:genesis.1.1", "quran:al-fatihah.1")
+  #
+  class Client
+    DEFAULT_BASE_URL = "https://wideholy.com/api/v1"
+    DEFAULT_TIMEOUT  = 10
+
+    VALID_RELIGIONS = %w[bible quran torah gita sutra].freeze
+
+    def initialize(base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT)
+      @base_url = base_url.chomp("/")
+      @timeout = timeout
+    end
+
+    # --- Verse of the Day -----------------------------------------------------
+
+    # Get the verse of the day for a religion.
+    #
+    # Returns a curated verse, deterministic per religion per date.
+    #
+    # @param religion [String] religion key (bible, quran, torah, gita, sutra)
+    # @param date [String, nil] date in YYYY-MM-DD format (defaults to today)
+    # @return [Hash] verse with reference, text, translation, book, chapter, verse, date
+    def verse_of_the_day(religion = "bible", date: nil)
+      get("/verse-of-the-day/", { religion: religion, date: date })
+    end
+
+    # --- Random Verse ---------------------------------------------------------
+
+    # Get a random verse, optionally filtered by religion.
+    #
+    # @param religion [String, nil] religion key; if nil, picks a random religion
+    # @return [Hash] verse with religion, reference, text, translation
+    def random_verse(religion: nil)
+      get("/random/", { religion: religion })
+    end
+
+    # --- Compare Verses -------------------------------------------------------
+
+    # Compare two verses side-by-side (same or cross-religion).
+    #
+    # Use "religion:ref" format for cross-religion comparison.
+    #
+    # @param ref_a [String] first verse reference (e.g. "bible:genesis.1.1")
+    # @param ref_b [String] second verse reference (e.g. "quran:al-fatihah.1")
+    # @return [Hash] comparison with verse_a, verse_b, same_religion
+    def compare(ref_a, ref_b)
+      get("/compare/", { a: ref_a, b: ref_b })
+    end
+
+    # --- Search Suggest -------------------------------------------------------
+
+    # Autocomplete suggestions across religions.
+    #
+    # Returns topic, person, and glossary term suggestions matching the query.
+    #
+    # @param query [String] search query prefix (minimum 2 characters)
+    # @param religion [String, nil] filter to a specific religion
+    # @return [Hash] suggestions list (text, type, religion, url)
+    def search_suggest(query, religion: nil)
+      get("/search/suggest/", { q: query, religion: religion })
+    end
+
+    # --- Topic Verses ---------------------------------------------------------
+
+    # Get verses for a topic across all religions.
+    #
+    # @param topic [String] topic slug (e.g. "love", "creation", "prayer")
+    # @return [Hash] topic with religions_found, verses (per-religion data)
+    def topic_verses(topic)
+      get("/topics/#{topic}/verses/")
+    end
+
+    # --- Cross-Religion Topic -------------------------------------------------
+
+    # Get cross-religion comparison for a universal spiritual theme.
+    #
+    # @param topic [String] topic key (e.g. "creation", "prayer", "love")
+    # @return [Hash] topic with title, summary, religions (per-religion data)
+    def cross_religion(topic)
+      get("/cross-religion/#{topic}/")
+    end
+
+    # --- Religious Calendar ---------------------------------------------------
+
+    # Get religious calendar events.
+    #
+    # @param religion [String, nil] filter by religion key
+    # @param year [Integer, nil] year (default: current year)
+    # @param month [Integer, nil] month number (1-12)
+    # @return [Hash] calendar with year, month, religion, events list
+    def calendar(religion: nil, year: nil, month: nil)
+      get("/calendar/", { religion: religion, year: year, month: month })
+    end
+
+    # --- Commentary -----------------------------------------------------------
+
+    # Get commentary for a verse.
+    #
+    # Supports Quran (tafsir), Torah (Rashi), and Gita commentaries.
+    #
+    # @param verse_ref [String] verse reference (e.g. "quran:al-fatihah.1")
+    # @return [Hash] commentary with verse_ref, religion, commentaries list
+    def commentary(verse_ref)
+      get("/commentary/#{verse_ref}/")
+    end
+
+    private
+
+    def get(path, params = {})
+      uri = URI("#{@base_url}#{path}")
+      cleaned = params.each_with_object({}) { |(k, v), h| h[k] = v unless v.nil? }
+      uri.query = URI.encode_www_form(cleaned) unless cleaned.empty?
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/json"
+      request["User-Agent"] = "wideholy-rb/#{VERSION}"
+
+      response = http.request(request)
+
+      case response
+      when Net::HTTPSuccess
+        JSON.parse(response.body)
+      when Net::HTTPNotFound
+        raise "Not found: #{path}"
+      else
+        raise "HTTP #{response.code}: #{response.body}"
+      end
+    end
+  end
+end

data/lib/wideholy/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module WideHoly
+  VERSION = "0.1.0"
+end

data/lib/wideholy.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "wideholy/version"
+require_relative "wideholy/client"

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: wideholy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- dobestan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-24 00:00:00.000000000 Z
+dependencies: []
+description: API client for wideholy.com. Cross-religion verse of the day, random
+  verse, side-by-side comparison, search suggestions, topic verses across Bible/Quran/Torah/Gita/Sutra,
+  religious calendar, and commentary. Zero dependencies.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/wideholy.rb
+- lib/wideholy/client.rb
+- lib/wideholy/version.rb
+homepage: https://wideholy.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://wideholy.com
+  source_code_uri: https://github.com/dobestan/wideholy-rb
+  changelog_uri: https://github.com/dobestan/wideholy-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://wideholy.com/developers/
+  bug_tracker_uri: https://github.com/dobestan/wideholy-rb/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Ruby SDK for WideHoly — cross-religion scripture search and comparison
+test_files: []