widegita 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b5e142a8b24a0f229ebd0a311086273d201d10b4769b040a1ae174af518031ae
+  data.tar.gz: fbeff74bb64592d72ad0ee61b329d275c9af05bcddfe35c9bc5bcf83d39dabe6
+SHA512:
+  metadata.gz: 1e0d9e835083c5ba082a24c84e47440894a9862a78d3625d05e792a731a4e2d5b1bde82890870e426f1a2ac3ec4ba80363cd8533cfeb32d6961f91611d0b2030
+  data.tar.gz: 25595fe3685bf60bcdfeba9a41a221db724278311d4e150c513af8435e11d57c89838b86da7223eceaf5b9b76420d5e5d4539f42a06bcba675b3a3376eaaaa1f

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,261 @@
+# widegita
+
+[![Gem Version](https://badge.fury.io/rb/widegita.svg)](https://rubygems.org/gems/widegita)
+[![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/widegita)
+
+Ruby client for the [WideGita](https://widegita.com) API. Access all 18 chapters and 700 verses of the Bhagavad Gita with Sanskrit text and multiple commentaries (Shankaracharya, Ramanujacharya), Upanishads, Yoga Sutras of Patanjali, Hindu deities, philosophical concepts, topics, and a Sanskrit glossary. Zero runtime dependencies -- uses only Ruby stdlib (`net/http`, `json`, `uri`).
+
+WideGita is a comprehensive Hindu scripture encyclopedia providing structured access to the Bhagavad Gita, Upanishadic wisdom, Yoga philosophy, and the broader Hindu intellectual tradition -- all accessible through a free REST API.
+
+> **Explore the Gita at [widegita.com](https://widegita.com)** -- [Chapters](https://widegita.com/chapters/), [Upanishads](https://widegita.com/upanishads/), [Yoga Sutras](https://widegita.com/yoga-sutras/), [Deities](https://widegita.com/deities/), [Concepts](https://widegita.com/concepts/)
+
+## Table of Contents
+
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [What You Can Do](#what-you-can-do)
+  - [Read Gita Chapters](#read-gita-chapters)
+  - [Look Up Verses](#look-up-verses)
+  - [Search Scripture](#search-scripture)
+  - [Study Commentaries](#study-commentaries)
+  - [Explore Upanishads](#explore-upanishads)
+  - [Study Yoga Sutras](#study-yoga-sutras)
+  - [Discover Hindu Deities](#discover-hindu-deities)
+  - [Explore Philosophical Concepts](#explore-philosophical-concepts)
+- [API Reference](#api-reference)
+- [Learn More About Hindu Scripture](#learn-more-about-hindu-scripture)
+- [WideHoly Scripture Family](#wideholy-scripture-family)
+- [Also Available](#also-available)
+- [License](#license)
+
+## Install
+
+```bash
+gem install widegita
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "widegita"
+```
+
+## Quick Start
+
+```ruby
+require "widegita"
+
+# Create a client (zero configuration needed)
+client = WideGita::Client.new
+
+# List all 18 chapters of the Bhagavad Gita
+chapters = client.list_chapters
+puts chapters["results"].first["name"]
+
+# Get a specific verse -- Chapter 2, Verse 47 (Karma Yoga)
+verse = client.get_verse(2, 47)
+puts verse["text"]
+
+# Search across all verses
+results = client.search("dharma")
+results["results"].each { |v| puts v["text"] }
+```
+
+## What You Can Do
+
+### Read Gita Chapters
+
+The Bhagavad Gita contains 18 chapters, each exploring a different aspect of yoga and dharma. The dialogue between Krishna and Arjuna on the battlefield of Kurukshetra covers karma yoga (action), jnana yoga (knowledge), and bhakti yoga (devotion).
+
+| Chapter | Name | Verses | Theme |
+|---------|------|--------|-------|
+| 1 | Arjuna Vishada Yoga | 47 | Arjuna's grief and moral dilemma |
+| 2 | Sankhya Yoga | 72 | Self, soul, and duty |
+| 3 | Karma Yoga | 43 | Path of selfless action |
+| 4 | Jnana Karma Sanyasa Yoga | 42 | Knowledge and renunciation |
+| 12 | Bhakti Yoga | 20 | Path of devotion |
+| 18 | Moksha Sanyasa Yoga | 78 | Liberation and surrender |
+
+```ruby
+# List all chapters
+chapters = client.list_chapters
+
+# Get details for Chapter 2 (Sankhya Yoga)
+ch2 = client.get_chapter(2)
+puts ch2["name"]         # => "Sankhya Yoga"
+puts ch2["verse_count"]  # => 72
+```
+
+### Look Up Verses
+
+Access all 700 verses with original Sanskrit (Devanagari), transliteration, and multiple English translations. The Sivananda translation is the default.
+
+```ruby
+# Get the famous Karma Yoga verse (2.47)
+verse = client.get_verse(2, 47, translation: "sivananda")
+
+# List all verses in a chapter
+verses = client.list_verses(chapter: 2)
+
+# Filter by translation
+verses = client.list_verses(chapter: 12, translation: "gambhirananda")
+```
+
+### Search Scripture
+
+Full-text search across all Gita verses.
+
+```ruby
+# Search for verses about dharma
+results = client.search("dharma", limit: 10)
+results["results"].each do |verse|
+  puts verse["text"]
+end
+```
+
+### Study Commentaries
+
+Classical commentaries from Advaita (Shankaracharya), Vishishtadvaita (Ramanujacharya), and Dvaita (Madhvacharya) traditions provide diverse philosophical interpretations.
+
+```ruby
+# List available commentaries
+commentaries = client.list_commentaries
+
+# Filter by philosophical tradition
+advaita = client.list_commentaries(tradition: "advaita")
+
+# Get Shankaracharya's commentary
+shankara = client.get_commentary("shankaracharya")
+
+# List entries for a specific chapter
+entries = client.list_commentary_entries(commentary: "shankaracharya", chapter: 2)
+```
+
+### Explore Upanishads
+
+The Upanishads are the philosophical foundation of Hinduism. The 10 principal (Mukhya) Upanishads are considered the most authoritative, drawn from the four Vedas.
+
+```ruby
+# List all Upanishads
+upanishads = client.list_upanishads
+
+# Only the 10 principal Upanishads
+principal = client.list_upanishads(principal_only: true)
+
+# Filter by Veda
+rig_veda = client.list_upanishads(veda: "rig")
+
+# Get the Isha Upanishad
+isha = client.get_upanishad("isha")
+```
+
+### Study Yoga Sutras
+
+Patanjali's Yoga Sutras (196 aphorisms) are organized into 4 padas (chapters): Samadhi, Sadhana, Vibhuti, and Kaivalya -- the foundational text of Raja Yoga.
+
+```ruby
+# List all Yoga Sutras
+sutras = client.list_yoga_sutras
+
+# Filter by pada
+samadhi = client.list_yoga_sutras(pada: 1)
+
+# Get a specific sutra
+sutra = client.get_yoga_sutra("1-2")  # yogas chitta vritti nirodhah
+```
+
+### Discover Hindu Deities
+
+Profiles of Hindu deities spanning Vaishnavism, Shaivism, and Shaktism traditions -- from the Trimurti (Brahma, Vishnu, Shiva) to regional and folk deities.
+
+```ruby
+# List all deities
+deities = client.list_deities
+
+# Trimurti only
+trimurti = client.list_deities(trimurti_only: true)
+
+# Filter by tradition
+vaishnava = client.list_deities(tradition: "vaishnavism")
+
+# Get Krishna's profile
+krishna = client.get_deity("krishna")
+```
+
+### Explore Philosophical Concepts
+
+Core Hindu philosophical concepts -- dharma, karma, moksha, samsara, atman, brahman -- with definitions, scriptural references, and tradition-specific interpretations.
+
+```ruby
+# List concepts
+concepts = client.list_concepts
+
+# Filter by category
+yoga_concepts = client.list_concepts(category: "yoga")
+
+# Get details for dharma
+dharma = client.get_concept("dharma")
+
+# Browse glossary
+terms = client.list_glossary
+term = client.get_glossary_term("karma")
+```
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `list_chapters` | List all 18 Gita chapters |
+| `get_chapter(number)` | Get chapter by number |
+| `list_translations(language:)` | List translations |
+| `get_translation(code)` | Get translation details |
+| `list_verses(chapter:, translation:)` | List verses with filters |
+| `get_verse(chapter, verse, translation:)` | Get a specific verse |
+| `search(query, limit:)` | Search verse texts |
+| `list_commentaries(tradition:)` | List commentaries |
+| `get_commentary(slug)` | Get commentary details |
+| `list_commentary_entries(commentary:, chapter:)` | List commentary entries |
+| `list_upanishads(veda:, principal_only:)` | List Upanishads |
+| `get_upanishad(slug)` | Get Upanishad details |
+| `list_yoga_sutras(pada:)` | List Yoga Sutras |
+| `get_yoga_sutra(slug)` | Get a Yoga Sutra |
+| `list_deities(tradition:, trimurti_only:)` | List Hindu deities |
+| `get_deity(slug)` | Get deity details |
+| `list_concepts(category:)` | List philosophical concepts |
+| `get_concept(slug)` | Get concept details |
+| `list_topics` | List Gita topics |
+| `get_topic(slug)` | Get topic details |
+| `list_glossary` | List Sanskrit glossary |
+| `get_glossary_term(slug)` | Get term definition |
+
+## Learn More About Hindu Scripture
+
+- **Browse**: [Chapters](https://widegita.com/chapters/) -- [Upanishads](https://widegita.com/upanishads/) -- [Yoga Sutras](https://widegita.com/yoga-sutras/)
+- **Study**: [Deities](https://widegita.com/deities/) -- [Concepts](https://widegita.com/concepts/) -- [Glossary](https://widegita.com/glossary/)
+- **API**: [REST API Docs](https://widegita.com/developers/) -- [OpenAPI Spec](https://widegita.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 widegita` | [PyPI](https://pypi.org/project/widegita/) |
+| **npm** | `npm install widegita` | [npm](https://www.npmjs.com/package/widegita) |
+
+## License
+
+MIT

data/lib/widegita/client.rb

@@ -0,0 +1,262 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module WideGita
+  # HTTP client for the WideGita REST API.
+  #
+  # Zero runtime dependencies -- uses only Ruby stdlib (net/http, json, uri).
+  #
+  #   client = WideGita::Client.new
+  #   chapters = client.list_chapters
+  #   verse = client.get_verse(2, 47)
+  #   results = client.search("dharma")
+  #
+  class Client
+    DEFAULT_BASE_URL = "https://widegita.com/api/v1/gita"
+    DEFAULT_TIMEOUT  = 10
+
+    def initialize(base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT)
+      @base_url = base_url.chomp("/")
+      @timeout = timeout
+    end
+
+    # --- Chapters -------------------------------------------------------------
+
+    # List all 18 chapters of the Bhagavad Gita.
+    #
+    # @return [Hash] paginated list of chapters
+    def list_chapters
+      get("/chapters/")
+    end
+
+    # Get chapter by number (1-18).
+    #
+    # @param number [Integer] chapter number
+    # @return [Hash] chapter details with name, sanskrit_name, verse_count
+    def get_chapter(number)
+      get("/chapters/#{number}/")
+    end
+
+    # --- Translations ---------------------------------------------------------
+
+    # List available Gita translations.
+    #
+    # @param language [String, nil] filter by language code (e.g. "en", "sa")
+    # @return [Hash] paginated list of translations
+    def list_translations(language: nil, **params)
+      get("/translations/", { language: language }.merge(params))
+    end
+
+    # Get translation by code (e.g. "sivananda", "gambhirananda").
+    #
+    # @param code [String] translation code
+    # @return [Hash] translation details
+    def get_translation(code)
+      get("/translations/#{code}/")
+    end
+
+    # --- Verses ---------------------------------------------------------------
+
+    # List Gita verses with optional filters.
+    #
+    # @param chapter [Integer, nil] filter by chapter number
+    # @param translation [String, nil] filter by translation code
+    # @return [Hash] paginated list of verses
+    def list_verses(chapter: nil, translation: nil, **params)
+      get("/verses/", { chapter__number: chapter, translation__code: translation }.merge(params))
+    end
+
+    # Get a specific verse by chapter and verse number.
+    #
+    # @param chapter [Integer] chapter number (1-18)
+    # @param verse [Integer] verse number within the chapter
+    # @param translation [String] translation code (default: "sivananda")
+    # @return [Hash] verse data with Sanskrit text and translation
+    def get_verse(chapter, verse, translation: "sivananda")
+      get("/verses/", {
+        chapter__number: chapter,
+        number: verse,
+        translation__code: translation
+      })
+    end
+
+    # Search across verse texts.
+    #
+    # @param query [String] search query string
+    # @param limit [Integer] maximum results (default: 25)
+    # @return [Hash] paginated search results
+    def search(query, limit: 25)
+      get("/verses/", { search: query, page_size: limit })
+    end
+
+    # --- Commentaries ---------------------------------------------------------
+
+    # List Gita commentaries.
+    #
+    # @param tradition [String, nil] filter by tradition (e.g. "advaita", "dvaita")
+    # @return [Hash] paginated list of commentaries
+    def list_commentaries(tradition: nil, **params)
+      get("/commentaries/", { tradition: tradition }.merge(params))
+    end
+
+    # Get commentary by slug (e.g. "shankaracharya").
+    #
+    # @param slug [String] commentary slug
+    # @return [Hash] commentary details
+    def get_commentary(slug)
+      get("/commentaries/#{slug}/")
+    end
+
+    # List commentary entries with optional filters.
+    #
+    # @param commentary [String, nil] filter by commentary slug
+    # @param chapter [Integer, nil] filter by chapter number
+    # @return [Hash] paginated list of commentary entries
+    def list_commentary_entries(commentary: nil, chapter: nil, **params)
+      get("/commentary-entries/", { commentary__slug: commentary, chapter__number: chapter }.merge(params))
+    end
+
+    # --- Upanishads -----------------------------------------------------------
+
+    # List Upanishads.
+    #
+    # @param veda [String, nil] filter by Veda ("rig", "yajur", "sama", "atharva")
+    # @param principal_only [Boolean] if true, return only the 10 principal Upanishads
+    # @return [Hash] paginated list of Upanishads
+    def list_upanishads(veda: nil, principal_only: false, **params)
+      p = { veda: veda }.merge(params)
+      p[:is_principal] = true if principal_only
+      get("/upanishads/", p)
+    end
+
+    # Get Upanishad by slug (e.g. "isha", "kena", "mundaka").
+    #
+    # @param slug [String] Upanishad slug
+    # @return [Hash] Upanishad details
+    def get_upanishad(slug)
+      get("/upanishads/#{slug}/")
+    end
+
+    # --- Yoga Sutras ----------------------------------------------------------
+
+    # List Yoga Sutras of Patanjali.
+    #
+    # @param pada [Integer, nil] filter by pada (1=Samadhi, 2=Sadhana, 3=Vibhuti, 4=Kaivalya)
+    # @return [Hash] paginated list of sutras
+    def list_yoga_sutras(pada: nil, **params)
+      get("/yoga-sutras/", { pada: pada }.merge(params))
+    end
+
+    # Get Yoga Sutra by slug (e.g. "1-2", "2-46").
+    #
+    # @param slug [String] sutra slug
+    # @return [Hash] sutra details
+    def get_yoga_sutra(slug)
+      get("/yoga-sutras/#{slug}/")
+    end
+
+    # --- Deities --------------------------------------------------------------
+
+    # List Hindu deities.
+    #
+    # @param tradition [String, nil] filter by tradition ("vaishnavism", "shaivism")
+    # @param trimurti_only [Boolean] if true, return only Brahma, Vishnu, Shiva
+    # @return [Hash] paginated list of deities
+    def list_deities(tradition: nil, trimurti_only: false, **params)
+      p = { tradition: tradition }.merge(params)
+      p[:is_trimurti] = true if trimurti_only
+      get("/deities/", p)
+    end
+
+    # Get deity by slug (e.g. "krishna", "shiva", "ganesha").
+    #
+    # @param slug [String] deity slug
+    # @return [Hash] deity details
+    def get_deity(slug)
+      get("/deities/#{slug}/")
+    end
+
+    # --- Concepts -------------------------------------------------------------
+
+    # List Hindu philosophical concepts.
+    #
+    # @param category [String, nil] filter by category ("yoga", "vedanta")
+    # @return [Hash] paginated list of concepts
+    def list_concepts(category: nil, **params)
+      get("/concepts/", { category: category }.merge(params))
+    end
+
+    # Get concept by slug (e.g. "dharma", "karma", "moksha").
+    #
+    # @param slug [String] concept slug
+    # @return [Hash] concept details
+    def get_concept(slug)
+      get("/concepts/#{slug}/")
+    end
+
+    # --- Topics ---------------------------------------------------------------
+
+    # List Gita topics and themes.
+    #
+    # @return [Hash] paginated list of topics
+    def list_topics
+      get("/topics/")
+    end
+
+    # Get topic by slug.
+    #
+    # @param slug [String] topic slug
+    # @return [Hash] topic details
+    def get_topic(slug)
+      get("/topics/#{slug}/")
+    end
+
+    # --- Glossary -------------------------------------------------------------
+
+    # List Sanskrit glossary terms.
+    #
+    # @return [Hash] paginated list of glossary terms
+    def list_glossary
+      get("/glossary/")
+    end
+
+    # Get glossary term by slug.
+    #
+    # @param slug [String] term slug
+    # @return [Hash] glossary term details
+    def get_glossary_term(slug)
+      get("/glossary/#{slug}/")
+    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"] = "widegita-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/widegita/version.rb

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

data/lib/widegita.rb

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

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: widegita
+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 widegita.com. Access 18 Gita chapters, 700 verses with
+  Sanskrit text and commentaries, Upanishads, Yoga Sutras of Patanjali, Hindu deities,
+  philosophical concepts, topics, and Sanskrit glossary. Zero dependencies.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/widegita.rb
+- lib/widegita/client.rb
+- lib/widegita/version.rb
+homepage: https://widegita.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://widegita.com
+  source_code_uri: https://github.com/dobestan/widegita-rb
+  changelog_uri: https://github.com/dobestan/widegita-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://widegita.com/developers/
+  bug_tracker_uri: https://github.com/dobestan/widegita-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 WideGita — Bhagavad Gita, Upanishads, Yoga Sutras, Hindu encyclopdia
+test_files: []