آموزش Rich در پایتون

چطور با Rich خروجی پایتون رو حرفه ای کنیم؟

فرض کن یه برنامه پایتونی نوشتی که اطلاعات چند تا سفارش رو می خونه، فایل ها رو بررسی می کنه یا وضعیت سرویس ها رو نشون می ده. برنامه درست کار می کنه، ولی توی ترمینال فقط یه عالمه خط خشک و خالی می بینی. حالا اگه نتیجه ها رو توی یه جدول مرتب ببینی، خطاها قرمز باشن و بفهمی چند درصد کار جلو رفته، استفاده از همون برنامه چقدر راحت تر می شه؟ این دقیقا کاریه که با کتابخانه Rich در پایتون انجام می دیم.

بچه ها، توی این آموزش کتابخانه Rich در پایتون قراره فقط چند تا متن رو رنگی نکنیم. از نصب شروع می کنیم، بعد سراغ متن رنگی، جدول، پنل، نوار پیشرفت، لاگ، خروجی JSON و نمایش خطا می ریم و در آخر یه ابزار خط فرمان کوچیک می سازیم که بتونی واقعا روی سیستم خودت اجراش کنی. کد هر قسمت رو هم گذاشتم که مجبور نباشی از روی عکس تایپ کنی.

اگه با این عبارت ها اومدی اینجا، دقیقا جای درستی هستی: «رنگی کردن خروجی پایتون»، «زیباسازی ترمینال پایتون»، «آموزش Rich پایتون»، «ساخت جدول در ترمینال پایتون» یا «نوار پیشرفت در پایتون». تفاوتشون توی عبارت جستجوئه؛ همه شون به تجربه بهتر کار کردن با برنامه های خط فرمان می رسن.

تصویری که بالا می بینی نمایی از قابلیت های Rich رو نشون می ده: رنگ، چینش، جدول و خروجی های مرتب. قرار نیست همه اینها رو توی یک شب حفظ کنی. کافیه هر بخش رو اجرا کنی و ببینی کدوم قابلیت واقعا به پروژه ات کمک می کنه.

Rich چیه و دقیقا چه کاری می کنه؟

خیلی ساده بگم: Rich یه کتابخانه رایگان و متن باز برای پایتونه که خروجی برنامه رو داخل Terminal، PowerShell، CMD یا محیط های سازگار، خواناتر و خوشگل تر نشون می ده. یعنی می تونی به جای متن ساده از رنگ، استایل، جدول، کادر، نمودار متنی، خروجی Markdown، نمایش کد و گزارش خطای مرتب استفاده کنی. مستندات اصلیش هم توی GitHub پروژه Rich و راهنمای رسمی Rich قرار داره.

یه سوءتفاهم رو همین اول برطرف کنم: Rich به معنی ساخت پنجره گرافیکی با دکمه و فرم مثل برنامه های دسکتاپ نیست. چیزی که می سازیم CLI یا ابزار خط فرمانه. اگه رابط گرافیکی کامل می خوای، باید سراغ ابزارهای دیگه بری. مثلا Textual برای ساخت رابط متنی تعاملی، Tkinter یا PySide برای برنامه دسکتاپ، و Flutter برای ساخت اپ چند پلتفرمی کاربرد دارن. انتخاب درست از خود ابزار مهم تره.

راستی Rich فقط برای ظاهر نیست. وقتی یه ابزار واقعی داری که باید چند تا فایل، IP، رکورد یا نتیجه پردازش رو گزارش بده، زیباسازی خروجی پایتون می تونه تفاوت بین «یه مشت متن نامفهوم» و «گزارشی که بشه سریع تصمیم گرفت» باشه. البته رنگ قرمز به تنهایی خطا رو رفع نمی کنه؛ فقط کمک می کنه سریع تر ببینیش.

Rich با چه نسخه ای از پایتون کار می کنه؟

طبق انتشار رسمی Rich 15.0.0 در آوریل ۲۰۲۶، این نسخه حداقل Python 3.9 می خواد. روی ویندوز، لینوکس و مک قابل استفاده است. توی Windows Terminal معمولا رنگ و ایموجی بهتر از CMD خیلی قدیمی نمایش داده می شه. در ترمینال های مختلف، مخصوصا متن فارسی راست به چپ، چیدمان و پشتیبانی فونت ممکنه فرق کنه؛ این محدودیت خود محیط نمایش هم هست، نه لزوما ایراد Rich.

نصب کتابخانه Rich در ویندوز، لینوکس و مک

