wahy 2.0.5 → 2.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d853de63838d3a32095161363dd188cb718bd98e1e7b8ac44db9d31b768210a
-  data.tar.gz: 921a91ff83817d791b6a393531fe8da4abd0349689ecdc307aa57016d5630be2
+  metadata.gz: a464603f9dc3bd456c8e2abb036f8960180022f4780b55456d08bc902d509cc2
+  data.tar.gz: dc613b0c8d233033c7a4c99e16d9a1834975d74fe85c9e7118bfd1f5edaf6c57
 SHA512:
-  metadata.gz: 224f3ad775efc37663370d8669c47f1a44e925159fb12cdd46239348a3babf09557c78231b55bc34bfd6a503fc7a5b15ab475c2b2bd9c23a590056004f205603
-  data.tar.gz: cd8cf7d256f9c7a76ff01600dea4e96750e1b10eed9da5cada6ccae8ad45d9ad7524b4a217b128575ffc6f0cd186dbbdfd45a1d66d8483b3ca5316d8328210a9
+  metadata.gz: bcd24fc1ed36354b8a39936f2eb46e0f80b6a87d8f0ee8a2104e864880d44aba011ce6482cb53fef8cc4d600140e52146f21f765ad5958cbe18c59ba10c4ffd9
+  data.tar.gz: 8b830196da3e6fb84894355832b156f28f760c5ffad428c722979ec8d80a07a547b636aa10d821261740e0bd0ed2c00408afa889151a887f224390a42ba39187

data/README.md

@@ -52,6 +52,7 @@ You can use the wahy command directly in your terminal. By default, it displays
 | `-l` | `--lang` | Language selection (`tur` or `eng`) | `eng` |
 | `-s` | `--scripture` | Chapter name or number (1-114) | `1` |
 | `-a` | `--ayah` | Specific verse number or 'all' | `all` |
+| - | `--list-chapters` | List all chapters in a clean table format | - |
 | `-h` | `--help` | Show help menu | - |
 
 Examples
@@ -77,7 +78,40 @@ wahy -l tur -s <chapter_number> -a <verse_number>
 wahy -s <chapter_mame_or_number> -a <verse_number>
 ```
 
-Save output to a file:
+List all chapters in Turkish:
+
+```bash
+# List all chapters in English (default)
+wahy --list-chapters
+
+# List all chapters in Turkish
+wahy --list-chapters -l tur
+```
+## Listing Chapters (`--list-chapters`)
+
+The `--list-chapters` feature acts as an interactive built-in index for the Quranic data files. It provides users with a clean, well-aligned terminal table showing the exact `ID` and `Chapter Name` mappings for the selected language.
+
+### Key Benefits:
+1. **Dynamic Language Switch:** Specifying `-l 'tur'` or `-l 'eng'` alongside `--list-chapters` automatically switches the content of the index table to that specific translation file.
+2. **Short-Circuit Execution:** When this flag is triggered, the program instantly renders the table and exits securely, avoiding any unnecessary XML traversing or verse filtering overhead.
+3. **Formatted UI Output:** Utilizing explicit string formatting rules ensures that all tabular column lines down the terminal remain perfectly aligned regardless of varying chapter name lengths.
+
+### Example Output:
+```text
+==================================================
+            QURAN CHAPTERS (TURKISH)             
+==================================================
+ID         | CHAPTER NAME                       
+--------------------------------------------------
+1          | Fatiha                             
+2          | Bakara                             
+3          | Âl-i İmrân                         
+...
+114        | Nas                                
+==================================================
+```
+
+## Save output to a file:
 
 ```bash
 wahy -s <chapter_name_or_number> -a <verse_number> > output.txt

data/lib/wahy/cli.rb

@@ -1,89 +1,134 @@
+# lib/wahy/cli.rb
 require 'optparse'
 require 'colorize'
 
 module Wahy
   class CLI
     def self.start(args)
-      # Set default options
-      options = { lang: 'eng', scripture: '1', ayah: 'all' }
+      options = {
+        lang: 'eng',
+        scripture: '1',
+        ayah: 'all',
+        list_chapters: false # Yeni: Listeleme seçeneği varsayılan olarak kapalı
+      }
 
       opt_parser = OptionParser.new do |opts|
         opts.banner = "Usage: wahy [options]"
 
-        opts.on("-l", "--lang LANGUAGE", "Language selection ('tur' or 'eng') - Default: eng") do |l|
+        opts.on("-l", "--lang LANG", "Pick language ('eng'|'tur' or 'en'|'tr') [Default: eng]") do |l|
           options[:lang] = l
         end
 
-        opts.on("-s", "--scripture SCRIPTURE", "Chapter name or ID (1-114) - Default: 1") do |s|
+        opts.on("-s", "--scripture SCRIPTURE", "Pick scripture name or number (1-114) [Default: 1]") do |s|
           options[:scripture] = s
         end
 
-        opts.on("-a", "--ayah AYAH", "Sign/Verse number or 'all' - Default: all") do |a|
+        opts.on("-a", "--ayah AYAH", "Pick sign/ayah number or 'all' [Default: all]") do |a|
           options[:ayah] = a
         end
 
