แปลง SCREAMING_SNAKE_CASE เป็น snake_case!

ข้อความตัวอักษร
ผลลัพธ์

แปลง SCREAMING_SNAKE_CASE เป็น snake_case!

การตั้งชื่อตัวแปรในโค้ดที่คัดลอกจากที่อื่นไม่ตรงกับโค้ดของคุณใช่ไหม? ไม่ต้องกังวล! แปลงตัวแปรให้เป็นรูปแบบที่ต้องการ!

เปลี่ยนชื่อแบบ SCREAMING_SNAKE_CASE เป็นตัวพิมพ์เล็กโดยคงขีดล่างไว้: SESSION_COOKIE_AGE → session_cookie_age คำเดิม ตัวคั่นเดิม เปลี่ยนแค่ตัวพิมพ์

ทิศทางนี้ใช้เมื่อค่าคงที่หรือ environment variable ต้องกลายเป็นตัวแปรธรรมดา คีย์ของ dictionary คอลัมน์ในฐานข้อมูล หรือการตั้งค่าใน YAML/TOML เช่น ย้ายการตั้งค่าสไตล์ Django ไปเป็นโมเดล pydantic หรือเปลี่ยนรายการ env var เป็นคีย์ของไฟล์คอนฟิก

วิธีใช้

  1. ใช้ SCREAMING_SNAKE_CASE ด้านซ้ายและ snake_case ด้านขวา
  2. วางค่าคงที่ การตั้งค่า หรือชื่อ env var ลงใน ข้อความตัวอักษร
  3. คัดลอกจาก ผลลัพธ์ ได้เลย

ตัวอย่าง

อินพุต (SCREAMING_SNAKE_CASE)
SESSION_COOKIE_AGE = 1209600
EMAIL_HOST_USER = "noreply@example.com"
_INTERNAL_TOKEN_TTL = 60
เอาต์พุต (snake_case)
session_cookie_age = 1209600
email_host_user = "noreply@example.com"
_internal_token_ttl = 60

ชื่อการตั้งค่าทั้งสามถูกเปลี่ยนเป็นตัวพิมพ์เล็ก ค่าอีเมลและตัวเลขไม่เปลี่ยน และ _INTERNAL_TOKEN_TTL คงขีดล่างนำหน้าไว้เป็น _internal_token_ttl

ฟีเจอร์ที่รองรับ

  • เปลี่ยนตัวอักษรเป็นตัวพิมพ์เล็กและคงขีดล่างทุกตัว รวมถึงตัวที่อยู่หน้าตัวเลข: HTTP_2_ENABLED → http_2_enabled
  • ขีดล่างนำหน้าหนึ่งตัวถูกเก็บไว้
  • คำตัวพิมพ์ใหญ่ที่ไม่มีขีดล่าง (DEBUG, True) ไม่ถูกจับ

กรณีการใช้งาน

จากการตั้งค่า Django ไปเป็นโมเดล pydantic

การตั้งค่าอย่าง EMAIL_HOST_USER กลายเป็นฟิลด์ชื่อ email_host_user บนคลาส BaseSettings และ pydantic ยังอ่าน environment variable ตัวพิมพ์ใหญ่ได้ เพราะการจับคู่ไม่สนตัวพิมพ์โดยค่าเริ่มต้น

จาก env var ไปเป็นคอนฟิก YAML

เมื่อเซอร์วิสย้ายจาก environment variable จำนวนมากไปเป็น config.yaml ไฟล์เดียว ชื่อที่เป็นตัวพิมพ์เล็กคือคีย์ที่ใช้กันตามปกติในไฟล์นั้น

ข้อควรระวังและข้อจำกัด

  • เพราะทั้งสองสไตล์ใช้ตัวคั่นเดียวกัน การแปลงนี้จึงไม่สูญเสียข้อมูลและย้อนกลับได้ตรงตัว
  • ทุกคำตัวพิมพ์ใหญ่ที่มีขีดล่างในข้อความที่วางได้รับผลกระทบ รวมถึงค่าคงที่ของ SQL อย่าง CURRENT_TIMESTAMP ถ้ามีอยู่ในข้อความ

คำถามที่พบบ่อย

ทำไมไม่ใช้คำสั่งเปลี่ยนเป็นตัวพิมพ์เล็กของเอดิเตอร์ไปเลย?

คำสั่งนั้นเปลี่ยนทุกอย่างเป็นตัวพิมพ์เล็ก รวมถึงค่า เนื้อหาในสตริง และคีย์เวิร์ดอย่าง True หน้านี้เปลี่ยนเฉพาะ identifier ที่เป็น SCREAMING_SNAKE_CASE

DEBUG ถูกแปลงไหม?

ไม่ ชื่อต้องมีขีดล่างอย่างน้อยหนึ่งตัวจึงจะถูกจับ ให้เปลี่ยนเป็นตัวพิมพ์เล็กเอง