isnady 0.0.1__tar.gz

isnady-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

isnady-0.0.1/.gitignore

@@ -0,0 +1,23 @@
+# Local-only project notes — never pushed
+isnady_Handoff.md
+ISNADY_TODO.md
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+
+# Data built locally (the database will be shipped separately, not committed raw)
+*.sqlite
+*.sqlite3
+*.db
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db

isnady-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bayram Kotan
+
+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.

isnady-0.0.1/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.5
+Name: isnady
+Version: 0.0.1
+Summary: Hadith search with full isnad chains, narrator biographies, jarh wa ta'dil verdicts and reliability scores
+Project-URL: Homepage, https://github.com/bayramkotan/isnady
+Project-URL: Repository, https://github.com/bayramkotan/isnady
+Project-URL: Issues, https://github.com/bayramkotan/isnady/issues
+Author: Bayram Kotan
+License-Expression: MIT
+License-File: LICENSE
+Keywords: hadith,islamic studies,isnad,jarh wa tadil,narrators,rijal
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Arabic
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Education
+Classifier: Topic :: Religion
+Requires-Python: >=3.10
+Requires-Dist: pyside6>=6.6
+Description-Content-Type: text/markdown
+
+# isnady
+
+Hadith search built around the **isnad** — the chain of transmission.
+
+isnady is a desktop application (PySide6, Windows and Linux) for searching hadith
+across the major collections and seeing *why* each report has the grade it has:
+every narrator in the chain, what the scholars of jarh wa ta'dil said about them,
+and how the chain holds together.
+
+> **Status: pre-alpha (0.0.1).** This release is the application skeleton. No hadith
+> data is included yet.
+
+## Planned
+
+- **Search** — by text, book, chapter, narrator and grade: mutawatir, sahih, hasan,
+  da'if, mawdu' and the intermediate grades.
+- **Narrators** — biography, dates, teachers and students, number of narrations,
+  and every recorded verdict with its source.
+- **Isnad chains** — each chain drawn link by link, with each narrator's standing.
+- **Reliability scores** — derived transparently from classical rankings (for example
+  Ibn Hajar's twelve grades in *Taqrib al-Tahdhib*), always shown with the verdicts
+  they come from. A score is a conversion of the scholars' judgement, never a new one.
+- **Shia rijal** — the primary grading follows the Sunni tradition; narrator verdicts
+  from Shia rijal works (al-Najashi, al-Tusi, al-Kashshi, al-Hilli, al-Khoei) are listed
+  per narrator beside the Sunni view.
+- **Statistics** — narrators, books and grades counted and compared.
+- **Learn** — the hadith sciences explained: terminology, grading, jarh wa ta'dil,
+  and the classical works.
+
+## Install
+
+```
+pip install isnady
+isnady
+```
+
+## License
+
+MIT for the application code. Hadith and narrator data will come from separate
+sources, each under its own license, listed here as they are added.

isnady-0.0.1/README.md

@@ -0,0 +1,40 @@
+# isnady
+
+Hadith search built around the **isnad** — the chain of transmission.
+
+isnady is a desktop application (PySide6, Windows and Linux) for searching hadith
+across the major collections and seeing *why* each report has the grade it has:
+every narrator in the chain, what the scholars of jarh wa ta'dil said about them,
+and how the chain holds together.
+
+> **Status: pre-alpha (0.0.1).** This release is the application skeleton. No hadith
+> data is included yet.
+
+## Planned
+
+- **Search** — by text, book, chapter, narrator and grade: mutawatir, sahih, hasan,
+  da'if, mawdu' and the intermediate grades.
+- **Narrators** — biography, dates, teachers and students, number of narrations,
+  and every recorded verdict with its source.
+- **Isnad chains** — each chain drawn link by link, with each narrator's standing.
+- **Reliability scores** — derived transparently from classical rankings (for example
+  Ibn Hajar's twelve grades in *Taqrib al-Tahdhib*), always shown with the verdicts
+  they come from. A score is a conversion of the scholars' judgement, never a new one.
+- **Shia rijal** — the primary grading follows the Sunni tradition; narrator verdicts
+  from Shia rijal works (al-Najashi, al-Tusi, al-Kashshi, al-Hilli, al-Khoei) are listed
+  per narrator beside the Sunni view.
+- **Statistics** — narrators, books and grades counted and compared.
+- **Learn** — the hadith sciences explained: terminology, grading, jarh wa ta'dil,
+  and the classical works.
+
+## Install
+
+```
+pip install isnady
+isnady
+```
+
+## License
+
+MIT for the application code. Hadith and narrator data will come from separate
+sources, each under its own license, listed here as they are added.

isnady-0.0.1/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "isnady"
+dynamic = ["version"]
+description = "Hadith search with full isnad chains, narrator biographies, jarh wa ta'dil verdicts and reliability scores"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Bayram Kotan" }]
+requires-python = ">=3.10"
+dependencies = ["PySide6>=6.6"]
+keywords = ["hadith", "isnad", "rijal", "narrators", "jarh wa tadil", "islamic studies"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "Natural Language :: English",
+    "Natural Language :: Arabic",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Education",
+    "Topic :: Religion",
+]
+
+[project.urls]
+Homepage = "https://github.com/bayramkotan/isnady"
+Repository = "https://github.com/bayramkotan/isnady"
+Issues = "https://github.com/bayramkotan/isnady/issues"
+
+[project.gui-scripts]
+isnady = "isnady.main:main"
+
+[tool.hatch.version]
+path = "src/isnady/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/isnady"]
+
+[tool.hatch.build.targets.sdist]
+exclude = ["isnady_Handoff.md", "ISNADY_TODO.md"]

isnady-0.0.1/src/isnady/__init__.py

@@ -0,0 +1,4 @@
+"""isnady — hadith search built around the isnad."""
+
+__version__ = "0.0.1"
+APP_NAME = "isnady"

isnady-0.0.1/src/isnady/__main__.py

@@ -0,0 +1,3 @@
+from isnady.main import main
+
+raise SystemExit(main())

isnady-0.0.1/src/isnady/gui/__init__.py

@@ -0,0 +1 @@
+"""GUI package."""

isnady-0.0.1/src/isnady/gui/main_window.py

@@ -0,0 +1,76 @@
+"""Main window: a sidebar of sections and a page stack.
+
+Each section is a placeholder until its own delivery builds it.
+"""
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import (
+    QHBoxLayout,
+    QLabel,
+    QListWidget,
+    QMainWindow,
+    QStackedWidget,
+    QVBoxLayout,
+    QWidget,
+)
+
+from isnady import APP_NAME, __version__
+
+# (key, sidebar label, one-line description shown on the placeholder page)
+SECTIONS = [
+    ("search", "Search", "Search hadith text, books and grades (mutawatir, sahih, hasan, da'if, mawdu' ...)."),
+    ("narrators", "Narrators", "Every narrator: biography, teachers, students, number of narrations, verdicts."),
+    ("chains", "Isnad Chains", "Chains of transmission drawn link by link, with each narrator's standing."),
+    ("books", "Books", "Hadith collections processed into the database and their coverage."),
+    ("shia_rijal", "Shia Rijal", "Narrator verdicts from Shia rijal scholars, per person, beside the Sunni view."),
+    ("statistics", "Statistics", "Counts, distributions and rankings across narrators, books and grades."),
+    ("learn", "Learn", "Hadith sciences: terminology, grading, jarh wa ta'dil, the classical works."),
+]
+
+
+def _placeholder(title: str, text: str) -> QWidget:
+    page = QWidget()
+    layout = QVBoxLayout(page)
+    layout.setAlignment(Qt.AlignmentFlag.AlignTop)
+    heading = QLabel(title)
+    font = heading.font()
+    font.setPointSize(font.pointSize() + 6)
+    font.setBold(True)
+    heading.setFont(font)
+    body = QLabel(text)
+    body.setWordWrap(True)
+    note = QLabel("Not built yet.")
+    note.setEnabled(False)
+    layout.addWidget(heading)
+    layout.addWidget(body)
+    layout.addSpacing(12)
+    layout.addWidget(note)
+    return page
+
+
+class MainWindow(QMainWindow):
+    def __init__(self) -> None:
+        super().__init__()
+        self.setWindowTitle(f"{APP_NAME} {__version__}")
+        self.resize(1100, 720)
+
+        self.sidebar = QListWidget()
+        self.sidebar.setFixedWidth(190)
+        self.pages = QStackedWidget()
+
+        for key, label, text in SECTIONS:
+            self.sidebar.addItem(label)
+            page = _placeholder(label, text)
+            page.setObjectName(f"page_{key}")
+            self.pages.addWidget(page)
+
+        self.sidebar.currentRowChanged.connect(self.pages.setCurrentIndex)
+        self.sidebar.setCurrentRow(0)
+
+        central = QWidget()
+        row = QHBoxLayout(central)
+        row.addWidget(self.sidebar)
+        row.addWidget(self.pages, 1)
+        self.setCentralWidget(central)
+
+        self.statusBar().showMessage(f"{APP_NAME} {__version__} — no data loaded yet")

isnady-0.0.1/src/isnady/main.py

@@ -0,0 +1,24 @@
+"""Entry point: `isnady` command and `python -m isnady`."""
+
+import sys
+
+from PySide6.QtWidgets import QApplication
+
+from isnady import APP_NAME, __version__
+from isnady.gui.main_window import MainWindow
+
+
+def main() -> int:
+    if "--version" in sys.argv[1:]:
+        print(f"{APP_NAME} {__version__}")
+        return 0
+    app = QApplication(sys.argv)
+    app.setApplicationName(APP_NAME)
+    app.setApplicationVersion(__version__)
+    window = MainWindow()
+    window.show()
+    return app.exec()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())