حالا بریم سر اصل کار. قبل از نصب کتابخانه Rich در پایتون، اول مطمئن شو پایتونت شناسایی می شه. توی ویندوز می تونی PowerShell یا CMD باز کنی؛ روی لینوکس و مک هم Terminal رو اجرا کن. هر جا چند نسخه پایتون روی سیستم داری، بهتره بسته رو با همون مفسری نصب کنی که پروژه ات رو اجرا می کنه.

python --version
python -m pip --version

اگه روی لینوکس یا مک دستور python وجود نداشت ولی python3 کار کرد، از python3 استفاده کن. اگر خروجی Python 3.8 دیدی، برای نسخه ۱۵ Rich باید پایتون رو به 3.9 یا بالاتر ارتقا بدی؛ نصب نسخه جدید روی نسخه قدیمی پایتون راه حل درستی نیست.

من پیشنهاد می کنم برای هر پروژه یه محیط مجازی بسازی تا نصب بسته ها با نرم افزارهای دیگه قاطی نشه. این کار مخصوصا روی لینوکس های جدید که ممکنه با خطای externally-managed-environment روبرو بشی، خیلی به درد می خوره.

روش نصب در ویندوز

py -m venv .venv
.venv\Scripts\python.exe -m pip install --upgrade pip
.venv\Scripts\python.exe -m pip install rich
.venv\Scripts\python.exe -m rich

این دستورها بدون نیاز به فعال کردن محیط مجازی هم کار می کنن. هر دستور داخل پوشه پروژه اجرا بشه. اگه دستور py روی ویندوزت شناسایی نشد، همون python رو جایگزین کن. دستور آخر یه دموی واقعی از امکانات Rich نمایش می ده؛ پس اولین تست رنگی کردن ترمینال پایتون رو همین جا می بینی.

روش نصب در لینوکس و مک

python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install rich
.venv/bin/python -m rich

روی بعضی توزیع های Debian یا Ubuntu ممکنه بسته python3-venv نصب نباشه. اگر ساخت محیط مجازی خطا داد، اول بسته مربوط به نسخه پایتون خودت رو از مخازن رسمی توزیع نصب کن. برای نصب Rich، سراغ sudo pip install یا گزینه --break-system-packages نرو؛ با محیط مجازی معمولا نیازی به دستکاری پایتون سیستمی نداری.

مشکل دانلود پکیج از ایران چیه؟

اگه داخل ایران هستی و نصب با pip روی دانلود متوقف شد، اول بررسی کن اینترنت و DNS کار می کنه یا نه. گاهی اختلال مسیر، محدودیت دسترسی به سرویس خارجی، تنظیم پراکسی یا مشکل گواهی TLS باعث خطاست. ممکنه مرورگرت با تحریم شکن به اینترنت وصل باشه، ولی ترمینال از اون مسیر استفاده نکنه. بهتره قبل از تغییر آدرس مخزن یا خاموش کردن بررسی گواهی، اتصال خود ترمینال رو درست کنی.

یه نکته امنیتی هم این وسط مهمه: برای رفع خطا، گواهی HTTPS رو خاموش نکن و بسته Rich رو از فایل ناشناس دانلود نکن. مرجع اصلی بسته PyPI و مخزن رسمی GitHub هست. اگه فقط لازم داری خروجی روی صفحه قشنگ باشه، دلیلی نداره برای یک تغییر ظاهری امنیت نصب رو پایین بیاری.

اگه تا الان برای رنگی کردن خروجی پایتون از کدهای ANSI استفاده می کردی، اینجا قرار نیست همه چیز رو از اول اختراع کنی. آموزش Rich پایتون کمک می کنه قواعد نمایش رو از منطق اصلی کدت جدا نگه داری؛ یعنی اگه رنگ ها عوض شدن، نیازی نیست حلقه پردازش اطلاعات رو دستکاری کنی.

رنگی کردن متن در پایتون با Rich

برای شروع رنگی کردن خروجی پایتون، راحت ترین روش اینه که print خود Rich رو وارد کنی. داخل متن، تگ هایی مثل [bold green] می نویسی و Rich موقع نمایش اونها رو به رنگ و استایل تبدیل می کنه. خود متن اصلی برنامه هم همچنان یه رشته پایتونیه.

from rich import print

print("[bold green]SUCCESS[/bold green] Backup completed")
print("[yellow]WARNING[/yellow] Storage is almost full")
print("[bold red]ERROR[/bold red] Connection failed")

