isnady 0.3.5 → 0.3.7

package/README.md

@@ -8,12 +8,12 @@
 
 <p align="center">
   <a href="https://pypi.org/project/isnady/">
-    <img src="https://img.shields.io/badge/PyPI-v0.3.5-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
+    <img src="https://img.shields.io/badge/PyPI-v0.3.7-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
   </a>
   <img src="https://img.shields.io/pypi/pyversions/isnady?style=for-the-badge&color=A47E24&logo=python&logoColor=white" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-5B6878?style=for-the-badge" alt="Platform">
   <a href="https://www.npmjs.com/package/isnady">
-    <img src="https://img.shields.io/badge/npm-v0.3.5-14304F?style=for-the-badge&logo=npm" alt="npm">
+    <img src="https://img.shields.io/badge/npm-v0.3.7-14304F?style=for-the-badge&logo=npm" alt="npm">
   </a>
   <a href="https://github.com/bayramkotan/isnady-data">
     <img src="https://img.shields.io/badge/data-isnady--data-2E6B4F?style=for-the-badge&logo=github" alt="isnady-data">
@@ -45,7 +45,7 @@
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/search-arabic.png" alt="Searching النيات finds بالنيات in Sahih al-Bukhari 1, with the chain above the text" width="850">
 </p>
 
-> **Pre-alpha (0.3.5).** Search, chains of transmission, narrators, books, scholars, statistics and
+> **Pre-alpha (0.3.7).** Search, chains of transmission, narrators, books, scholars, statistics and
 > the glossary work today, Sunni and Shia, on data you import in one click. Everything is built in
 > the open, one piece at a time.
 
@@ -521,6 +521,15 @@ the first where they meet, never read on as one; a road begun again without a si
 there. And two neighbours that cannot both be right — a narrator his own teacher, a teacher four generations after
 his student or six before him — are not left so: the less certain of the two is left unidentified.
 
+**The famous ones, however they are written.** ★ **Famous Companions** on the Narrators page and in the Genealogies
+lists them group by group — the four Caliphs, the ten promised Paradise, the Mothers of the Believers, the Prophet's
+household, those who narrated most and some forty more (`iy narrator --famous`); on road B, the Imami scholars' own
+Ashab al-Ijma'. Typed, a famous Companion comes first whichever way he is written — "Ebubekir", "Ebû Bekr",
+"Abu Bakr", "Hz. Ömer", "Omer ibn Hattap", "Umar bin Khattab", "Osman", "Uthman", "Ayşe", "Aisha", أبو بكر الصديق —
+shown by the name people know him by ("Hz. Ebû Bekir es-Sıddîk (r.a.)": his entry begins with 'Abd Allah b.
+'Uthman), and every name found carries its tabaqa and death year, so 'Umar b. al-Khattab the Caliph is not mistaken
+for the two later men of that name.
+
 Sunni narrators filter by tabaqa, rank and book; Shia narrators by the Imami assessment.
 
 <p align="center">
@@ -582,7 +591,7 @@ The scholars whose work is in the imported data, and what the data measures of i
 (how they grade, and how far they agree with each other on the same hadith — agreement, Cohen's
 kappa, and a strictness index: the classical *mutashaddid* / *mutasahil*, measured), and **critics**
 of narrators — each with **his life** (the same written lives as on Narrators) — Sunni and Shia on one
-page (*All / Sunni / Shia*), each by his own road: al-Kulayni,
+page (*All / Sunni / Shia*; Narrators, Books and Scholars open on *Sunni*), each by his own road: al-Kulayni,
 al-Saduq, al-Mufid and al-Tusi with their chains counted to a Ma'sum; al-Majlisi and al-Behbudi compared
 only with each other on the four Imami grades (sahih, hasan, muwaththaq, da'if); al-Najashi's verdicts in
 the Imami terms. On Sunan Abi Dawud, for example, Zubair 'Ali Za'i grades most strictly (−0.21) and
@@ -848,9 +857,9 @@ command line never loads Qt. Every command that takes a book accepts its full na
 | `iy search WORDS` | `iy search niyet --book abudawud` | Search; `--mode all\|any\|phrase\|meaning`, `--whole-words`, `--book`, `--language`, `--limit`; `--in narrators\|scholars`, `--tradition sunni\|shia`; `--recent`, `--clear-recent` |
 | `iy chain BOOK NUMBER` | `iy chain kafi 5:1740` | One chain, narrator by narrator, with who each one is and whom it reaches; `--raw` adds the wording; without a number, the book's range |
 | `iy isnads` | `iy isnads --rebuild` | Read every chain and report per book: split, reaching the Prophet or a Ma'sum, identified |
-| `iy narrator NAME` | `iy narrator "Ibn Umar"` | A narrator: his critic's verdict (Ibn Hajar's rank, or the Imami terms), tabaqa, death year, books; `--limit 1` adds teachers, students and hadith |
-| `iy book [KEY [CHAPTER]]` | `iy book bukhari 2` | The books; a book's chapters; a chapter read in order |
-| `iy scholar [NAME]` | `iy scholar albani` | The scholars in the data, or one of them with his measured statistics |
+| `iy narrator NAME` | `iy narrator "Ibn Umar"` | A narrator: his critic's verdict (Ibn Hajar's rank, or the Imami terms), tabaqa, death year, books; `--limit 1` adds teachers, students and hadith; `--famous` lists the famous Companions by group (`--tradition shia`: Ashab al-Ijma'; `all`: both) |
+| `iy book [KEY [CHAPTER]]` | `iy book bukhari 2` | The books (the Sunni ones; `--tradition shia` or `all`); a book's chapters; a chapter read in order |
+| `iy scholar [NAME]` | `iy scholar albani` | The scholars in the data (the Sunni ones; `--tradition shia` or `all`), or one of them with his measured statistics |
 | `iy tahric BOOK NUMBER` | `iy tahric bukhari 1` | Other narrations of a hadith in the imported books (takhrij) |
 | `iy stats [SECTION]` | `iy stats graders --book abudawud` | `corpus`, `narrators`, `chains`, `grades`, `books`, `graders`, `model`, `lab`; `--csv DIR`, `--recompute`; `--book @all` measures both roads |
 | `iy term [NAME]` | `iy term --search tadlis` | The glossary, English, Turkish or Arabic (`--lang tr`, `--lang ar`) |

package/index.js

@@ -6,7 +6,7 @@
  * database (used by both the Python and JavaScript packages) exists.
  */
 
-export const version = "0.3.5";
+export const version = "0.3.7";
 export const name = "isnady";
 
 /** Returns basic package information. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isnady",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Hadith search with full isnad chains, narrator biographies, jarh wa ta'dil verdicts and reliability scores",
   "type": "module",
   "main": "./index.js",