آموزش جامع ثابت‌ها و کنوانسیون‌های نامگذاری در پایتون

# تعریف ثابت با استفاده از کنوانسیون نامگذاری (حروف بزرگ)
PI = 3.14159
MAX_CONNECTIONS = 100
DATABASE_URL = "postgresql://localhost:5432/mydb"
# این یک کنوانسیون است، نه یک محدودیت واقعی
PI = 3.14  # از نظر فنی امکان‌پذیر است، اما نباید انجام شود!

# ✅ نام‌های صحیح برای ثابت‌ها
API_KEY = "your_api_key_here"
DEFAULT_TIMEOUT = 30
MAX_FILE_SIZE = 1024 * 1024  # 1MB
SUPPORTED_LANGUAGES = ["fa", "en", "es"]
# ❌ نام‌های نادرست (این‌ها متغیر هستند، نه ثابت)
api_key = "your_api_key_here"
defaultTimeout = 30
MaxFileSize = 1048576

# ثابت‌های ریاضی
PI = 3.141592653589793
E = 2.718281828459045
GOLDEN_RATIO = 1.618033988749895
# ثابت‌های پیکربندی
DATABASE_NAME = "my_app_db"
MAX_USERS = 1000
DEFAULT_CURRENCY = "IRR"
SUPPORT_EMAIL = "support@example.com"
# ثابت‌های وضعیت
STATUS_ACTIVE = "active"
STATUS_INACTIVE = "inactive"
STATUS_PENDING = "pending"

# 📁 constants.py
# ثابت‌های مربوط به پایگاه داده
DB_HOST = "localhost"
DB_PORT = 5432
DB_NAME = "my_database"
# ثابت‌های مربوط به API
API_VERSION = "v1"
MAX_RETRIES = 3
TIMEOUT = 30
# ثابت‌های پیام‌ها
WELCOME_MESSAGE = "خوش آمدید به برنامه ما!"
ERROR_404 = "صفحه مورد نظر یافت نشد"

# 📁 main.py
import constants
# استفاده از ثابت‌ها
print(constants.WELCOME_MESSAGE)
print(f"اتصال به پایگاه داده در پورت {constants.DB_PORT}")

from const import Constant
# تعریف ثابت واقعی
class AppConstants(Constant):
    PI = 3.14159
    MAX_USERS = 1000
    API_KEY = "secret_key_123"
# استفاده از ثابت‌ها
print(AppConstants.PI)  # خروجی: 3.14159
# ❌ این خطا ایجاد می‌کند
try:
    AppConstants.PI = 3.14  # خطا: نمی‌توان ثابت را تغییر داد
except AttributeError as e:
    print(f"خطا: {e}")

pip install const

# ✨ ثابت (کنوانسیون)
COMPANY_NAME = "شرکت نمونه"
TAX_RATE = 0.09
# 🔄 متغیر
user_name = "رضا محمدی"
user_age = 25
is_active = True
# تغییر متغیرها ✅ (مجاز)
user_name = "علی حسینی"
user_age = 26
# تغییر ثابت‌ها ❌ (نادرست - فقط برای نمونه نمایش داده شده)
TAX_RATE = 0.10  # این کار نباید انجام شود!