خب، این اولین کاربرد واقعیه. برای ابزار بکاپ، خروجی سبز یعنی کار تموم شده؛ زرد یعنی باید یه چیزی رو بررسی کنیم؛ قرمز یعنی مشکلی پیش اومده. کتابخانه Rich در پایتون رنگ ها رو برای چشم خوشگل نمی کنه که فقط عکس بگیری؛ وقتی معنی رنگ ها مشخص باشه، خواندن گزارش سریع تر می شه.

البته حواست باشه که از from rich import print استفاده کنی، نه print داخلی پایتون. روش دوم استفاده از Console هست که امکانات خیلی بیشتری مثل لاگ، جدول و ذخیره خروجی در اختیارت می ذاره. برای پروژه واقعی، من معمولا از Console استفاده می کنم.

from rich.console import Console

console = Console()
console.print("Server is [bold green]online[/bold green]")
console.print("Disk warning", style="bold yellow")
console.rule("SYSTEM REPORT")

اینجا console.print() برای چاپ خروجی، و console.rule() برای کشیدن یک خط جداکننده با عنوان استفاده می شه. برای زیباسازی ترمینال پایتون همین چند خط گاهی کافیه تا اسکریپتت از حالت آزمایشی دربیاد و قابل استفاده بشه.

چرا نباید همیشه متن دریافتی کاربر رو با Markup چاپ کنیم؟

فرض کن نام یک فایل یا پیام رو از کاربر دریافت کردی و داخلش علامت هایی شبیه [red] بود. اگر Rich اون متن رو به عنوان Markup تفسیر کنه، ممکنه ظاهر نتیجه عوض بشه یا خروجی چیزی نباشه که انتظار داری. برای داده ای که از بیرون میاد، تفسیر Markup رو خاموش کن. این نکته کوچک توی ابزارهای واقعی خیلی اهمیت داره.

from rich.console import Console

console = Console()
filename = "[red]backup.zip"
console.print(filename, markup=False)

تفاوت print، log، out و pretty توی Rich

بریم سراغ یکی از سؤال هایی که بعد از آموزش کتابخانه Rich در پایتون زیاد پیش میاد: این همه روش برای خروجی گرفتن چه فرقی دارن؟ در نگاه اول همه شون یه چیزی روی صفحه چاپ می کنن، ولی هر کدوم برای موقعیت متفاوتی خوبه.

from rich.console import Console
from rich import pretty

console = Console()
pretty.install()

items = {"status": "ok", "count": 3, "files": ["a.py", "b.py"]}
console.print(items)
console.log("Loaded data", items)
console.out("Plain text output")
console.rule("NEXT STEP")

اگه ازت بپرسم برای اسکریپتی که روی سرور اجرا می شه کدوم بهتره، جوابم فقط «قشنگ ترین» نیست. مثلا console.log() برای فهمیدن مراحل اجرای برنامه خوبه، ولی به جای سیستم لاگ حرفه ای با فایل، سطح دسترسی و نگهداری مشخص قرار نمی گیره. می تونی Rich رو به ماژول استاندارد logging هم وصل کنی که جلوتر نمونه اش رو می بینیم.

ویدیوی کوتاه بالا رو ببین؛ کمک می کنه تفاوت خروجی عادی و نمایش مرتب در کنسول رو سریع تر متوجه بشی. اگه محیط ترمینال تو از نظر رنگ یا فونت کمی با تصویر فرق داشت، عجیب نیست؛ بعضی قابلیت های نمایش به فونت و Terminal بستگی دارن.

ساخت جدول رنگی در ترمینال پایتون

حالا فرض کن یه اسکریپت نوشتی که وضعیت چند سرویس رو بررسی می کنه. چاپ کردن نتیجه ها با print مشکلی نداره، ولی وقتی تعداد سطرها زیاد بشه چشم خسته می شه. با کلاس Table می تونی خروجی رو مثل یه جدول مرتب ببینی. این یکی از کاربردی ترین بخش های آموزش Rich پایتون برای من بوده.

from rich.console import Console
from rich.table import Table

console = Console()
table = Table(title="Service Health")
table.add_column("Service", style="cyan")
table.add_column("Status", justify="center")
table.add_column("Latency", justify="right")

table.add_row("API", "[green]OK[/green]", "42 ms")
table.add_row("Database", "[green]OK[/green]", "18 ms")
table.add_row("Backup", "[yellow]WARN[/yellow]", "210 ms")
console.print(table)

