atril 0.7.0__tar.gz

atril-0.7.0/LICENSE

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

atril-0.7.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: atril
+Version: 0.7.0
+Summary: Gestiona una instalación local de DeepTutor y sus temarios
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Dist: acodo>=0.5.1,<1
+Requires-Dist: psutil>=7
+Requires-Dist: rich>=14
+Requires-Dist: typer>=0.20
+Requires-Python: >=3.13
+Project-URL: Repository, https://github.com/isidro-rodriguez/atril
+Project-URL: Changelog, https://github.com/isidro-rodriguez/atril/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# atril
+
+CLI para gestionar una instalación local de [DeepTutor](https://github.com/HKUDS/DeepTutor)
+y sus temarios (fuentes, bases de conocimiento, evaluación y backup).
+
+> Estado: fases 0–3 completas (configuración, DeepTutor, temarios, fuentes, KB y backup).
+
+## 🚀 Instalación
+
+```bash
+uv tool install atril          # uso diario
+```
+
+Desarrollo:
+
+```bash
+git clone https://github.com/isidro-rodriguez/atril.git
+cd atril
+uv sync
+```
+
+## 🛠️ Uso
+
+```bash
+atril --estacion D:\Desarrollo\DeepTutor validar   # o ATRIL_ESTACION, o desde la estación
+```
+
+| Grupo | Comandos | Fase |
+|---|---|---|
+| Configuración | `validar` | 0 ✅ |
+| DeepTutor | `instalar` · `actualizar` · `arrancar` · `parar` · `estado` · `parches` | 1 ✅ |
+| Temarios | `temario lista` · `temario cobertura <t>` | 2 ✅ |
+| Fuentes | `fuentes descargar <t> [ids]` · `fuentes comprobar <t> [ids] [--todas]` | 2 ✅ |
+| KB | `kb indexar <t> [kb]` · `kb reindexar <kb>` · `kb evaluar <kb> [-k 5] [--detalle]` | 2 ✅ |
+| Backup | `backup [-d destino]` · `backup comprobar [--datos 5%]` · `backup restaurar -d destino` | 3 ✅ |
+| Otros | `accesos` | 5 |
+
+Configuración: [`docs/esquemas.md`](https://github.com/isidro-rodriguez/atril/blob/main/docs/esquemas.md) · ejemplos en [`docs/ejemplos/`](https://github.com/isidro-rodriguez/atril/blob/main/docs/ejemplos/).
+
+## ✅ Calidad
+
+```bash
+uv run ruff format .
+uv run ruff check .
+uv run ty check
+uv run pytest
+```
+
+Con [Poe the Poet](https://poethepoet.natn.io/): `poe check` · `poe fix` · `poe backup`.
+
+## Enlaces
+
+- Decisiones de diseño: [`docs/decisiones.md`](https://github.com/isidro-rodriguez/atril/blob/main/docs/decisiones.md)
+- Plantilla base: <https://github.com/isidro-rodriguez/acodo-template>
+- Acodo: <https://github.com/isidro-rodriguez/acodo>
+
+## Licencia
+
+[MIT](https://github.com/isidro-rodriguez/atril/blob/main/LICENSE).

atril-0.7.0/README.md

@@ -0,0 +1,59 @@
+# atril
+
+CLI para gestionar una instalación local de [DeepTutor](https://github.com/HKUDS/DeepTutor)
+y sus temarios (fuentes, bases de conocimiento, evaluación y backup).
+
+> Estado: fases 0–3 completas (configuración, DeepTutor, temarios, fuentes, KB y backup).
+
+## 🚀 Instalación
+
+```bash
+uv tool install atril          # uso diario
+```
+
+Desarrollo:
+
+```bash
+git clone https://github.com/isidro-rodriguez/atril.git
+cd atril
+uv sync
+```
+
+## 🛠️ Uso
+
+```bash
+atril --estacion D:\Desarrollo\DeepTutor validar   # o ATRIL_ESTACION, o desde la estación
+```
+
+| Grupo | Comandos | Fase |
+|---|---|---|
+| Configuración | `validar` | 0 ✅ |
+| DeepTutor | `instalar` · `actualizar` · `arrancar` · `parar` · `estado` · `parches` | 1 ✅ |
+| Temarios | `temario lista` · `temario cobertura <t>` | 2 ✅ |
+| Fuentes | `fuentes descargar <t> [ids]` · `fuentes comprobar <t> [ids] [--todas]` | 2 ✅ |
+| KB | `kb indexar <t> [kb]` · `kb reindexar <kb>` · `kb evaluar <kb> [-k 5] [--detalle]` | 2 ✅ |
+| Backup | `backup [-d destino]` · `backup comprobar [--datos 5%]` · `backup restaurar -d destino` | 3 ✅ |
+| Otros | `accesos` | 5 |
+
+Configuración: [`docs/esquemas.md`](https://github.com/isidro-rodriguez/atril/blob/main/docs/esquemas.md) · ejemplos en [`docs/ejemplos/`](https://github.com/isidro-rodriguez/atril/blob/main/docs/ejemplos/).
+
+## ✅ Calidad
+
+```bash
+uv run ruff format .
+uv run ruff check .
+uv run ty check
+uv run pytest
+```
+
+Con [Poe the Poet](https://poethepoet.natn.io/): `poe check` · `poe fix` · `poe backup`.
+
+## Enlaces
+
+- Decisiones de diseño: [`docs/decisiones.md`](https://github.com/isidro-rodriguez/atril/blob/main/docs/decisiones.md)
+- Plantilla base: <https://github.com/isidro-rodriguez/acodo-template>
+- Acodo: <https://github.com/isidro-rodriguez/acodo>
+
+## Licencia
+
+[MIT](https://github.com/isidro-rodriguez/atril/blob/main/LICENSE).

atril-0.7.0/pyproject.toml

@@ -0,0 +1,138 @@
+[project]
+name = "atril"
+version = "0.7.0"
+description = "Gestiona una instalación local de DeepTutor y sus temarios"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: Spanish",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "acodo>=0.5.1,<1",
+    "psutil>=7",
+    "rich>=14",
+    "typer>=0.20",
+]
+
+[project.urls]
+Repository = "https://github.com/isidro-rodriguez/atril"
+Changelog = "https://github.com/isidro-rodriguez/atril/blob/main/CHANGELOG.md"
+
+[project.scripts]
+atril = "atril.main:main"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.7.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.1",
+    "ty>=0.0.89",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.14.0"]
+build-backend = "uv_build"
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/__init__.py",
+]
+
+[tool.coverage.report]
+exclude_also = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+]
+
+[tool.poe.executor]
+type = "uv"
+
+[tool.poe.tasks.check]
+help = "Formato, lint, tipos y tests (lo mismo que la CI)"
+sequence = [
+    "ruff format --check .",
+    "ruff check .",
+    "ty check",
+    "pytest",
+]
+default_item_type = "cmd"
+
+[tool.poe.tasks.fix]
+help = "Aplica el formato y las correcciones automáticas de Ruff"
+sequence = [
+    "ruff format .",
+    "ruff check --fix .",
+]
+default_item_type = "cmd"
+
+[tool.poe.tasks.backup]
+help = "Copia de seguridad del repositorio con git bundle"
+cmd = "python scripts/backup.py"
+
+[tool.pytest.ini_options]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--import-mode=importlib",
+    "--doctest-modules",
+]
+testpaths = [
+    "tests",
+    "src",
+]
+pythonpath = ["tests"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py313"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PERF",
+    "PTH",
+    "RUF",
+    "D",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["atril"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]
+
+[tool.ty.environment]
+python-version = "3.13"
+extra-paths = ["tests"]
+
+[tool.ty.src]
+include = [
+    "src",
+    "tests",
+]

atril-0.7.0/pyproject.toml.orig

@@ -0,0 +1,111 @@
+[project]
+name = "atril"
+version = "0.7.0"
+description = "Gestiona una instalación local de DeepTutor y sus temarios"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Natural Language :: Spanish",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+
+dependencies = [
+  "acodo>=0.5.1,<1",
+  "psutil>=7",
+  "rich>=14",
+  "typer>=0.20",
+]
+
+[project.urls]
+Repository = "https://github.com/isidro-rodriguez/atril"
+Changelog = "https://github.com/isidro-rodriguez/atril/blob/main/CHANGELOG.md"
+
+[project.scripts]
+atril = "atril.main:main"
+
+[dependency-groups]
+dev = [
+  "pre-commit>=4.7.0",
+  "pytest>=9.1.1",
+  "pytest-cov>=7.1.0",
+  "ruff>=0.17.1",
+  "ty>=0.0.89",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.14.0"]
+build-backend = "uv_build"
+
+# --- pytest coverage ---------------------------------------------------------
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = ["*/tests/*", "*/__init__.py"]
+
+[tool.coverage.report]
+exclude_also = ["pragma: no cover", "if TYPE_CHECKING:", "if __name__ == .__main__.:"]
+
+# --- Poe the Poet (opcional) -------------------------------------------------
+# Atajos para quien tenga `poe` instalado globalmente (`uv tool install poethepoet`).
+# No es dependencia del proyecto: todo se puede ejecutar también con `uv run`.
+[tool.poe]
+executor.type = "uv"
+
+[tool.poe.tasks.check]
+help = "Formato, lint, tipos y tests (lo mismo que la CI)"
+sequence = [
+  "ruff format --check .",
+  "ruff check .",
+  "ty check",
+  "pytest",
+]
+default_item_type = "cmd"
+
+[tool.poe.tasks.fix]
+help = "Aplica el formato y las correcciones automáticas de Ruff"
+sequence = ["ruff format .", "ruff check --fix ."]
+default_item_type = "cmd"
+
+[tool.poe.tasks.backup]
+help = "Copia de seguridad del repositorio con git bundle"
+cmd = "python scripts/backup.py"
+
+# --- pytest ------------------------------------------------------------------
+[tool.pytest.ini_options]
+addopts = ["-ra", "--strict-markers", "--import-mode=importlib", "--doctest-modules"]
+testpaths = ["tests", "src"]
+pythonpath = ["tests"]
+
+# --- Astral Ruff -------------------------------------------------------------
+[tool.ruff]
+line-length = 88
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "C4", "PERF", "PTH", "RUF", "D"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["atril"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]
+
+# --- Astral ty ---------------------------------------------------------------
+[tool.ty.environment]
+python-version = "3.13"
+extra-paths = ["tests"]
+
+[tool.ty.src]
+include = ["src", "tests"]

atril-0.7.0/src/atril/__init__.py

@@ -0,0 +1,5 @@
+"""atril: gestiona una instalación local de DeepTutor y sus temarios."""
+
+from importlib.metadata import version
+
+__version__ = version("atril")

atril-0.7.0/src/atril/__main__.py

@@ -0,0 +1,6 @@
+"""Permite ejecutar el paquete con ``python -m atril``."""
+
+from atril.main import main
+
+if __name__ == "__main__":
+    main()