isnady 0.3.1 → 0.3.3

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.1-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
+    <img src="https://img.shields.io/badge/PyPI-v0.3.3-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.1-14304F?style=for-the-badge&logo=npm" alt="npm">
+    <img src="https://img.shields.io/badge/npm-v0.3.3-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.1).** Search, chains of transmission, narrators, books, scholars, statistics and
+> **Pre-alpha (0.3.3).** 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.
 
@@ -204,9 +204,11 @@ administrator prompt on Windows). If an old copy starts even for `iy update`, ru
 
 ## 🚀 Quick Start
 
-1. **Open isnady** — `iy`, or the desktop application.
+1. **Open isnady** — `iy`, or the desktop application. The first time, with no books yet, it offers to import
+   isnady-data at once, in the background.
 2. **File → Data Sources.** The repository is already chosen: **isnady-data**. Tick the books and
-   the languages you want and press **Import** — or **Import all**.
+   the languages you want and press **Import** — or **Import all**. **Languages for every book** adds a language to
+   all the books that have it (or takes it out of all of them) in one step.
 3. **Import the narrators too** — Ibn Hajar's *Taqrib* for the Sunni books, al-Najashi's *Rijal*
    for the Shia books — and every name in every chain is matched to its narrator.
 4. **Search**, open a chain, open a narrator, read a book.
@@ -336,10 +338,12 @@ without authentication (credentials are never stored), are read as well.
 | **Pasted passages** | Punctuation and quotation marks clinging to the words do not matter |
 | **Books** | All books, all Sunni, all Shia, or any few ticked one by one |
 | **Order** | Book by book in the order of the book lists — Sahih al-Bukhari, Sahih Muslim, Sunan Abi Dawud … then the Shia books — and within a book by its numbering |
-| **Language** | One language to search in; the languages you do not read are folded behind an arrow on each hadith, a click opens them. The list holds the languages imported; the languages the same books have in isnady-data (Urdu, Indonesian, Bengali, French, Russian, Tamil) are named at its end — choosing them opens **File → Data Sources** to import them |
+| **Language** | One language or several to search in — tick them in the list (Arabic and Turkish, say); the languages you do not read are folded behind an arrow on each hadith, a click opens them. The list holds the languages imported; the languages the same books have in isnady-data (Urdu, Indonesian, Bengali, French, Russian, Tamil) are named at its end — choosing them opens **File → Data Sources** to import them |
 | **Active books** | A book can be switched off in **Settings → Books and languages**: it stays imported but is left out of searches, book lists and statistics until switched on |
 | **Grades** | Shown under each hadith with the scholar's name, exactly as given, and explained when you point at them |
 | **Highlighting** | On the original, diacritised text, diacritics included |
+| **Recent searches** | The last twenty, under the examples on the start page — a click searches again, one link forgets them all; kept with your profile. `iy search --recent`, `iy search --clear-recent` |
+| **Home** | ⌂ beside the box (Alt+Home) brings the page back to how it opens: no words, every filter at its default. Esc empties the box |
 | **Narrators and scholars** | The same box finds narrators — Sunni and Shia, each marked — and scholars, by Arabic or Latin name |
 
 Results appear at once and fill in as you read; the window never waits for them.
@@ -371,7 +375,13 @@ Sahih al-Bukhari 1
 In the window, each result shows its chain as a row of names ending at whom it reaches, and
 **View chain** opens it as a timeline from the book to the Prophet ﷺ — or, in a Shia book, to the
 Imam — with the Arabic text below: the chain in lighter ink, the text of the hadith in full ink.
-Every link says who the narrator is and what his critic says of him; a click opens him.
+Every link says who the narrator is and what his critic says of him; a click opens him, and pointing at him says
+how he was identified (by his name, by the narrators around him, or as the famous one of that name).
+
+Choose a book and a number, or let isnady choose: the number field shows the book's range ("1 – 7563 · 7,583
+hadith"), the arrow keys and the mouse wheel go to the next or the previous hadith, typing lists the numbers that
+begin so, a number the book does not have offers the nearest, and **Random hadith** picks one. `iy chain kafi`
+prints the range.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/chain.png" alt="Isnad Chains — the chain of Sahih al-Bukhari 1 as a timeline from the book to the Prophet" width="850">
@@ -475,11 +485,25 @@ The **Narrators** page lists every narrator of the imported rijal works — **Al
 - what his critic says, in the critic's own words: Ibn Hajar's verdict and its rank for a Sunni
   narrator; al-Najashi's words, reliability and creed for a Shia narrator — the entry as written one
   click away;