این جدول برای وضعیت فرضی سه سرویسه؛ یعنی کد بالا هیچ سرور واقعی رو اسکن نمی کنه. اما می تونی بعدا نتیجه درخواست HTTP، وضعیت بکاپ یا پردازش فایل خودت رو داخلش بذاری. تفاوت اصلی ساخت جدول در ترمینال پایتون با چاپ دستی ستون ها اینه که Rich تا جای ممکن فاصله و عرض ستون ها رو خودش مدیریت می کنه.

برای زیباسازی خروجی پایتون لازم نیست همه خط ها رنگی باشن. چند رنگ با معنای ثابت، فاصله درست و یک خط جداکننده گاهی از ده تا رنگ متنوع حرفه ای تره. به نظرم وقتی خروجی پروژه رو به همکارت می دی، خوانا بودن مهم تر از شلوغی ظاهره.

پنل و کادر برای پیام های مهم

برای پیام هایی که باید بیشتر دیده بشن، کلاس Panel خیلی کار راه اندازه. مثلا توی ابزار نصب، یک پیام راهنما یا یک هشدار قبل از تغییر تنظیمات، بهتره داخل کادر جدا نمایش داده بشه. این هم یکی از روش های ساده زیباسازی خروجی پایتون بدون طراحی رابط گرافیکیه.

from rich.console import Console
from rich.panel import Panel

console = Console()
console.print(Panel("Check the target folder before continuing.", title="NOTICE", border_style="yellow"))

یه نکته هم درباره ساخت جدول در ترمینال پایتون: وقتی اطلاعات خیلی زیاد شد، بهتره همه ردیف ها رو یکجا چاپ نکنی. مثلا آخرین ۲۰ نتیجه یا فقط خطاها رو در جدول بذار و خروجی کامل رو جدا ذخیره کن. این روش توی ابزارهای واقعی کمک می کنه گزارش سریع خوانده بشه.

نوار پیشرفت در پایتون با Rich

یه برنامه رو تصور کن که باید ۵۰۰ فایل رو بررسی کنه. اگه فقط یه پیام «لطفا صبر کنید» نشون بده، آدم نمی فهمه برنامه گیر کرده یا واقعا داره کار می کنه. نوار پیشرفت در پایتون دقیقا برای همین ساخته شده. در Rich می تونی از track() برای حلقه های ساده استفاده کنی یا با Progress چند کار رو همزمان نمایش بدی.

from time import sleep
from rich.progress import track

for item in track(range(20), description="Processing..."):
    sleep(0.03)

اینجا عدد ۲۰ یعنی ۲۰ مرحله تمرینی داریم و sleep فقط برای اینه که حرکت نوار رو ببینی. توی پروژه واقعی باید داخل حلقه عملیات واقعی رو انجام بدی. اگه پردازش واقعا تمام نشده، نشون دادن عدد ۱۰۰٪ گمراه کننده است. همین فرق یه دمو با برنامه قابل اعتماده.

from time import sleep
from rich.progress import Progress

with Progress() as progress:
    files = progress.add_task("Files", total=30)
    records = progress.add_task("Records", total=60)
    for _ in range(30):
        sleep(0.02)
        progress.update(files, advance=1)
        progress.update(records, advance=2)

اگه دنبال «نمایش درصد پیشرفت در پایتون» یا «Progress Bar پایتون» بودی، این قسمت همون جواب عملیه. کتابخانه Rich در پایتون برای یه برنامه CLI می تونه همزمان چند نوار پیشرفت نشون بده؛ ولی بهتره اطلاعات واقعی مثل تعداد فایل پردازش شده رو بهش بدی، نه درصد ساختگی.

وقتی درصد پیشرفت مشخص نیست چی؟

بعضی کارها مثل منتظر موندن برای اتصال به API درصد مشخص ندارن. اینجا استفاده از Spinner یا Status منطقی تره. با این روش به کاربر می گی برنامه زنده است و الان چه کاری انجام می ده، بدون اینکه زمان پایان رو حدس بزنی.

from time import sleep
from rich.console import Console

console = Console()
with console.status("Connecting to service...", spinner="dots"):
    sleep(1)
console.print("[green]Ready[/green]")

برای تمرین نوار پیشرفت در پایتون یه چالش کوچیک دارم: برنامه ای بنویس که ۳۰ فایل آزمایشی رو دونه دونه بخونه و برای هر فایل بعد از پایان کار فقط یک واحد پیشرفت بده. اگه کار نصفه موند، Progress هم باید همون مقدار واقعی رو نشون بده. این تمرین فرق نمایش جذاب و گزارش قابل اعتماد رو خوب جا می اندازه.

