sahih-al-bukhari 3.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e6ebc0c85847f52e123dc4894cef9e8d0a139a3659b1c57f77e85a90fbc3b57e
+  data.tar.gz: 5eac6a24cc055bff4f09ce2a866e8ddf855a7c6fecb6dfd0bfcab92765246cee
+SHA512:
+  metadata.gz: 0e883151bc93ba133e9ae2fbf1c097e5174acbecd1ef6470eb2cf85aef9071bbca0e926339c8d070076b16df5e8576169de788d6ca097aebb5f622dfcd104a5d
+  data.tar.gz: 15eec75b751bbc3d093421cedeb7662fc796fd4a28a0826bf12b809a7a7855507050cd842602ddcfc24d5ebd511689410c01e85784e8b151dfaddf084fc5d4bf

data/README.md

@@ -0,0 +1,196 @@
+# Sahih al-Bukhari Ruby Gem
+
+Complete Sahih al-Bukhari collection for Ruby — 7,277 authentic hadiths with full Arabic text and English translations.
+
+## Features
+
+- **Offline-first**: All data is bundled, no internet required
+- **Zero dependencies**: Pure Ruby implementation
+- **Complete collection**: All 7,277 hadiths from Sahih al-Bukhari
+- **Bilingual**: Arabic text with English translations
+- **CLI tool**: Command-line interface for quick access
+- **Ruby library**: Easy integration into Ruby applications
+- **Search functionality**: Find hadiths by text search
+- **Chapter organization**: Browse by traditional chapter structure
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'sahih-al-bukhari'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install sahih-al-bukhari
+```
+
+## Quick Start
+
+### Ruby Library
+
+```ruby
+require 'sahih_al_bukhari'
+
+# Initialize the collection
+bukhari = SahihAlBukhari::Bukhari.new
+
+# Get a specific hadith
+hadith = bukhari.get(1)
+puts hadith.arabic
+puts hadith.english
+
+# Search for hadiths
+results = bukhari.search("prayer")
+results.each { |h| puts h.english }
+
+# Get random hadith
+random = bukhari.get_random
+puts random.english
+
+# Get hadiths by chapter
+chapter_hadiths = bukhari.get_by_chapter(1)
+
+# Browse chapters
+bukhari.chapters.each do |chapter|
+  puts "Chapter #{chapter.id}: #{chapter.title}"
+end
+```
+
+### Command Line Interface
+
+```bash
+# Get a specific hadith
+bukhari -n 1
+
+# Search for hadiths
+bukhari -s prayer
+
+# Get random hadith
+bukhari -r
+
+# List all chapters
+bukhari -l
+
+# Get hadiths from a specific chapter
+bukhari -c 1
+
+# Show metadata
+bukhari -m
+
+# Output as JSON
+bukhari -n 1 --json
+
+# Limit search results
+bukhari -s prayer --limit 5
+```
+
+## API Reference
+
+### SahihAlBukhari::Bukhari
+
+#### Constructor
+
+```ruby
+bukhari = SahihAlBukhari::Bukhari.new(data_path: optional_custom_path)
+```
+
+#### Methods
+
+- `get(number)` - Get hadith by number (1-based)
+- `get_by_chapter(chapter_id)` - Get all hadiths from a chapter
+- `search(query)` - Search hadiths by Arabic or English text
+- `get_random()` - Get a random hadith
+- `chapters` - Array of all chapters
+- `metadata` - Collection metadata
+- `length` - Total number of hadiths
+
+#### Data Classes
+
+**Hadith**
+- `number` - Hadith number
+- `arabic` - Arabic text
+- `english` - English translation
+- `chapter_id` - Chapter ID
+
+**Chapter**
+- `id` - Chapter ID
+- `title` - English title
+- `arabic_title` - Arabic title
+
+**Metadata**
+- `total_hadiths` - Total number of hadiths
+- `total_chapters` - Total number of chapters
+- `language` - Language codes
+- `source` - Data source information
+
+## CLI Options
+
+```
+Usage: bukhari [options]
+
+    -n, --number NUMBER          Get specific hadith by number
+    -c, --chapter CHAPTER       Get hadiths from specific chapter
+    -s, --search QUERY           Search hadiths
+    -r, --random                 Get random hadith
+    -l, --list-chapters          List all chapters
+    -m, --metadata               Show collection metadata
+    -j, --json                   Output as JSON
+        --chapter-info           Show chapter info with hadiths
+        --limit LIMIT            Limit search results (default: 10)
+    -v, --version                Show version
+    -h, --help                   Show this help
+```
+
+## Data Source
+
+This gem shares the same data files as the Node.js and Python packages in this repository:
+
+- `bin/bukhari.json` - Main data file (shared across all packages)
+- `chapters/` - Chapter metadata files
+
+The data is automatically detected in the following priority order:
+
+1. Custom `data_path` parameter
+2. `bin/bukhari.json` at repository root
+3. Bundled data in the gem
+4. CDN fallback (downloads automatically)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+### Rake Tasks
+
+```bash
+rake spec                    # Run tests
+rake yard                    # Generate documentation
+rake bukhari:test_basic      # Test basic functionality
+rake bukhari:test_cli        # Test CLI
+rake bukhari:prepare_data    # Download data files
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/SENODROOM/sahih-al-bukhari.
+
+## License
+
+This gem is available as open source under the terms of the AGPL-3.0 License.
+
+## Version History
+
+- **3.1.2** - Initial Ruby implementation
+- Matches API compatibility with Python and Node.js versions

