widetorah 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bcec7f7da1b5efa67ca8bd428dca8af205f54aee194991efba1886134fd38bde
+  data.tar.gz: e11118fc079ae080c1dae0ceca6c9f8e22440220e85316d772fc838997453d4a
+SHA512:
+  metadata.gz: bcd145f1836f60b8e5596ec57db89305e6c0cfa705077511d4e46386d9c62853daf9b7f2e9460192637e0ed246c0dc4b0764ec3753e1bc9e47433a9d40f82b1c
+  data.tar.gz: 5fb1019cff8eff92d65629ec1899623731f6e800b6d68edc24488eaf4d352daa366648cb5e27d47198ce4d614fe3a2d73c78713a2ca498a10b7faabe727984af

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,242 @@
+# widetorah
+
+[![Gem Version](https://badge.fury.io/rb/widetorah.svg)](https://rubygems.org/gems/widetorah)
+[![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/widetorah)
+
+Ruby client for the [WideTorah](https://widetorah.com) API. Access 24 books of the Tanakh across 3 sections (Torah, Nevi'im, Ketuvim), 54 weekly parashot, 63 Talmud tractates with daf-level access, Mishnah chapters, Rashi commentary, Jewish holidays, biblical figures, topics, and a Hebrew/Aramaic glossary. Zero runtime dependencies -- uses only Ruby stdlib (`net/http`, `json`, `uri`).
+
+WideTorah is a comprehensive Jewish scripture encyclopedia providing structured access to the Tanakh, Talmud Bavli, Mishnah, and rabbinic commentary -- all accessible through a free REST API.
+
+> **Explore the Torah at [widetorah.com](https://widetorah.com)** -- [Books](https://widetorah.com/books/), [Parashot](https://widetorah.com/parashot/), [Talmud](https://widetorah.com/talmud/), [Figures](https://widetorah.com/figures/), [Holidays](https://widetorah.com/holidays/)
+
+## Table of Contents
+
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [What You Can Do](#what-you-can-do)
+  - [Browse Tanakh Books](#browse-tanakh-books)
+  - [Look Up Verses](#look-up-verses)
+  - [Search Scripture](#search-scripture)
+  - [Follow the Parashah Cycle](#follow-the-parashah-cycle)
+  - [Study Talmud](#study-talmud)
+  - [Read Rashi Commentary](#read-rashi-commentary)
+  - [Explore Jewish Holidays](#explore-jewish-holidays)
+  - [Discover Biblical Figures](#discover-biblical-figures)
+- [API Reference](#api-reference)
+- [Learn More About Jewish Scripture](#learn-more-about-jewish-scripture)
+- [WideHoly Scripture Family](#wideholy-scripture-family)
+- [Also Available](#also-available)
+- [License](#license)
+
+## Install
+
+```bash
+gem install widetorah
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "widetorah"
+```
+
+## Quick Start
+
+```ruby
+require "widetorah"
+
+# Create a client (zero configuration needed)
+client = WideTorah::Client.new
+
+# List all 24 books of the Tanakh
+books = client.list_books
+puts books["results"].first["name"]  # => "Genesis"
+
+# Get Genesis 1:1 in JPS-1917 translation
+verse = client.get_verse("genesis", 1, 1)
+puts verse["results"].first["text"]
+
+# Search Torah verses
+results = client.search("covenant")
+results["results"].each { |v| puts v["reference"] }
+```
+
+## What You Can Do
+
+### Browse Tanakh Books
+
+The Tanakh contains 24 books organized into three sections: Torah (5 books of Moses), Nevi'im (8 books of Prophets), and Ketuvim (11 books of Writings). Each book includes Hebrew and English names, chapter count, and verse count.
+
+```ruby
+# List all Tanakh books
+books = client.list_books
+
+# Filter by section
+torah = client.list_books(section: "torah")
+neviim = client.list_books(section: "neviim")
+
+# Get details for a specific book
+genesis = client.get_book("genesis")
+puts genesis["hebrew_name"]  # => "Bereshit"
+```
+
+### Look Up Verses
+
+Access every verse in the Tanakh with Hebrew text and English translations. The JPS-1917 (Jewish Publication Society) translation is the default.
+
+```ruby
+# Get a specific verse
+verse = client.get_verse("genesis", 1, 1)
+
+# Use a different translation
+verse = client.get_verse("psalms", 23, 1, translation: "koren")
+
+# List chapters in a book
+chapters = client.list_chapters(book: "exodus")
+```
+
+### Search Scripture
+
+Full-text search across all Tanakh verses with relevance ranking.
+
+```ruby
+# Search for a keyword
+results = client.search("blessing", limit: 10)
+results["results"].each do |verse|
+  puts "#{verse["reference"]}: #{verse["text"]}"
+end
+```
+
+### Follow the Parashah Cycle
+
+The Torah is divided into 54 weekly portions (parashot) read in synagogues throughout the year. Each parashah includes start and end verse references, associated haftarah readings, and thematic summaries.
+
+```ruby
+# List all 54 parashot
+parashot = client.list_parashot
+
+# Filter by book
+genesis_portions = client.list_parashot(book: "genesis")
+
+# Get Bereshit (first parashah)
+bereshit = client.get_parashah("bereshit")
+puts bereshit["hebrew_name"]
+```
+
+### Study Talmud
+
+The Talmud Bavli (Babylonian Talmud) consists of 63 tractates organized into 6 sedarim (orders). Access individual daf (folio) pages with Hebrew, English, and Aramaic text.
+
+| Seder | Meaning | Tractates |
+|-------|---------|-----------|
+| Zeraim | Seeds | Berakhot and agricultural laws |
+| Moed | Festivals | Shabbat, Pesachim, Yoma |
+| Nashim | Women | Ketubot, Gittin, Kiddushin |
+| Nezikin | Damages | Bava Kamma, Sanhedrin |
+| Kodashim | Holy Things | Zevachim, Menachot |
+| Tohorot | Purities | Niddah |
+
+```ruby
+# List tractates
+tractates = client.list_tractates
+
+# Filter by seder
+moed = client.list_tractates(seder: "moed")
+
+# Get a specific Talmud page (daf)
+daf = client.get_talmud_daf("berakhot", 2, side: "a")
+
+# Access Mishnah chapters
+mishnah = client.list_mishnah(tractate: "berakhot")
+```
+
+### Read Rashi Commentary
+
+Rashi (Rabbi Shlomo Yitzchaki, 1040-1105) wrote the most widely studied commentary on the Torah. His concise explanations clarify the plain meaning (peshat) of the text.
+
+```ruby
+# List Rashi commentaries on Genesis
+rashi = client.list_rashi(book: "genesis")
+
+# Filter by chapter
+rashi_ch1 = client.list_rashi(book: "genesis", chapter: 1)
+```
+
+### Explore Jewish Holidays
+
+Jewish holidays span three categories: biblical (Torah-mandated), rabbinic (Talmud-instituted), and modern (state of Israel).
+
+```ruby
+# List all holidays
+holidays = client.list_holidays
+
+# Filter by category
+biblical = client.list_holidays(category: "biblical")
+```
+
+### Discover Biblical Figures
+
+Profiles of patriarchs, matriarchs, prophets, kings, and other key figures in Jewish scripture.
+
+```ruby
+# List figures by era
+patriarchs = client.list_figures(era: "patriarchs")
+
+# Get details for Abraham
+abraham = client.get_figure("abraham")
+puts abraham["hebrew_name"]
+```
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `list_books(section:)` | List Tanakh books, filter by section |
+| `get_book(slug)` | Get book details |
+| `list_translations` | List available translations |
+| `list_chapters(book:)` | List chapters |
+| `get_verse(book, chapter, verse, translation:)` | Get a specific verse |
+| `search(query, limit:)` | Search verses |
+| `list_parashot(book:)` | List 54 weekly portions |
+| `get_parashah(slug)` | Get parashah details |
+| `list_tractates(seder:)` | List Talmud tractates |
+| `get_talmud_daf(tractate, daf, side:)` | Get a Talmud daf page |
+| `list_mishnah(tractate:)` | List Mishnah chapters |
+| `list_rashi(book:, chapter:)` | List Rashi commentaries |
+| `list_holidays(category:)` | List Jewish holidays |
+| `list_figures(era:)` | List biblical figures |
+| `get_figure(slug)` | Get figure details |
+| `list_topics` | List thematic topics |
+| `list_glossary` | List glossary terms |
+
+## Learn More About Jewish Scripture
+
+- **Browse**: [Books](https://widetorah.com/books/) -- [Parashot](https://widetorah.com/parashot/) -- [Talmud](https://widetorah.com/talmud/)
+- **Study**: [Figures](https://widetorah.com/figures/) -- [Holidays](https://widetorah.com/holidays/) -- [Glossary](https://widetorah.com/glossary/)
+- **API**: [REST API Docs](https://widetorah.com/developers/) -- [OpenAPI Spec](https://widetorah.com/api/openapi.json)
+
+## WideHoly Scripture Family
+
+Part of the [WideHoly](https://wideholy.com) multi-religion scripture platform.
+
+| 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 widetorah` | [PyPI](https://pypi.org/project/widetorah/) |
+| **npm** | `npm install widetorah` | [npm](https://www.npmjs.com/package/widetorah) |
+
+## License
+
+MIT

data/lib/widetorah/client.rb

@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module WideTorah
+  # HTTP client for the WideTorah REST API.
+  #
+  # Zero runtime dependencies -- uses only Ruby stdlib (net/http, json, uri).
+  #
+  #   client = WideTorah::Client.new
+  #   books = client.list_books
+  #   verse = client.get_verse("genesis", 1, 1)
+  #   results = client.search("covenant")
+  #
+  class Client
+    DEFAULT_BASE_URL = "https://widetorah.com/api/v1/torah"
+    DEFAULT_TIMEOUT  = 10
+
+    def initialize(base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT)
+      @base_url = base_url.chomp("/")
+      @timeout = timeout
+    end
+
+    # --- Books ----------------------------------------------------------------
+
+    # List all 24 books of the Tanakh.
+    #
+    # @param section [String, nil] filter by "torah", "neviim", or "ketuvim"
+    # @return [Hash] paginated list of books
+    def list_books(section: nil, **params)
+      get("/books/", { section: section }.merge(params))
+    end
+
+    # Get book details by slug (e.g. "genesis", "psalms").
+    #
+    # @param slug [String] book URL slug
+    # @return [Hash] book details with name, hebrew_name, section, chapter_count
+    def get_book(slug)
+      get("/books/#{slug}/")
+    end
+
+    # --- Translations ---------------------------------------------------------
+
+    # List available Torah translations (JPS-1917, Koren, Masoretic Hebrew).
+    #
+    # @return [Hash] paginated list of translations
+    def list_translations(**params)
+      get("/translations/", params)
+    end
+
+    # --- Chapters -------------------------------------------------------------
+
+    # List chapters, optionally filtered by book slug.
+    #
+    # @param book [String, nil] book slug to filter by
+    # @return [Hash] paginated list of chapters
+    def list_chapters(book: nil, **params)
+      get("/chapters/", { book__slug: book }.merge(params))
+    end
+
+    # --- Verses ---------------------------------------------------------------
+
+    # Get a specific Torah verse by book, chapter, and verse number.
+    #
+    # @param book [String] book slug (e.g. "genesis", "exodus")
+    # @param chapter [Integer] chapter number
+    # @param verse [Integer] verse number
+    # @param translation [String] translation code (default: "jps-1917")
+    # @return [Hash] verse data with text, text_hebrew, reference
+    def get_verse(book, chapter, verse, translation: "jps-1917")
+      get("/verses/", {
+        chapter__book__slug: book,
+        chapter__number: chapter,
+        number: verse,
+        translation__code: translation
+      })
+    end
+
+    # Search Torah verses by keyword.
+    #
+    # @param query [String] search query string
+    # @param limit [Integer] maximum number of results (default: 25)
+    # @return [Hash] paginated search results
+    def search(query, limit: 25)
+      get("/verses/", { search: query, page_size: limit })
+    end
+
+    # --- Parashot -------------------------------------------------------------
+
+    # List the 54 weekly Torah portions (parashot).
+    #
+    # @param book [String, nil] filter by book slug
+    # @return [Hash] paginated list of parashot
+    def list_parashot(book: nil, **params)
+      get("/parashot/", { book__slug: book }.merge(params))
+    end
+
+    # Get parashah details by slug (e.g. "bereshit", "noach").
+    #
+    # @param slug [String] parashah slug
+    # @return [Hash] parashah details with name, hebrew_name, start/end references
+    def get_parashah(slug)
+      get("/parashot/#{slug}/")
+    end
+
+    # --- Talmud Tractates -----------------------------------------------------
+
+    # List Talmud tractates (63 volumes across 6 sedarim).
+    #
+    # @param seder [String, nil] filter by seder name (e.g. "zeraim", "moed")
+    # @return [Hash] paginated list of tractates
+    def list_tractates(seder: nil, **params)
+      get("/tractates/", { seder: seder }.merge(params))
+    end
+
+    # --- Talmud Daf -----------------------------------------------------------
+
+    # Get a Talmud folio page (daf) by tractate, number, and side.
+    #
+    # @param tractate [String] tractate slug (e.g. "berakhot", "shabbat")
+    # @param daf [Integer] daf (folio) number
+    # @param side [String] page side -- "a" (recto) or "b" (verso)
+    # @return [Hash] daf with text_hebrew, text_english, text_aramaic
+    def get_talmud_daf(tractate, daf, side: "a")
+      get("/dapim/", {
+        tractate__slug: tractate,
+        number: daf,
+        side: side
+      })
+    end
+
+    # --- Mishnah --------------------------------------------------------------
+
+    # List Mishnah chapters, optionally filtered by tractate.
+    #
+    # @param tractate [String, nil] tractate slug to filter by
+    # @return [Hash] paginated list of Mishnah chapters
+    def list_mishnah(tractate: nil, **params)
+      get("/mishnah/", { tractate__slug: tractate }.merge(params))
+    end
+
+    # --- Rashi Commentary -----------------------------------------------------
+
+    # List Rashi commentaries on Torah verses.
+    #
+    # @param book [String, nil] filter by book slug
+    # @param chapter [Integer, nil] filter by chapter number
+    # @return [Hash] paginated list of Rashi commentaries
+    def list_rashi(book: nil, chapter: nil, **params)
+      get("/rashi/", { book__slug: book, chapter: chapter }.merge(params))
+    end
+
+    # --- Jewish Holidays ------------------------------------------------------
+
+    # List Jewish holidays (biblical, rabbinic, modern).
+    #
+    # @param category [String, nil] filter by category
+    # @return [Hash] paginated list of holidays
+    def list_holidays(category: nil, **params)
+      get("/holidays/", { category: category }.merge(params))
+    end
+
+    # --- Biblical Figures -----------------------------------------------------
+
+    # List biblical figures (patriarchs, prophets, kings, etc.).
+    #
+    # @param era [String, nil] filter by era (e.g. "patriarchs", "judges")
+    # @return [Hash] paginated list of figures
+    def list_figures(era: nil, **params)
+      get("/figures/", { era: era }.merge(params))
+    end
+
+    # Get a biblical figure's details by slug.
+    #
+    # @param slug [String] figure slug
+    # @return [Hash] figure details with name, hebrew_name, era, is_prophet
+    def get_figure(slug)
+      get("/figures/#{slug}/")
+    end
+
+    # --- Topics ---------------------------------------------------------------
+
+    # List thematic topics (covenant, creation, law, etc.).
+    #
+    # @return [Hash] paginated list of topics
+    def list_topics(**params)
+      get("/topics/", params)
+    end
+
+    # --- Glossary -------------------------------------------------------------
+
+    # List Hebrew/Aramaic glossary terms with definitions.
+    #
+    # @return [Hash] paginated list of glossary terms
+    def list_glossary(**params)
+      get("/glossary/", params)
+    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"] = "widetorah-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/widetorah/version.rb

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

data/lib/widetorah.rb

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

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: widetorah
+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 widetorah.com. Access 24 books of the Tanakh, 54 parashot,
+  63 Talmud tractates with daf pages, Mishnah, Rashi commentary, Jewish holidays,
+  biblical figures, topics, and Hebrew/Aramaic glossary. Zero dependencies.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/widetorah.rb
+- lib/widetorah/client.rb
+- lib/widetorah/version.rb
+homepage: https://widetorah.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://widetorah.com
+  source_code_uri: https://github.com/dobestan/widetorah-rb
+  changelog_uri: https://github.com/dobestan/widetorah-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://widetorah.com/developers/
+  bug_tracker_uri: https://github.com/dobestan/widetorah-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 WideTorah — Tanakh, Talmud, parashot, Rashi commentary
+test_files: []