نمایش JSON، ساختار پوشه و کد پایتون

یکی دیگه از کارهایی که با Rich خیلی تمیز درمیاد، نمایش داده های شلوغه. وقتی از API خروجی JSON می گیری یا می خوای ساختار پوشه ها رو گزارش بدی، با زیباسازی ترمینال پایتون می تونی اطلاعات رو بدون ساختن صفحه وب بخونی. مخصوصا برای بچه هایی که بک اند، لینوکس یا ابزار اتوماسیون می نویسن، این موضوع واقعا به درد می خوره.

from rich.console import Console

console = Console()
console.print_json(data={"project": "Nabegheha", "status": "ok", "tasks": [1, 2, 3]})

from rich.console import Console
from rich.tree import Tree

console = Console()
tree = Tree("my_project")
tree.add("app.py")
config = tree.add("config")
config.add("settings.json")
tree.add("requirements.txt")
console.print(tree)

from rich.console import Console
from rich.syntax import Syntax

console = Console()
sample = "def add(a, b):\n    return a + b"
console.print(Syntax(sample, "python", line_numbers=True))

توجه کن که Rich قرار نیست جای فرمت استاندارد JSON یا ابزار نمایش کد در IDE رو بگیره. اینجا خروجی رو برای انسان خواناتر می کنه. اگر داده رو قراره برنامه دیگه ای دریافت کنه، بهتره همون JSON یا متن ماشینی تمیز تحویل بدی و رنگ ها رو قاطی داده نهایی نکنی.

نمایش خطا و دیباگ حرفه ای با Rich

اگه موقع اجرای اسکریپت یه خطا اتفاق بیفته، Traceback پیش فرض پایتون می تونه طولانی باشه. با rich.traceback.install() خروجی رو خواناتر می کنی و بخش های مهم خطا مشخص تر می شن. برای کسی که تازه پایتون یاد می گیره، این یکی از جذاب ترین قسمت های آموزش کتابخانه Rich در پایتون است.

from rich.traceback import install

install(show_locals=False)

numbers = [1, 2, 3]
print(numbers[10])

این مثال عمدا خطا تولید می کنه تا شکل Traceback رو ببینی؛ پس شکست اجرای این فایل انتظار ماست. show_locals=False رو هم بی دلیل عوض نکن. نمایش متغیرهای محلی ممکنه رمز عبور، توکن یا اطلاعات حساس برنامه رو داخل خروجی خطا یا اسکرین شات لو بده.

اگه روی سرور یا داخل پروژه امنیتی کار می کنی، به همین یک نکته دقت کن: خروجی جذاب هیچ وقت نباید باعث بشه اسرار پروژه رو منتشر کنی. برای شروع امن تر، اطلاعات خصوصی رو در لاگ ننویس و خروجی رنگی رو بیشتر برای کنسول توسعه نگه دار.

اتصال Rich به logging پایتون

برای پروژه های کمی جدی تر، بهتره به جای چاپ کردن همه پیام ها با print، از ماژول استاندارد logging استفاده کنی. Rich یه Handler داره که گزارش ها رو توی ترمینال مرتب نشون می ده و در عین حال ساختار اصلی لاگ پایتون رو نگه می داره.

import logging
from rich.logging import RichHandler

logging.basicConfig(
    level=logging.INFO,
    format="%(message)s",
    handlers=[RichHandler(rich_tracebacks=True)],
)
logger = logging.getLogger("demo")
logger.info("Application started")
logger.warning("Configuration file not found")

اگه دنبال آموزش Rich پایتون برای پروژه واقعی هستی، بخش بعدی رو با دقت اجرا کن. این بار قرار نیست صرفا یه پیام رنگی ببینی؛ چند بخش کتابخانه Rich در پایتون رو کنار هم می ذاریم و نتیجه رو روی فایل های واقعی پوشه خودمون می بینیم.

پروژه عملی: داشبورد وضعیت فایل ها در ترمینال

حالا بریم سراغ چیزی که من بیشتر دوست دارم: استفاده از آموخته ها توی یه پروژه واقعی و کوچک. می خوایم یک ابزار بسازیم که پوشه ای رو که بهش می دی بررسی کنه، تعداد محدودی فایل رو بخونه، نوار پیشرفت نشون بده و در آخر یه جدول از نام و حجم فایل ها تحویل بده. این پروژه برای یادگیری آموزش Rich پایتون عالیه چون چند قابلیت رو کنار هم می بینی.