+- **the entry of the classical work beside the life written for isnady**: for 109 of the written lives, al-Dhahabi's
+  *Siyar A'lam al-Nubala'* in its own words — "vol. 2, no. 126" for Abu Hurayra — downloaded once on request (about
+  22 MB, from OpenITI) and kept in your data folder; the Prophet's life ﷺ points to Ibn Hisham's *Sira* and to
+  al-Tirmidhi's *al-Shama'il* in isnady;
 - tabaqa and death year, the books his hadith appear in (Ibn Hajar's marks);
 - **whom he narrates from and who narrates from him** in the imported chains, and the compilers who
   narrate from him directly;
 - every hadith whose chain includes him, each a click from its chain.
 
+**Who a name in a chain is.** A chain names its men as the narrators named each other — "Ibrahim", "Abu Ishaq",
+"al-Hasan" — and isnady reads each name against the Taqrib (or al-Najashi on road B) by the name itself, the
+generation, the books, and then by its neighbours: whom the same pair of teacher and student is in the chains where
+they are named in full; a client named "mawla of X" by his patron; the well-known men a bare name means in a given
+circle (Ibrahim from 'Alqama is al-Nakha'i, Abu Ishaq from al-Bara' is al-Sabi'i, al-Humaydi's Sufyan is Ibn
+'Uyayna, Abu Nu'aym's al-Thawri, "Hisham from his father" Hisham b. 'Urwa); and last, a bare name still open is the
+famous man of that name when nothing else excludes him ("Anas" Anas b. Malik, "Malik" Malik b. Anas, "Ibn 'Umar"
+'Abd Allah b. 'Umar). The unnamed men of the Taqrib ("'Ata' b. Yasar from one of the Companions") are never matched
+to a name. About 262,000 links are identified this way — two of every three in the Sunni chains.
+
 Sunni narrators filter by tabaqa, rank and book; Shia narrators by the Imami assessment.
 
 <p align="center">
@@ -511,7 +535,9 @@ itself, two levels deep, from the editions in OpenITI: the Musnad in its 13 part
 Household of the Prophet ﷺ, the Companions who narrated most, the Companions of Mecca, Medina, Syria and Kufa, the
 Ansar, the Tribes) and under them the musnad of each Companion — 1,252 in all, Abu Bakr al-Siddiq's first —; al-Darimi
 in its 24 books (Introduction, Purification, Prayer …) and 1,382 chapters (bab). The parts and books are named in
-the interface language, the Companions and the chapters in the Arabic of the book.
+the interface language; the musnad of every Companion in Turkish and English too ("Hz. Ebû Bekir es-Sıddîk (r.a.)
+müsnedi", "Musnad of Abu Bakr al-Siddiq (RA)"), and al-Darimi's 1,382 chapters as well ("Temizlik", "Purification"…
+"Abdestin fazileti", "The virtue of ablution").
 
 The shelf holds the Sunni and the Shia books together, each under its own heading — *All*, *Sunni*
 or *Shia* at the top shows one of them alone — and every Shia book carries a gold *Shia* tag. Books