data/bin/bukhari

@@ -0,0 +1,262 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# CLI for sahih-al-bukhari (Ruby package)
+
+require 'optparse'
+require 'json'
+require_relative '../sahih_al_bukhari'
+
+VERSION = SahihAlBukhari::VERSION
+
+# ANSI color codes
+module Colors
+  RESET = "\e[0m"
+  BOLD = "\e[1m"
+  DIM = "\e[2m"
+  GREEN = "\e[32m"
+  YELLOW = "\e[33m"
+  CYAN = "\e[36m"
+  MAGENTA = "\e[35m"
+  BLUE = "\e[34m"
+  RED = "\e[31m"
+  GRAY = "\e[90m"
+
+  def self.color(code, text)
+    "#{code}#{text}#{RESET}"
+  end
+
+  def self.bold(text); color(BOLD, text); end
+  def self.green(text); color(GREEN, text); end
+  def self.yellow(text); color(YELLOW, text); end
+  def self.cyan(text); color(CYAN, text); end
+  def self.magenta(text); color(MAGENTA, text); end
+  def self.blue(text); color(BLUE, text); end
+  def self.red(text); color(RED, text); end
+  def self.gray(text); color(GRAY, text); end
+  def self.dim(text); color(DIM, text); end
+end
+
+DIV = Colors.gray('─' * 60)
+
+def format_hadith(hadith, show_chapter: false)
+  output = []
+  output << Colors.bold("Hadith #{hadith.number}")
+  
+  if show_chapter
+    chapter = bukhari.chapters.find { |c| c.id == hadith.chapter_id }
+    output << Colors.cyan("Chapter #{chapter.id}: #{chapter.title}") if chapter
+  end
+  
+  output << ""
+  output << Colors.bold("Arabic:")
+  output << hadith.arabic
+  output << ""
+  output << Colors.bold("English:")
+  output << hadith.english
+  
+  output.join("\n")
+end
+
+def format_chapter(chapter)
+  output = []
+  output << Colors.bold("Chapter #{chapter.id}: #{chapter.title}")
+  output << Colors.dim(chapter.arabic_title)
+  output.join("\n")
+end
+
+def print_hadith(hadith, show_chapter: false)
+  puts DIV
+  puts format_hadith(hadith, show_chapter: show_chapter)
+  puts DIV
+  puts
+end
+
+def print_chapter(chapter)
+  puts DIV
+  puts format_chapter(chapter)
+  puts DIV
+  puts
+end
+
+def print_list(items, title)
+  puts Colors.bold("#{title} (#{items.length}):")
+  puts
+  items.each { |item| puts "  #{item}" }
+  puts
+end
+
+# Parse command line arguments
+options = {
+  number: nil,
+  chapter: nil,
+  search: nil,
+  random: false,
+  list_chapters: false,
+  metadata: false,
+  json: false,
+  chapter_info: false,
+  limit: 10
+}
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: bukhari [options]"
+  
+  opts.on("-n", "--number NUMBER", Integer, "Get specific hadith by number") do |n|
+    options[:number] = n
+  end
+  
+  opts.on("-c", "--chapter CHAPTER", Integer, "Get hadiths from specific chapter") do |c|
+    options[:chapter] = c
+  end
+  
+  opts.on("-s", "--search QUERY", "Search hadiths") do |q|
+    options[:search] = q
+  end
+  
+  opts.on("-r", "--random", "Get random hadith") do
+    options[:random] = true
+  end
+  
+  opts.on("-l", "--list-chapters", "List all chapters") do
+    options[:list_chapters] = true
+  end
+  
+  opts.on("-m", "--metadata", "Show collection metadata") do
+    options[:metadata] = true
+  end
+  
+  opts.on("-j", "--json", "Output as JSON") do
+    options[:json] = true
+  end
+  
+  opts.on("--chapter-info", "Show chapter info with hadiths") do
+    options[:chapter_info] = true
+  end
+  
+  opts.on("--limit LIMIT", Integer, "Limit search results (default: 10)") do |l|
+    options[:limit] = l
+  end
+  
+  opts.on("-v", "--version", "Show version") do
+    puts "bukhari #{VERSION}"
+    exit
+  end
+  
+  opts.on("-h", "--help", "Show this help") do
+    puts opts
+    puts
+    puts Colors.bold("Examples:")
+    puts "  bukhari -n 1                    # Get hadith #1"
+    puts "  bukhari -c 1                    # Get hadiths from chapter 1"
+    puts "  bukhari -s prayer               # Search for 'prayer'"
+    puts "  bukhari -r                      # Get random hadith"
+    puts "  bukhari -l                      # List chapters"
+    puts "  bukhari -m                      # Show metadata"
+    puts "  bukhari -s prayer --limit 5     # Search with limit"
+    puts "  bukhari -n 1 --json             # Output as JSON"
+    exit
+  end
+end
+
+begin
+  parser.parse!
+rescue OptionParser::InvalidOption => e
+  puts Colors.red("Error: #{e.message}")
+  puts parser
+  exit 1
+end
+
+# Initialize Bukhari instance
+begin
+  $bukhari = SahihAlBukhari::Bukhari.new
+rescue SahihAlBukhari::Error => e
+  puts Colors.red("Error: #{e.message}")
+  exit 1
+end
+
+# Execute commands
+if options[:number]
+  begin
+    hadith = $bukhari.get(options[:number])
+    if options[:json]
+      puts hadith.to_json
+    else
+      print_hadith(hadith, show_chapter: options[:chapter_info])
+    end
+  rescue SahihAlBukhari::HadithNotFoundError => e
+    puts Colors.red("Error: #{e.message}")
+    exit 1
+  end
+elsif options[:chapter]
+  begin
+    hadiths = $bukhari.get_by_chapter(options[:chapter])
+    if options[:json]
+      puts hadiths.map(&:to_h).to_json
+    else
+      chapter = $bukhari.chapters.find { |c| c.id == options[:chapter] }
+      if chapter
+        print_chapter(chapter)
+        puts Colors.bold("Hadiths in this chapter (#{hadiths.length}):")
+        puts
+      end
+      
+      hadiths.each { |h| print_hadith(h) }
+    end
+  rescue SahihAlBukhari::ChapterNotFoundError => e
+    puts Colors.red("Error: #{e.message}")
+    exit 1
+  end
+elsif options[:search]
+  results = $bukhari.search(options[:search])
+  limited_results = results.first(options[:limit])
+  
+  if options[:json]
+    puts limited_results.map(&:to_h).to_json
+  else
+    if results.empty?
+      puts Colors.yellow("No hadiths found for '#{options[:search]}'")
+    else
+      puts Colors.bold("Found #{results.length} hadith(s) matching '#{options[:search]}'")
+      puts Colors.dim("Showing first #{limited_results.length}:") if results.length > options[:limit]
+      puts
+      
+      limited_results.each { |h| print_hadith(h) }
+    end
+  end
+elsif options[:random]
+  hadith = $bukhari.get_random
+  if options[:json]
+    puts hadith.to_json
+  else
+    print_hadith(hadith, show_chapter: options[:chapter_info])
+  end
+elsif options[:list_chapters]
+  if options[:json]
+    puts $bukhari.chapters.map(&:to_h).to_json
+  else
+    puts Colors.bold("Chapters in Sahih al-Bukhari:")
+    puts
+    $bukhari.chapters.each { |c| print_chapter(c) }
+  end
+elsif options[:metadata]
+  if options[:json]
+    puts $bukhari.metadata.to_h.to_json
+  else
+    puts Colors.bold("Sahih al-Bukhari Collection Metadata:")
+    puts
+    metadata = $bukhari.metadata
+    puts "  Total Hadiths: #{Colors.green(metadata.total_hadiths.to_s)}"
+    puts "  Total Chapters: #{Colors.green(metadata.total_chapters.to_s)}"
+    puts "  Language: #{Colors.cyan(metadata.language)}"
+    puts "  Source: #{Colors.dim(metadata.source)}"
+    puts
+  end
+else
+  # Default: show help
+  puts parser
+  puts Colors.bold("Quick start:")
+  puts "  bukhari -r                      # Get a random hadith"
+  puts "  bukhari -s prayer               # Search for hadiths about prayer"
+  puts "  bukhari -l                      # List all chapters"
+end