برای اینکه مثال قابل اجرا و امن باشه، برنامه فقط فایل ها رو فهرست می کنه و هیچ چیزی رو حذف، ویرایش یا آپلود نمی کنه. اگه دوست داری اول روی یه پوشه آزمایشی اجراش کن. مسیر پوشه رو به صورت آرگومان می دی، و اگر ندادی، روی پوشه فعلی کار می کنه. در نسخه اول فقط فایل های سطح اول پوشه رو می خونه، نه پوشه های تو در تو.

import sys
from pathlib import Path
from rich.console import Console
from rich.panel import Panel
from rich.progress import track
from rich.text import Text
from rich.table import Table

console = Console()
folder = Path(sys.argv[1]) if len(sys.argv) > 1 else Path.cwd()

if not folder.is_dir():
    console.print("[bold red]Invalid folder[/bold red]")
    raise SystemExit(1)

files = sorted((item for item in folder.iterdir() if item.is_file()), key=lambda x: x.name)[:50]
console.print(Panel(Text(f"Scanning: {folder}"), title="File Report", border_style="cyan"))

rows = []
for item in track(files, description="Reading files..."):
    try:
        size = item.stat().st_size
        rows.append((item.name, size))
    except OSError:
        rows.append((item.name, None))

table = Table(title="Local Files")
table.add_column("Name", overflow="fold")
table.add_column("Size (bytes)", justify="right")
for name, size in rows:
    value = str(size) if size is not None else "N/A"
    table.add_row(name, value)

console.print(table)
console.print(f"[green]Done[/green] - {len(rows)} files listed")

این کد رو داخل فایلی به اسم file_report.py ذخیره کن. توی ویندوز بعد از نصب Rich، از محیط مجازی خودت اجراش کن. توی لینوکس و مک هم شکل اجرا همینه، فقط دستور پایتون ممکنه python3 باشه.

python file_report.py .

یه نکته ریز ولی مهم: track() وقتی روی لیستی از فایل ها می چرخه، پیشرفت تعداد آیتم ها رو نشون می ده. اگه پوشه خیلی شلوغ باشه، برنامه فعلا فقط ۵۰ فایل اول رو جدول می کنه که خروجی قابل خوندن بمونه. اگه خواستی تمرینش رو کامل تر کنی، مرتب سازی بر اساس حجم، فیلتر پسوند و خروجی CSV رو خودت اضافه کن.

حالا فرض کن همین ابزار برای بررسی گزارش های یک پروژه شرکت استفاده بشه. با رنگی کردن خروجی پایتون، کاربر سریع می فهمه کار تموم شده یا خطا داشته. اما کیفیت واقعی کار، توی منطق درست بررسی فایل ها و مدیریت خطاست؛ اینجا Rich فقط کمک می کنه نتیجه اون منطق رو بهتر ببینیم.

همین پروژه تمرین خوبیه برای اینکه ببینی زیباسازی ترمینال پایتون باید چه مشکلی رو حل کنه: وقتی ۵۰ اسم فایل داری، بدون جدول پیدا کردن بزرگ ترین مورد سخته؛ وقتی کار طول می کشه، بدون Progress متوجه نمی شی چقدر مونده. از این زاویه، ظاهر بهتر یه ابزار کمکی برای درک اطلاعاته.

Rich بهتره یا colorama، tqdm و Textual؟

طبیعیه که وسط آموزش کتابخانه Rich در پایتون این سؤال برات پیش بیاد: چرا از یه کتابخانه سبک تر استفاده نکنیم؟ جواب بستگی به نیازت داره. هیچ کتابخانه ای برای همه پروژه ها بهترین نیست. اگه فقط یه رنگ ساده می خوای، یه ابزار کوچیک ممکنه کافی باشه؛ اگه گزارش کامل و جدول می خوای، Rich گزینه جذاب تری می شه.

پس اگه دنبال «ساخت رابط گرافیکی در پایتون» هستی، فقط سراغ Rich نرو. این کتابخانه برای محیط خط فرمانه. ولی اگه روی ابزارهای توسعه، اسکریپت های مدیریت سیستم، گزارش گیری یا تست های مجاز امنیتی کار می کنی، به احتمال زیاد Rich خیلی سریع ارزشش رو نشون می ده.

هر ابزار رو برای هدف خودش انتخاب کن. برای رنگی کردن خروجی پایتون و ساخت یک گزارش کامل، Rich کار رو ساده می کنه. برای بازی گرافیکی سنگین یا اپ موبایل ابزار دیگری می خوای؛ به همین دلیل من توصیه نمی کنم فقط چون یه کتابخانه محبوبه، همه پروژه ها رو با اون بسازی.