-        opts.on("-h", "--help", "Prints this help") do
+        # Yeni: Sadece sureleri listelemek için argüman
+        opts.on("--list-chapters", "List all chapters in a table format for the selected language") do
+          options[:list_chapters] = true
+        end
+
+        opts.on("-h", "--help", "Prints this help menu") do
           puts opts
           exit
         end
       end
 
-      opt_parser.parse!(args)
-
       begin
-        # Fetch Data
-        doc = Wahy.new_data(options[:lang])
-        chapters = Wahy.chapters_data(doc)
-        chapter = Wahy.scripture_data(chapters, options[:scripture])
+        opt_parser.parse!(args)
+      rescue OptionParser::InvalidOption, OptionParser::MissingArgument => e
+        puts "CLI Error: #{e.message}".red
+        puts opt_parser
+        exit 1
+      end
 
-        if chapter.nil?
-          puts "Error: Scripture '#{options[:scripture]}' not found.".colorize(:red)
-          exit 1
-        end
+      run(options)
+    end
 
-        # Header preparation
-        chapter_id = chapter['ChapterID']
-        chapter_name = chapter['ChapterName']
-        title = "#{chapter_id}. #{chapter_name}"
+    def self.run(options)
+      begin
+        data = Wahy.new_data(options[:lang])
+      rescue => e
+        puts "Error: #{e.message}".red
+        exit 1
+      end
 
-        # Get terminal width for centering (fallback to 80 if it fails)
-        term_width = `tput cols`.to_i rescue 80
-        term_width = 80 if term_width == 0
+      quran = Wahy.chapters_data(data)
 
-        # Print centered and colored header
-        puts "\n"
-        puts title.center(term_width).colorize(:green).bold
-        puts ("=" * title.length).center(term_width).colorize(:green)
-        puts "\n"
+      # Eğer list-chapters bayrağı tetiklendiyse, tabloyu çiz ve programı sonlandır
+      if options[:list_chapters]
+        display_chapter_list(quran, options[:lang])
+        exit
+      end
 
-        signs = Wahy.sign_data(chapter)
+      # Listeleme istenmediyse normal okuma akışına devam et
+      chapter_node = Wahy.scripture_data(quran, options[:scripture])
 
-        # Print verses
-        if options[:ayah].to_s.downcase == 'all'
-          signs.each { |sign| print_sign(sign) }
+      unless chapter_node
+        puts "Error: Scripture '#{options[:scripture]}' could not be found.".red
+        exit 1
+      end
+
+      chapter_id = chapter_node['ChapterID']
+      chapter_name = chapter_node['ChapterName']
+      verses = chapter_node.xpath('Verse')
+
+      selected_verses = []
+      if options[:ayah].to_s.downcase == 'all'
+        selected_verses = verses
+      else
+        target_ayah = options[:ayah].to_s
+        match = verses.find { |v| v['VerseID'] == target_ayah }
+        if match
+          selected_verses = [match]
         else
-          sign = Wahy.take_specific_sign(signs, options[:ayah])
-          if sign.nil?
-            puts "Error: Ayah '#{options[:ayah]}' not found in this scripture.".colorize(:red)
-          else
-            print_sign(sign)
-          end
+          puts "Error: Ayah ##{target_ayah} not found in Chapter #{chapter_id} (#{chapter_name}).".red
+          exit 1
         end
-        puts "\n"
-      rescue => e
-        puts "An error occurred: #{e.message}".colorize(:red)
-        exit 1
       end
+
+      terminal_width = 75
+      puts "=" * terminal_width
+      header_title = "Chapter #{chapter_id}: #{chapter_name}"
+      puts header_title.center(terminal_width).upcase.cyan.bold
+      puts "=" * terminal_width
+      puts ""
+
+      selected_verses.each do |v|
+        verse_id = v['VerseID']
+        verse_text = v.text.strip
+
+        print "[#{verse_id}] ".green.bold
+        puts verse_text.white
+        puts ""
+      end
+      puts "=" * terminal_width
     end
 
-    private
+    # Yeni: Sureleri tablo halinde terminale basan yardımcı metod
+    def self.display_chapter_list(chapters, lang)
+      lang_display = lang.to_s.downcase.start_with?('t') ? "TURKISH" : "ENGLISH"
+
+      puts "=" * 50
+      puts " QURAN CHAPTERS (#{lang_display}) ".center(50).cyan.bold
+      puts "=" * 50
+
+      # Sütun başlıkları: Sola dayalı 10 karakter ID, sola dayalı 35 karakter İsim
+      puts sprintf("%-10s | %-35s", "ID", "CHAPTER NAME").yellow.bold
+      puts "-" * 50
+
+      chapters.each do |c|
+        id = c['ChapterID']
+        name = c['ChapterName']
+        # Sütun verilerini hizalayarak yazdır
+        puts sprintf("%-10s | %-35s", id, name)
+      end
 
-    # Helper method to print a single verse
-    def self.print_sign(sign)
-      verse_id = sign['VerseID']
-      # CDATA text parsing and whitespace stripping
-      text = sign.text.strip
-      puts "[#{verse_id}] ".colorize(:cyan).bold + text
+      puts "=" * 50
     end
   end
 end

data/lib/wahy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wahy
-  VERSION = "2.0.5"
+  VERSION = "2.0.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wahy
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 2.0.7
 platform: ruby
 authors:
 - cptangry