data/lib/sahih_al_bukhari/bukhari.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+# sahih-al-bukhari — Complete Sahih al-Bukhari for Ruby.
+#
+# Quick start:
+#   require 'sahih_al_bukhari'
+#
+#   bukhari = SahihAlBukhari::Bukhari.new
+#   bukhari.get(1)
+#   bukhari.search("prayer")
+#   bukhari.get_random
+#   bukhari.get_by_chapter(1)
+
+require 'json'
+require 'zlib'
+require 'net/http'
+require 'uri'
+require 'fileutils'
+require 'tmpdir'
+
+require_relative 'version'
+
+module SahihAlBukhari
+  CDN_URL = "https://cdn.jsdelivr.net/npm/sahih-al-bukhari@#{VERSION}/data/bukhari.json.gz"
+
+  # Locate the shared data file relative to the gem root.
+  # Layout (installed gem):  lib/sahih_al_bukhari/bukhari.rb
+  #                          data/bukhari.json.gz          ← same gem root
+  # Layout (monorepo dev):   ruby/lib/sahih_al_bukhari/bukhari.rb
+  #                          data/bukhari.json.gz          ← repo root
+  _LIB_DIR  = File.expand_path('..', __dir__)        # …/ruby/lib
+  _GEM_ROOT = File.expand_path('..', _LIB_DIR)       # …/ruby  (installed: gem root)
+  _REPO_ROOT = File.expand_path('..', _GEM_ROOT)     # …/      (monorepo root)
+
+  INSTALLED_DATA = File.join(_GEM_ROOT,  'data', 'bukhari.json.gz')
+  REPO_DATA_GZ   = File.join(_REPO_ROOT, 'data', 'bukhari.json.gz')
+  REPO_DATA_JSON = File.join(_REPO_ROOT, 'data', 'bukhari.json')
+
+  # ---------------------------------------------------------------------------
+  class Error              < StandardError; end
+  class HadithNotFoundError  < Error;       end
+  class ChapterNotFoundError < Error;       end
+
+  # ---------------------------------------------------------------------------
+  # Data structures
+  # ---------------------------------------------------------------------------
+
+  class Hadith
+    # FIX: JSON uses keys "id" and "chapterId", NOT "number" / "chapter_id".
+    # All accesses in the original code used the wrong key names, so every
+    # hadith came back with nil fields.
+    attr_reader :id, :number, :arabic, :english, :chapter_id
+
+    def initialize(data)
+      @id         = data['id']
+      @number     = data['id']          # alias kept for backward compat
+      @chapter_id = data['chapterId']
+      @arabic     = data['arabic'] || ''
+      _en         = data['english'] || {}
+      # english field is a Hash {"narrator"=>..., "text"=>...}
+      @english    = _en
+      @narrator   = _en['narrator'] || ''
+      @text       = _en['text']     || ''
+    end
+
+    def narrator = @narrator
+    def text     = @text
+
+    def to_h
+      {
+        id:         @id,
+        number:     @number,
+        arabic:     @arabic,
+        english:    @english,
+        chapter_id: @chapter_id
+      }
+    end
+
+    def to_json(*args) = to_h.to_json(*args)
+
+    def inspect
+      preview = @text.length > 60 ? "#{@text[0, 60]}…" : @text
+      "#<Hadith id=#{@id} chapterId=#{@chapter_id} text=#{preview.inspect}>"
+    end
+  end
+
+  # ---------------------------------------------------------------------------
+
+  class Chapter
+    # FIX: JSON uses keys "english" and "arabic" for the title strings.
+    # Original code passed "title" / "arabic_title" which don't exist in the data.
+    attr_reader :id, :title, :arabic_title
+
+    def initialize(data)
+      @id           = data['id']
+      @title        = data['english'] || ''   # FIX: key is "english", not "title"
+      @arabic_title = data['arabic']  || ''   # FIX: key is "arabic", not "arabic_title"
+    end
+
+    def to_h
+      { id: @id, title: @title, arabic_title: @arabic_title }
+    end
+
+    def to_json(*args) = to_h.to_json(*args)
+    def inspect = "#<Chapter id=#{@id} title=#{@title.inspect}>"
+  end
+
+  # ---------------------------------------------------------------------------
+
+  class Metadata
+    # FIX: the actual JSON has a completely different metadata structure:
+    #   { "id": 1, "length": 7277, "arabic": {...}, "english": {...} }
+    # The original code expected flat keys like "total_hadiths", "language",
+    # "source" — none of which exist — so metadata was always nil/broken.
+    attr_reader :total_hadiths, :total_chapters, :language, :source,
+                :arabic, :english
+
+    def initialize(data, total_chapters)
+      @total_hadiths  = data['length'] || 0
+      @total_chapters = total_chapters
+      @arabic         = data['arabic']  || {}
+      @english        = data['english'] || {}
+      @language       = 'Arabic / English'
+      @source         = @english['title'] || 'Sahih al-Bukhari'
+    end
+
+    def to_h
+      {
+        total_hadiths:  @total_hadiths,
+        total_chapters: @total_chapters,
+        language:       @language,
+        source:         @source,
+        arabic:         @arabic,
+        english:        @english
+      }
+    end
+
+    def to_json(*args) = to_h.to_json(*args)
+  end
+
+  # ---------------------------------------------------------------------------
+  # Main Bukhari class
+  # ---------------------------------------------------------------------------
+
+  class Bukhari
+    include Enumerable
+
+    attr_reader :metadata, :chapters, :length
+
+    def initialize(data_path: nil)
+      path  = data_path || find_data_file
+      raw   = load_raw(path)
+
+      @chapters = raw['chapters'].map { |c| Chapter.new(c) }
+      @metadata = Metadata.new(raw['metadata'], @chapters.length)
+      # Build Hadith objects and an O(1) lookup map
+      @hadiths  = raw['hadiths'].map { |h| Hadith.new(h) }
+      @by_id    = @hadiths.each_with_object({}) { |h, m| m[h.id] = h }
+      @length   = @hadiths.length
+    end
+
+    # ── Public API ────────────────────────────────────────────────────────────
+
+    # Get a hadith by its global id (1-based, matches the JSON "id" field).
+    def get(id)
+      @by_id[id] || raise(HadithNotFoundError, "Hadith #{id} not found")
+    end
+
+    # All hadiths belonging to chapter_id.
+    def get_by_chapter(chapter_id)
+      unless @chapters.any? { |c| c.id == chapter_id }
+        raise ChapterNotFoundError, "Chapter #{chapter_id} not found"
+      end
+      @hadiths.select { |h| h.chapter_id == chapter_id }
+    end
+
+    # Full-text search across English text + narrator. Case-insensitive.
+    # FIX: original called String#downcase on the `english` field which is a
+    # Hash, not a String — that raised NoMethodError at runtime.
+    def search(query)
+      q = query.downcase
+      @hadiths.select do |h|
+        h.text.downcase.include?(q) || h.narrator.downcase.include?(q) ||
+          h.arabic.downcase.include?(q)
+      end
+    end
+
+    def get_random
+      @hadiths.sample
+    end
+
+    # Array-like index access (0-based).
+    def [](index)
+      @hadiths[index]
+    end
+
+    # Enumerable — lets callers use .map, .select, .each, .first, etc.
+    def each(&block)
+      @hadiths.each(&block)
+    end
+
+    def to_a
+      @hadiths.dup
+    end
+
+    # ── Private helpers ───────────────────────────────────────────────────────
+    private
+
+    def find_data_file
+      candidates = [INSTALLED_DATA, REPO_DATA_GZ, REPO_DATA_JSON]
+      candidates.find { |p| File.exist?(p) } || download_from_cdn
+    end
+
+    def load_raw(path)
+      data = if path.end_with?('.gz')
+               Zlib::GzipReader.open(path) { |gz| gz.read }
+             else
+               File.read(path, encoding: 'utf-8')
+             end
+      JSON.parse(data)
+    rescue => e
+      raise Error, "Failed to load data from #{path}: #{e.message}"
+    end
+
+    def download_from_cdn
+      # FIX: original hard-coded 'C:\temp' — use Ruby's cross-platform tmpdir
+      dest = File.join(Dir.tmpdir, 'bukhari.json.gz')
+      return dest if File.exist?(dest)
+
+      warn "[sahih-al-bukhari] Downloading data from CDN (one-time) …"
+      uri = URI(CDN_URL)
+      Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        resp = http.get(uri.request_uri)
+        raise Error, "CDN returned HTTP #{resp.code}" unless resp.is_a?(Net::HTTPSuccess)
+        File.binwrite(dest, resp.body)
+      end
+      dest
+    rescue => e
+      raise Error, "Failed to download data from CDN: #{e.message}"
+    end
+  end
+
+  # Clear any cached data (no-op in current implementation, kept for API compat)
+  def self.clear_cache; end
+end