رفع خطاهای رایج نصب و اجرای Rich

ممکنه با اینکه دستور نصب رو زدی، توی کدت خطا بگیری. اینجا به جای حدس زدن، از خود پیام خطا استفاده کن. مخصوصا اگر چند تا پایتون روی سیستم نصب داری، قبل از هر کاری مسیر مفسر رو چک کن. خیلی از مشکلات ظاهرا مربوط به کتابخانه Rich در پایتون، در واقع به محیط مجازی یا ترمینال برمی گردن.

خطای No module named rich

این پیام معمولا یعنی با یه پایتون Rich رو نصب کردی و با یه پایتون دیگه داری فایل رو اجرا می کنی. دستور نصب رو با همون مسیری اجرا کن که پروژه ازش استفاده می کنه. در VS Code هم گزینه Python Interpreter رو بررسی کن. استفاده کورکورانه از چند دستور pip مختلف معمولا مشکل رو بدتر می کنه.

python -c "import sys; print(sys.executable)"
python -m pip show rich

متن رنگی نمایش داده نمی شه یا همه چیز سیاه و سفیده

اول توی Windows Terminal یا ترمینال واقعی سیستم اجرا کن، نه هر خروجی داخلی IDE. بعضی محیط ها قابلیت ANSI یا رنگ کامل رو محدود می کنن. اگه خروجی رو به فایل یا Pipe فرستادی، Rich ممکنه عمدا رنگ رو حذف کنه تا فایل متنی تمیز بمونه. این رفتار طبیعی و مفیده.

چرا حروف فارسی یا ایموجی توی جدول جابجا می شن؟

نمایش راست به چپ و عرض کاراکترها تا حد زیادی به فونت و موتور رندر ترمینال مربوطه. Windows Terminal، یک ترمینال مدرن لینوکس یا iTerm روی مک ممکنه نتیجه های متفاوتی بدن. برای جدول هایی که خیلی مهمن، می تونی نام ستون ها رو انگلیسی بذاری و قبل از تحویل خروجی فارسی روی محیط واقعی مخاطبت تست کنی.

خطای externally-managed-environment در لینوکس

این پیام بیشتر یعنی توزیع لینوکس اجازه نمی ده با pip سیستم خودش رو مستقیم تغییر بدی. روش درست، ساخت venv و نصب کتابخانه داخل همون محیط مجازیه. نیازی به خاموش کردن محافظت مدیریت بسته ها نیست. اگه تازه لینوکس رو شروع کردی، فهمیدن این موضوع خودش یه قدم مهم توی یادگیری مدیریت محیط پایتونه.

نوار پیشرفت حرکت نمی کنه

اول مطمئن شو حلقه واقعا جلو می ره و کاری که شمردی همون چیزیه که اجرا می کنی. توی محیط های غیر تعاملی یا Notebook ممکنه Refresh مثل ترمینال معمولی نباشه. برای تست اولیه از python -m rich و نمونه track() همین مقاله استفاده کن.

وقتی متن داخل براکت نمایش داده نمی شه

اگه رشته ای شامل براکت های شبیه تگ Rich باشه، ممکنه به عنوان Markup تفسیر بشه. برای داده کاربر از markup=False یا متن مناسب استفاده کن. این قسمت توی ابزارهایی که نام فایل، محتوای خطا یا ورودی ناشناس دارن خیلی مهمه.

در مسیر عیب یابی هم همین نگاه رو داشته باش: آموزش کتابخانه Rich در پایتون از نصب درست محیط شروع می شه. وقتی چند مفسر روی سیستم داری، قبل از پاک و نصب کردن همه چیز، مسیر مفسر و بسته رو بررسی کن. خیلی وقت ها به جای تغییر کلی سیستم، فقط باید Interpreter پروژه رو درست انتخاب کنی.

Rich توی پروژه پایتون، لینوکس و امنیت چه کاربردی داره؟

بچه ها، یکی از چیزهایی که توی آموزش برنامه نویسی دوست دارم روشنش کنم اینه که خروجی خوشگل به تنهایی مهارت نیست. فرض کن داری یه ابزار مانیتورینگ روی لینوکس می نویسی، می خوای وضعیت سرویس ها، فضای دیسک یا نتیجه یک بررسی امنیتی مجاز رو نشون بدی. داشتن یه جدول مرتب و پیام های واضح به درد کاربر می خوره، ولی پشت همون جدول باید بلد باشی داده درست جمع کنی و خطاها رو مدیریت کنی.