@@ -564,6 +590,7 @@ it. Every result is computed once and saved as JSON in your data folder (`derive
 
 | Section | What it shows |
 |---|---|
+| **All books** | the first entry of the book list: every section measured on both roads at once, each road under its own heading — never added together |
 | **Overview** | the corpus at a glance: books, hadith, chains, narrators, grades |
 | **Narrators** | reliability, concentration (the busiest 10% carry 75% of the transmission — the Lorenz curve) and the pillars of transmission |
 | **Chains** | length, the weakest link, and the time between narrators (who could not have met) |
@@ -636,7 +663,10 @@ Shia are shown as the line of the Prophet's family ﷺ that the Sunni genealogis
 is the Shia's belief, shown as theirs (where the Sunni historians differ — a son of al-Hasan al-'Askari — the box
 is dashed and both are given).
 
-Click a name for what the sources say about it; a narrator opens on the Narrators page, which has the links to
+Click a name for what the sources say about it. The Prophet ﷺ opens his life, with the sira to read; a prophet
+whose name the Qur'an and the hadith give opens the hadith that speak of him — the Sunni books and the Shia books
+apart, each a click from its book; a Companion, a caliph or an Imam whose life isnady has opens it, and the Narrators
+page links back to his place in the tree of Quraysh. A narrator opens on the Narrators page, which has the links to
 his family and his line of learning too. `iy tree prophets`, `iy tree prophets Musa`, `iy tree family "Ibn
 Umar"`, `iy tree learning al-Zuhri --depth 2 --width 4`.
 
@@ -651,13 +681,17 @@ Umar"`, `iy tree learning al-Zuhri --depth 2 --width 4`.
 
 ## ⭐ Bookmarks
 
-Every hadith card, narrator, scholar, term of Learn and chapter of Books has a ☆: one click keeps it among
-your **Bookmarks**. There they live in folders of your own — nested as deep as you like, one bookmark in as
+Every hadith card, narrator, scholar, term of Learn, chapter of Books and place in the Genealogies has a ☆: one
+click keeps it among your **Bookmarks**, and the star says what it keeps ("Add this narrator to your bookmarks").
+Each bookmark shows its kind — Hadith, Narrator, Scholar, Term, Chapter, Genealogy — and a line on what it is (a
+narrator's road, tabaqa, death and verdict; which tree); the list filters by kind, and a narrator kept as a
+narrator and the same man kept as a place in his family tree are two bookmarks. There they live in folders of your own — nested as deep as you like, one bookmark in as
 many folders as you want, dragged onto a folder to file it — each with a note of your own, found by words or by
 kind, opened with a click where it belongs. They are kept in `bookmarks.json` in isnady's data folder (yours
 alone, never published) and can be exported and imported as a file; a hadith is kept by its book and number, so a
 bookmark survives a new import. `iy bookmark add hadith bukhari:1 --folder "Intention/Deeds" --note "…"`,
-`iy bookmark list`, `iy bookmark folders`, `iy bookmark export file.json`.
+`iy bookmark list`, `iy bookmark list tree`, `iy bookmark add tree prophets:musa`, `iy bookmark folders`,
+`iy bookmark export file.json`.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/bookmarks.png" alt="Bookmarks — folders on the left, a hadith, a narrator, a scholar and a term with their folders and a note" width="850">
@@ -738,6 +772,18 @@ nothing to restart. `iy config set view.ui_language tr`. The hadith texts keep t
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/preferences.png" alt="Preferences — font, size, line spacing and colour for each script" width="760">
 </p>
 
+**Back and forward**, as in a browser: ◀ ▶ under the name in the sidebar, Alt+Left / Alt+Right, the mouse's back
+and forward buttons — every narrator, chain, book, scholar, term and tree opened is a step, and pointing at the
+button says where it goes.
+
+**A new version starts clean:** what the earlier version computed (`cache/`, `derived/`) is deleted once and computed
+again, and the footer says so; the settings, bookmarks, profiles, recent searches, the database and the downloaded
+works are kept. **Help → Check for Updates** asks PyPI and npm (whichever isnady is installed from — both, ticked,
+when both are behind) and shows what is new; `iy update --check`, `iy update --npm`. A page that cannot be built
+shows a plain card instead of stopping isnady, the details go to `isnady.log` in the data folder, and an import that
+was cut short is named on the Search page at the next start. On the very first start, with no books yet, isnady
+offers to import isnady-data in the background, the progress in the bar at the bottom.
+
 **Settings → Books and languages** switches imported books on and off (Sunni and Shia apart) and
 chooses the languages the texts are shown in; the others are folded behind an arrow on each hadith.
 
@@ -767,6 +813,12 @@ and a folder named `isnady-data` beside a portable application is used instead:
 
 ---
 
+**Profiles.** Several people can use one isnady, each with their own settings, place in the books and bookmarks:
+**File → Profiles** makes, switches, renames, deletes, exports and imports them (one `.isnady-profile.zip` file
+carries a profile to another computer). The books and the database are shared. The first profile is the data folder
+itself, so nothing changes for anyone who never makes a second one. `iy profile list`, `iy profile new Ayşe`,
+`iy profile use Ayşe`, `iy profile export Ayşe ~/`; `ISNADY_PROFILE=Ayşe iy …` for one command.
+
 ## ⌨️ CLI
 
 Everything the window does also works without it — on a server, over SSH, or in a script. The
@@ -776,21 +828,23 @@ command line never loads Qt. Every command that takes a book accepts its full na
 | Short | Example | What it does |
 |:------|:-----|:-------------|
 | `iy` | `isnady` | Open the window |
-| `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` |
-| `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 |
+| `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 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` |
+| `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`) |
-| `iy life NAME` | `iy life Abu Hurayra --lang tr` | The life of a Companion, a narrator or a scholar (`--lang en\|tr\|ar`, `--tradition`, `--limit`) |
-| `iy tree WHICH [NAME]` | `iy tree family "Ibn Umar"` | Genealogies: `prophets`, `quraysh`, a narrator's `family`, his line of `learning` (`--depth`, `--width`) |
+| `iy life NAME` | `iy life Abu Hurayra --lang tr` | The life of a Companion, a narrator or a scholar (`--lang en\|tr\|ar`, `--tradition`, `--limit`); `--source` downloads al-Dhahabi's *Siyar* and shows its entry |
+| `iy tree WHICH [NAME]` | `iy tree family "Ibn Umar"` | Genealogies: `prophets`, `quraysh`, a narrator's `family`, his line of `learning` (`--depth`, `--width`); `--hadith` the hadith that speak of a prophet |
+| `iy profile ACTION` | `iy profile new Ayşe --copy default` | Profiles: `list`, `new`, `use`, `rename`, `delete`, `export`, `import` |
 | `iy bookmark ACTION` | `iy bookmark add hadith bukhari:1 --folder Prayer` | Bookmarks: `list`, `folders`, `add`, `remove`, `export`, `import` |
 | `iy ai build` | `iy ai status` | Learn the meaning index from the imported texts |
 | `iy catalog list` | `iy catalog list --repo lk-hadith-corpus` | The books of the repository in use, and your own, with what is imported |
 | `iy catalog import ID` | `iy catalog import sahih_muslim --language tur` | Import a book; `--all` imports every one; `remove`, `add`, `delete` manage the list |
+| `iy catalog languages` | `iy catalog languages add tr en` | One language for every book: the list, `add`, `remove` (Arabic stays) |
 | `iy repo [list\|use\|show\|add\|remove]` | `iy repo add ~/isnady-data` | The data repositories: isnady-data (default), the optional ones, yours — a GitHub or Hugging Face address, a URL, or a folder |
 | `iy database [use FILE]` | `iy database use isnady-db-<date>.zip` | A ready database from a file; your own is kept beside it |
 | `iy import FORMAT FILE-OR-URL` | `iy import isnady ~/my_book/book.json` | Import a file of your own; `--book`, `--language`, `--license`, `--user`, `--token-env`, `--api-key-env` |
@@ -800,7 +854,7 @@ command line never loads Qt. Every command that takes a book accepts its full na
 | `iy datadir [FOLDER]` | `iy datadir /data/isnady` | Show or move the data folder; `--as-is`, `--default` |
 | `iy config list\|get\|set\|reset` | | Settings — the same as Edit → Preferences |
 | `iy shortcut` | `iy shortcut --no-desktop` | A desktop and applications-menu shortcut |
-| `iy update` | | Update every copy of isnady where it is installed |
+| `iy update` | `iy update --check` | Update every copy of isnady where it is installed; `--check` only looks (PyPI and npm, what is new); `--npm` the npm package |
 | `iy doctor` | | Every copy of isnady on this computer and which one each command starts |
 | `iy -V` / `iy -h` | | Version / help |
 

package/index.js

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

package/package.json

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