data/lib/sahih_al_bukhari/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module SahihAlBukhari
+  # FIX: gemspec referenced SahihAlBukhari::Version::VERSION (a nested module that
+  # never existed).  The constant must live directly in SahihAlBukhari so that both
+  # the gemspec and sahih_al_bukhari.rb agree on its location.
+  VERSION = '3.1.2'
+end

data/lib/sahih_al_bukhari.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# FIX: the original file contained only:
+#   require_relative '../sahih_al_bukhari'
+# which tried to load ruby/sahih_al_bukhari.rb via a relative path that breaks
+# once the gem is installed (the installed gem's require_paths is ['lib'], so
+# `require 'sahih_al_bukhari'` resolves to THIS file, not the root-level one).
+#
+# The correct approach: this IS the library entry point.  Load version first,
+# then the main implementation file that lives alongside it.
+
+require_relative 'sahih_al_bukhari/version'
+require_relative 'sahih_al_bukhari/bukhari'

data/sahih_al_bukhari.gemspec

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'lib/sahih_al_bukhari/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'sahih-al-bukhari'
+  spec.version       = SahihAlBukhari::VERSION   # FIX: was SahihAlBukhari::Version::VERSION (wrong namespace)
+  spec.authors       = ['muhammadsaadamin']
+  spec.email         = ['muhammadsaadamin@example.com']
+
+  spec.summary       = 'Complete Sahih al-Bukhari — 7,277 hadiths. Offline-first, zero dependencies. CLI + Ruby library.'
+  spec.description   = 'Complete Sahih al-Bukhari collection with 7,277 authentic hadiths featuring full Arabic text and English translations. Offline-first with zero external dependencies. Includes both Ruby library and command-line interface.'
+  spec.homepage      = 'https://github.com/SENODROOM/sahih-al-bukhari'
+  spec.license       = 'AGPL-3.0'
+  spec.required_ruby_version = '>= 2.7.0'
+
+  # FIX: spec.metadata must be assigned ONCE — previous code assigned it twice,
+  # which silently overwrote the first assignment (losing allowed_push_host etc.)
+  spec.metadata = {
+    'allowed_push_host'   => 'https://rubygems.org',
+    'homepage_uri'        => 'https://github.com/SENODROOM/sahih-al-bukhari',
+    'source_code_uri'     => 'https://github.com/SENODROOM/sahih-al-bukhari',
+    'changelog_uri'       => 'https://github.com/SENODROOM/sahih-al-bukhari/blob/main/CHANGELOG.md',
+    'bug_tracker_uri'     => 'https://github.com/SENODROOM/sahih-al-bukhari/issues',
+    'rubygems_mfa_required' => 'true'
+  }
+
+  # FIX: `git ls-files` fails when building outside a git worktree (e.g. CI unshallow
+  # clone, or after `gem build` in a temp directory).  Use Dir.glob instead so the
+  # file list is always reliable.
+  spec.files = Dir.chdir(__dir__) do
+    Dir.glob('{bin,lib,data}/**/*', File::FNM_DOTMATCH)
+       .reject { |f| File.directory?(f) }
+       .concat(%w[README.md LICENSE sahih_al_bukhari.gemspec])
+       .select  { |f| File.exist?(f) }
+  end
+
+  spec.bindir        = 'bin'
+  spec.executables   = ['bukhari']
+  spec.require_paths = ['lib']
+
+  # Development dependencies
+  spec.add_development_dependency 'rake',      '~> 13.0'
+  spec.add_development_dependency 'test-unit', '~> 3.6'   # FIX: removed from Ruby 4.0 stdlib
+  spec.add_development_dependency 'rspec',     '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 1.21'
+  spec.add_development_dependency 'yard',    '~> 0.9'
+
+  # FIX: spec.has_rdoc and spec.test_files are both deprecated and raise warnings
+  # on modern RubyGems — removed entirely.
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: sahih-al-bukhari
+version: !ruby/object:Gem::Version
+  version: 3.1.2
+platform: ruby
+authors:
+- muhammadsaadamin
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Complete Sahih al-Bukhari collection with 7,277 authentic hadiths featuring
+  full Arabic text and English translations. Offline-first with zero external dependencies.
+  Includes both Ruby library and command-line interface.
+email:
+- muhammadsaadamin@example.com
+executables:
+- bukhari
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/bukhari
+- data/bukhari.json.gz
+- lib/sahih_al_bukhari.rb
+- lib/sahih_al_bukhari/bukhari.rb
+- lib/sahih_al_bukhari/version.rb
+- sahih_al_bukhari.gemspec
+homepage: https://github.com/SENODROOM/sahih-al-bukhari
+licenses:
+- AGPL-3.0
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/SENODROOM/sahih-al-bukhari
+  source_code_uri: https://github.com/SENODROOM/sahih-al-bukhari
+  changelog_uri: https://github.com/SENODROOM/sahih-al-bukhari/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/SENODROOM/sahih-al-bukhari/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Complete Sahih al-Bukhari — 7,277 hadiths. Offline-first, zero dependencies.
+  CLI + Ruby library.
+test_files: []