اگه می خوای این مسیر رو جدی ادامه بدی، از پایتون برای منطق برنامه، از آموزش لینوکس اسنشیالز برای شناخت سیستم عامل و ترمینال و از آموزش رایگان تست نفوذ برای آشنایی با گزارش گیری و بررسی امنیتی مجاز شروع کن. وقتی اینها رو بفهمی، استفاده از کتابخانه Rich در پایتون برای ساخت گزارش های بهتر خیلی منطقی تر می شه. اگه هنوز پایه پایتونت ضعیفه، اول دوره کامل پایتون نابغه ها رو از نظر سرفصل ها بررسی کن و ببین به کدوم مباحث نیاز داری.

از اون طرف اگه هدف اصلیت ساخت اپ با دکمه، فرم، انیمیشن و رابط بصریه، بد نیست مسیر یادگیری فلاتر رو هم ببینی. Rich و Flutter رقیب مستقیم نیستن؛ یکیش برای خروجی ترمینال و اون یکی برای اپ گرافیکی استفاده می شه. شاید هم از ساخت ابزار کوچک با پایتون خوشت بیاد و بعد بخوای مثل پروژه ساخت بازی فلاپی برد با پایتون سراغ پروژه های جذاب تر بری. مهم اینه که بدونی داری برای چه کسی و چه کاری کد می نویسی.

برای شروع یادگیری، هر هفته یه ابزار کوچک بساز و خروجیش رو بهتر کن. مثلا این هفته یه گزارش فایل، هفته بعد مانیتور وضعیت یک API که خودت داری، و هفته بعد خروجی JSON و لاگ. کم کم می بینی چقدر از چیزهایی که یاد گرفتی کنار هم می شینن. اگه هنوز نمی دونی از کجا شروع کنی، نقشه راه شروع برنامه نویسی هم کمکت می کنه بین مسیرهای مختلف سردرگم نشی.

قبل از سوال ها، یه جمع بندی کوچک از چند مسیر جستجو هم داشته باشیم: آموزش Rich پایتون برای کسی که خروجی حرفه ای می خواد شروع خوبیه؛ رنگی کردن خروجی پایتون برای خوانایی پیام ها کمک می کنه؛ و نوار پیشرفت در پایتون وقتی معنی داره که کار واقعی رو اندازه بگیری. هیچ کدوم به تنهایی جای منطق درست برنامه رو نمی گیرن.

سوالات متداول کتابخانه Rich در پایتون

جمع بندی: از ترمینال ساده تا ابزار قابل استفاده

اگه تا اینجا اومدی، حالا می دونی برای زیباسازی برنامه های پایتون لازم نیست از اول یه رابط گرافیکی بسازی. با کتابخانه Rich در پایتون می تونی خروجی رنگی، جدول، نوار پیشرفت، کادر، نمایش JSON و خطای مرتب داشته باشی. مهم تر اینکه یاد گرفتی هر قابلیت کجا واقعا مفیده و کجا نباید فقط دنبال ظاهر خوشگل باشی.

پیشنهاد می کنم همین الان یه پوشه آزمایشی بسازی و پروژه گزارش فایل رو اجرا کنی. بعدش خودت یک قابلیت بهش اضافه کن، مثلا نمایش بزرگ ترین فایل ها یا ذخیره گزارش CSV. وقتی بتونی یه ابزار ساده رو از مرحله ایده تا اجرا کامل کنی، پایتون برات از چند تا دستور حفظی تبدیل می شه به چیزی که واقعا به کارت میاد.

اگه دوست داشتی توی پایتون جدی تر جلو بری، اول مهارت های پایه رو محکم کن، بعد برو سراغ پروژه های واقعی. دوره ها و آموزش های نابغه ها رو هم می تونی به عنوان مسیر ادامه کار بررسی کنی، ولی قبلش همین تمرین رایگان رو انجام بده؛ از نتیجه اش خیلی چیزها دستت میاد.

راستی اگه دوست داری امکانات Rich رو تصویری ببینی، ویدیوی آموزشی پایین رو هم ببین. توی ویدیو علاوه بر خود کتابخانه، چند تا مفهوم کاربردی پایتون رو هم روی مثال می بینی. می تونی همزمان کدهای بالای صفحه رو توی ترمینال اجرا کنی تا فقط تماشاگر نباشی.