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

به کد زیر دقت کنید:
import sys print("All Arguments:", sys.argv) print("Script Name:", sys.argv[0]) print("First Argument:", sys.argv[1]) print("Second Argument:", sys.argv[2]) # etc
من داخل cmd اسکریپت رو بدین شکل باز میکنم:
python tstj.py USER PASS
خروجی زیر بهم برمیگرده:
All Arguments: ['tstj.py', 'USER', 'PASS'] Script Name: tstj.py First Argument: USER Second Argument: PASS
نکته. sys.argv[0] همیشه نام خود اسکریپت هست.
نکته. آرگومانهایی که از خط فرمان میگیری، همیشه از نوع str هستن.
مثال جامع:
import sys if len(sys.argv) < 3: print("Usage: python login.py <username> <password>") sys.exit() username = sys.argv[1] password = sys.argv[2] if username == "admin" and password == "1234": print("Login successful!") else: print("Invalid credentials.")
کدهای بالا یه روش ساده برای کار با آرگومانها در پایتونه. روش حرفهاییتر استفاده از argparse عه.
argparse چیه؟
argparse یه کتابخونهی داخلی پایتونه که کمک میکنه خیلی راحت و حرفهای با آرگومانهای خط فرمان کار کنی.
اگه از sys.argv استفاده کنی، باید خودت دستی چک کنی، پیام خطا بدی، نوعها رو تبدیل کنی و… ولی با argparse این کارا رو خود پایتون برات انجام میده.
ساختار پایهی argparse:
import argparse parser = argparse.ArgumentParser() # یه parser میسازیم parser.add_argument("username") # آرگومان اول parser.add_argument("password") # آرگومان دوم args = parser.parse_args() # آرگومانها رو بخون print("Username:", args.username) print("Password:", args.password)
داخل cmd با این دستور فایل رو اجرا میکنم:
python tstj.py admin 1234
خروجی:
Username: admin Password: 1234
برگردیم به کد! تو خط سوم یه شی از کلاس ArgumentParser ساختم. این شی قراره مسئولیت خوندن و پردازش آرگومانهایی که کاربر به برنامه توی ترمینال میده رو به عهده بگیره.
مثلا وقتی کاربر مینویسه:
python script.py ali
این شی میاد میگه کاربر یه آرگومان به اسم ali داده. بذار ببینم کجا باید بره.
تو خط 4 به parser گفتم من یه آرگومان اجباری دارم به اسم username. هر مقداری که توی خط فرمان بعد از اسم فایل وارد شد، باید بریزی توی این متغیر.
رسیدیم به خط 7. تا اینجا فقط گفتیم چه آرگومانی میخوایم. الان تو این خط میگیم:
برو آرگومانهایی که کاربر وارد کرده رو از خط فرمان بخون، پردازش کن، و بریز داخل یه شی به اسم args.
اگه کاربر داخل cmd چنین دستوری وارد کنه:
python tstj.py admin 1234
مقدار admin ریخته میشه داخل args.username و میتونم مثل خط 9 اون مقدار رو print کنم.

من میتونم با -- یکسری آرگومان اختیاری (Optional arguments) هم تعریف کنم. کد:
import argparse parser = argparse.ArgumentParser() parser.add_argument("--name") # با -- شروع میشه یعنی اختیاریه args = parser.parse_args() print("Hello,", args.name)
داخل cmd مینویسم:
python tstj.py --name Amirhosein
خروجی:
Hello, Amirhosein
اگه هیچی وارد نکنم چی؟ مثال:
python tstj.py
خروجی:
Hello, None
چون آرگومان اختیاریه و مقدار پیشفرضی براش ندادیم، مقدارش None میشه.
نکته. من میتونم برای آرگومان های اختیاری، مقدار پیشفرض تعیین کنم (برای آرگومان های اجباری نمیشه) کد:
parser.add_argument("--lang", default="fa") print(args.lang)
اگه برنامه رو اجرا کنم و هیچ آرگومانی (با اسم lang--) براش تعیین نکنم خروجی fa برمیگرده.
نکته. من میتونم نوع داده آرگومان ها رو تعیین کنم (هم برای آرگومان های دلخواه میشه هم آرگومان های اجباری) مثال:
parser.add_argument("age", type = int)
اگه غیر از عدد چیزی وارد کنم خطا میده! اگه نوع داده رو str قرار بدم، حتی اگه عدد هم وارد کنم به عنوان str قبول میکنه و خطا نمیده.
من میتونم برای هر آرگومان یه توضیح هم قرار بدم. مثال:
parser.add_argument("age", type = int, help = "Enter Your age")
کجا نمایش داده میشه؟ به توضیح پایین دقت کن.
زمانی که دارم از ماژول argparse استفاده میکنم، کاربر میتونه از help-- یا h- استفاده کنه و خود پایتون همه چیز رو براش نمایش میده (من help-- رو تعریف نکردم) مثال کد:
import argparse parser = argparse.ArgumentParser() parser.add_argument("age", type = int, help = "Enter Your age") parser.add_argument("--lang", default = "fa") args = parser.parse_args()
حالا این دستور رو داخل cmd وارد میکنم:
python tstj.py --help یا python tstj.py -h
خروجی:
usage: tstj.py [-h] [--lang LANG] age positional arguments: age Enter Your age options: -h, --help show this help message and exit --lang LANG
یکسری آرگومان هایی وجود داره که مثل دکمه عمل میکنن! یعنی اگه اون آرگومان رو بنویسم، مقدارش True میشه. کد:
parser = argparse.ArgumentParser() parser.add_argument("--verbose", action = "store_true") args = parser.parse_args() print(args.lock)
تو cmd این رو وارد میکنم:
python tstj.py --verbose
خروجی:
True
(یعنی اگه verbose-- رو بنویسی، مقدارش میشه True وگرنه False)
آیا میتونم از هر اسمی که بخوام استفاده کنم؟ صد در صد. کد:
parser = argparse.ArgumentParser() parser.add_argument("--lock", action = "store_true") args = parser.parse_args() print(args.lock)
اگه داخل cmd و بعد از اسم فایل اسکریپت بنویسم lock-- مقدار True برمیگرده و اگه هیچ چیز ننویسم مقدار False.