Trailing comma tạo tuple

# Code có vẻ bình thường
def get_user_info():
    return "Alice"
 
user = get_user_info()
print(user)  # In ra gì?

def get_user_info():
    return "Alice",  # Chú ý dấu phẩy!
 
user = get_user_info()
print(user)  # ('Alice',)  <- Tuple, không phải string!
print(type(user))  # <class 'tuple'>

# Trailing comma trong tuple
numbers = (1, 2, 3,)  # Dấu phẩy sau số 3
 
# Trailing comma trong list
fruits = [
    "apple",
    "banana",
    "orange",  # Trailing comma
]
 
# Trailing comma trong dict
person = {
    "name": "Alice",
    "age": 25,  # Trailing comma
}

# Không có trailing comma - chỉ là string
name = "Bob"
print(type(name))  # <class 'str'>
 
# Có trailing comma - thành tuple!
name = "Bob",
print(type(name))  # <class 'tuple'>
print(name)        # ('Bob',)

def get_name():
    return "Alice",  # Trailing comma!
 
result = get_name()
print(result)        # ('Alice',)
print(type(result))  # <class 'tuple'>
 
# Nếu bạn muốn lấy string
name = result[0]     # Phải unpack
print(name)          # Alice

# Dễ nhầm lẫn khi xuống dòng
username = (
    "john_doe",  # Trailing comma vô tình
)
print(type(username))  # <class 'tuple'> - Không phải string!
 
# Đúng - không trailing comma
username = (
    "john_doe"  # Không có dấu phẩy
)
print(type(username))  # <class 'str'>

# KHÔNG có trailing comma
colors = [
    "red",
    "green",
    "blue"  # Không có dấu phẩy
]
 
# Khi thêm phần tử mới, phải sửa 2 dòng:
colors = [
    "red",
    "green",
    "blue",     # Phải thêm dấu phẩy vào đây
    "yellow"    # Dòng mới
]
 
# CÓ trailing comma - Best practice!
colors = [
    "red",
    "green",
    "blue",     # Có sẵn trailing comma
]
 
# Khi thêm phần tử mới, chỉ cần 1 dòng:
colors = [
    "red",
    "green",
    "blue",
    "yellow",   # Chỉ cần thêm dòng này
]

# Function definition
def create_user(
    name,
    age,
    email,
    city,  # Trailing comma OK
):
    pass
 
# Function call
create_user(
    name="Alice",
    age=25,
    email="alice@example.com",
    city="Hanoi",  # Trailing comma OK
)

# Multi-line tuple
coordinates = (
    10,
    20,
    30,  # Trailing comma
)
print(type(coordinates))  # <class 'tuple'>

# Tránh nhầm lẫn - KHÔNG nên
value = "hello",  # Không rõ ràng là cố ý tạo tuple
 
# Rõ ràng hơn
value = ("hello",)  # Có ngoặc đơn, rõ ràng là tuple

# SAI - Vô tình tạo tuple
def get_config():
    return "production",  # Trailing comma vô ý!
 
config = get_config()
print(config)  # ('production',) - Oops!
 
# ĐÚNG
def get_config():
    return "production"  # Không có trailing comma

# Không cần
x = (5,)  # OK nếu muốn tuple
x = 5     # OK nếu muốn int
 
# Tránh nhầm lẫn
y = 10,   # Không rõ ràng
y = (10,) # Rõ ràng hơn (nếu muốn tuple)
y = 10    # Rõ ràng hơn (nếu muốn int)

def calculate_total(prices):
    total = sum(prices)
    return total,  # BUG: Trailing comma!
 
result = calculate_total([10, 20, 30])
print(result)  # (60,) - Tuple thay vì int!
 
# Khi dùng result
tax = result * 0.1  # TypeError: can't multiply sequence by non-int of type 'float'

def get_user_id():
    # ... database query ...
    return "user123",  # BUG: Trailing comma!
 
user_id = get_user_id()
 
# Khi so sánh
if user_id == "user123":  # False! Vì ('user123',) != 'user123'
    print("Match!")
else:
    print("No match")  # In ra dòng này

def api_get_status():
    return "success",  # BUG: Trailing comma!
 
status = api_get_status()
 
# JSON serialization
import json
data = {"status": status}
print(json.dumps(data))  # {"status": ["success"]} - Array thay vì string!

value = some_function()
 
# Debug: In ra type
print(f"Type: {type(value)}, Value: {value}")
 
# Nếu thấy <class 'tuple'> mà không mong muốn -> Kiểm tra trailing comma

# PyCharm sẽ highlight
username = "admin",  # Warning: Trailing comma makes this a tuple

from typing import Tuple
 
# Nếu dùng type hints, sẽ phát hiện lỗi sớm
def get_name() -> str:  # Khai báo return string
    return "Alice",     # Lỗi: Actually returns tuple!

# 1. Trailing comma cho multi-line collections
users = [
    "alice",
    "bob",
    "charlie",  # ✅ Good
]
 
# 2. Trailing comma cho function params
def process(
    data,
    options,
    verbose,  # ✅ Good
):
    pass
 
# 3. Rõ ràng khi tạo single-element tuple
single = (42,)  # ✅ Với ngoặc đơn, rõ ràng

# 1. Trailing comma vô ý trong single-line
name = "admin",  # ❌ Confusing
 
# 2. Trailing comma trong return value đơn
def get_id():
    return 123,  # ❌ Probably a bug
 
# 3. Không nhất quán
data = [
    1,
    2,
    3  # ❌ Inconsistent - nên có trailing comma
]