YAML คืออะไร? คู่มือการใช้งาน YAML กับ Python สำหรับไฟล์การตั้งค่า

1. YAML คืออะไร?

ภาพรวมของ YAML

ความแตกต่างระหว่าง JSON และ XML

ความเข้ากันได้ดีกับ Python

2. วิธีอ่านและเขียนไฟล์ YAML ด้วย Python

การอ่านไฟล์ YAML

import yaml

# เปิดไฟล์ YAML และอ่านเนื้อหา
with open('config.yaml', 'r') as file:
    data = yaml.safe_load(file)

print(data)

database:
  host: localhost
  port: 3306

{'database': {'host': 'localhost', 'port': 3306}}

การเขียนไฟล์ YAML

import yaml

data = {
    'name': 'John Doe',
    'age': 30,
    'city': 'New York'
}

with open('output.yaml', 'w') as file:
    yaml.dump(data, file)

age: 30
city: New York
name: John Doe

การจัดการภาษาไทยหรือภาษาญี่ปุ่น

yaml.dump(data, file, allow_unicode=True)

3. การใช้งาน YAML ขั้นสูง

การสร้างแท็กแบบกำหนดเอง

import yaml

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

def person_representer(dumper, data):
    return dumper.represent_mapping('!Person', {'name': data.name, 'age': data.age})

def person_constructor(loader, node):
    values = loader.construct_mapping(node)
    return Person(values['name'], values['age'])

yaml.add_representer(Person, person_representer)
yaml.add_constructor('!Person', person_constructor)

# แปลงอ็อบเจ็กต์เป็น YAML และบันทึก
person = Person('Alice', 25)
with open('person.yaml', 'w') as file:
    yaml.dump(person, file)

# โหลดอ็อบเจ็กต์กลับจาก YAML
with open('person.yaml', 'r') as file:
    loaded_person = yaml.load(file, Loader=yaml.FullLoader)

การคงลำดับข้อมูล

4. ตัวอย่างการใช้ YAML: การจัดการไฟล์การตั้งค่า

ความสะดวกของ YAML ในการใช้เป็นไฟล์การตั้งค่า

database:
  host: localhost
  port: 3306
  username: user
  password: pass

logging:
  level: DEBUG
  file: /var/log/app.log

ตัวอย่างการใช้ YAML ในโปรเจ็กต์จริง

import yaml

with open('config.yaml', 'r') as file:
    config = yaml.safe_load(file)

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': config['database']['name'],
        'USER': config['database']['username'],
        'PASSWORD': config['database']['password'],
        'HOST': config['database']['host'],
        'PORT': config['database']['port'],
    }
}

การเปรียบเทียบกับ JSON และ XML

{
  "database": {
    "host": "localhost",
    "port": 3306,
    "username": "user",
    "password": "pass"
  },
  "logging": {
    "level": "DEBUG",
    "file": "/var/log/app.log"
  }
}

database:
  host: localhost
  port: 3306
  username: user
  password: pass

logging:
  level: DEBUG
  file: /var/log/app.log

5. การแก้ปัญหาและการจัดการข้อผิดพลาด

ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข

import yaml

def load_yaml(file_path):
    try:
        with open(file_path, 'r') as file:
            data = yaml.safe_load(file)
    except FileNotFoundError:
        print(f"Error: The file {file_path} does not exist.")
        return None
    except yaml.YAMLError as e:
        print(f"Error: Failed to parse YAML file. {e}")
        return None
    return data

config = load_yaml('config.yaml')
if config:
    print(config)

แนวทางปฏิบัติที่ดีที่สุดในการจัดการข้อผิดพลาด

1. ตรวจสอบการมีอยู่ของไฟล์: ตรวจสอบว่าไฟล์มีอยู่จริงหรือไม่ หากไม่มีให้แจ้งข้อความแสดงข้อผิดพลาด
2. จัดการข้อผิดพลาดในการ parse: หาก YAML syntax ไม่ถูกต้อง ให้ดักจับข้อผิดพลาดและแจ้งรายละเอียด
3. บันทึก Log: เมื่อเกิดปัญหา ให้บันทึกข้อความผิดพลาดลงใน log เพื่อช่วยในการวิเคราะห์ภายหลัง

6. สรุป