"""راهنمای کارفرما: کامل باشد، فنی نباشد، و از خودِ برنامه باز شود. خواستهٔ صاحب برنامه همین بود: «کاربر از راهنمای داخل برنامه همهٔ نیازش را یاد بگیرد و از کسی سؤال نکند» و «هیچ توضیح فنی و ریاضی نباشد که نرود به برنامه‌نویس دیگری بسپارد». پس این آزمون‌ها سه چیز را سخت می‌گیرند: ۱. **کامل بودن**: پرسش‌های پرتکرار، جدول خطاها، روز اول، هر روز، روز چهاردهم، پشتیبانی. ۲. **بی‌زبانی فنی**: هیچ واژهٔ فنی/ریاضی و هیچ قطعه‌کد در متن نباشد. ۳. **در دسترس بودن**: از صفحهٔ ورود و از خود برنامه باز شود، و بدون اینترنت هم کار کند. """ from __future__ import annotations import json import os import re import socket import subprocess import sys import tempfile import time import unittest import urllib.error import urllib.request from pathlib import Path BASE = Path(__file__).resolve().parents[1] # .../money/gui WEB = BASE / "web" GUIDE = WEB / "guide.html" sys.path.insert(0, str(BASE)) import gate as g # noqa: E402 TECH_WORDS = ("API", "JSON", "پایتون", "پای‌تون", "جاوااسکریپت", "دیتابیس", "الگوریتم", "فرمول", "معادله", "متغیر", "تابع", "سرور", "اسکریپت", "کامپایل", "داکر", "پورت", "هش", "sha", "npm", "برنامه‌نویسی", "کد نویسی", "کدنویسی", "کامپیوترِ", "مارجین", "کِلی", "توزیع نرمال", "انحراف معیار", "ریاضیات", "∑", "√", "∫", "تابع ریاضی", "پارامتر", "بهینه‌سازی") class GuideFile(unittest.TestCase): @classmethod def setUpClass(cls): cls.html = GUIDE.read_text(encoding="utf-8") cls.text = re.sub(r"<[^>]+>", " ", cls.html) def test_file_exists_and_is_not_huge(self): self.assertTrue(GUIDE.exists()) self.assertLess(GUIDE.stat().st_size, 120_000) def test_has_no_technical_jargon(self): # با مرز واژه سنجیده می‌شود تا زیررشته‌های بی‌گناه (مثل «همه‌شان») گیر نیفتند found = [] for word in TECH_WORDS: pattern = rf"(?]+href="https?://', r']+src="https?://', r']+src="https?://', r"@import\s+url"): self.assertEqual([], re.findall(pattern, self.html), pattern) external = set(re.findall(r'href="https?://([^/"]+)', self.html)) self.assertTrue(external <= {"t.me", "instagram.com"}, external) def test_persian_rtl_and_mobile_ready(self): self.assertIn('dir="rtl"', self.html) self.assertIn('lang="fa"', self.html) self.assertIn("width=device-width", self.html) def test_is_printable(self): self.assertIn("window.print()", self.html) self.assertIn("@media print", self.html) def test_covers_the_whole_journey(self): for phrase in ("روز اول تو", "هر روز", "شصت ثانیه", "دو هفته بعد", "جلسهٔ بازبینی", "برگهٔ تصمیم", "کارنامهٔ آماده‌بودن", "دفتر شاهد"): self.assertIn(phrase, self.html, phrase) def test_answers_at_least_fifteen_questions(self): self.assertGreaterEqual(self.html.count("