XML to YAML

Що таке конвертація XML у YAML?

Конвертація XML у YAML — це процес перетворення даних із формату Extensible Markup Language (XML) у YAML Ain't Markup Language (YAML). XML використовує теги у кутових дужках з атрибутами для опису ієрархічних даних, тоді як YAML представляє ті самі структури через відступи та пари ключ-значення у вигляді звичайного тексту. Конвертація XML у YAML онлайн є поширеним завданням при міграції конфігурацій із XML-орієнтованих систем — таких як Java Spring, Maven або .NET — на платформи, що надають перевагу YAML: Kubernetes, Ansible, GitHub Actions і Docker Compose.

Два формати відрізняються своїми моделями даних. XML за замовчуванням зберігає все як текст і покладається на визначення схем (XSD, DTD) для забезпечення типів. YAML має власні типи: рядки, цілі числа, числа з рухомою комою, булеві значення, null, послідовності (масиви) та відображення (об'єкти). Під час конвертації значення на зразок «true», «5432» і «3.14» можуть бути інтерпретовані як власні типи YAML замість того, щоб залишатися рядками. Уважний конвертер бере ці значення в лапки, щоб зберегти оригінальне текстове представлення із джерела XML.

XML також підтримує конструкції, яким немає відповідника в YAML: атрибути, простори імен, інструкції обробки, секції CDATA та коментарі. Конвертація має обирати конвенцію для представлення атрибутів (зазвичай ключі з префіксом підкреслення, як-от _attr) і вирішувати, відкидати чи вирівнювати решту. Розуміння цих компромісів до початку конвертації допоможе вам обрати правильний інструмент, налаштувати його коректно та перевірити, чи відповідає виведений YAML вихідному задуму XML.

<server>
  <host>db.example.com</host>
  <port>5432</port>
  <credentials admin="true">
    <username>deploy</username>
    <password>s3cret</password>
  </credentials>
  <options>
    <option>ssl=true</option>
    <option>timeout=30</option>
  </options>
</server>

server:
  host: db.example.com
  port: "5432"
  credentials:
    _admin: "true"
    username: deploy
    password: s3cret
  options:
    option:
      - ssl=true
      - timeout=30

Навіщо використовувати онлайн-конвертер XML у YAML?

Написання скрипту конвертації вручну означає роботу з відображенням атрибутів, виявленням масивів для повторюваних елементів та крайовими випадками приведення типів YAML. Браузерний конвертер виконує все це за один крок, дозволяючи вам перевірити YAML-виведення і скопіювати його безпосередньо у файли конфігурації.

Сценарії використання конвертера XML у YAML

Довідник відповідності XML і YAML

XML і YAML мають різні моделі даних. Таблиця нижче показує, як кожна конструкція XML відображається у відповідний еквівалент YAML. Атрибути зазвичай конвертуються у ключі з префіксом підкреслення, а повторювані елементи стають послідовностями YAML. Деякі конструкції — наприклад, коментарі та інструкції обробки — не мають відповідника в YAML і відкидаються під час конвертації.

XML проти YAML: відмінності моделей даних

Конвертація між XML і YAML — це не проста заміна синтаксису. Формати мають принципові структурні відмінності, що впливають на представлення даних після конвертації.

Приклади коду

Нижче наведені робочі приклади конвертації XML у YAML на JavaScript, Python, Go та в командному рядку. Кожен приклад обробляє вкладені елементи, атрибути та повторювані теги-сусіди.

import { parseStringPromise } from 'xml2js'
import YAML from 'yaml'

const xml = `
<config>
  <database host="localhost" port="5432">
    <name>mydb</name>
  </database>
  <features>
    <feature>auth</feature>
    <feature>logging</feature>
  </features>
</config>`

const obj = await parseStringPromise(xml, { explicitArray: false })
console.log(YAML.stringify(obj))
// → config:
// →   database:
// →     $:
// →       host: localhost
// →       port: "5432"
// →     name: mydb
// →   features:
// →     feature:
// →       - auth
// →       - logging

import xmltodict
import yaml

xml = """
<server>
  <host>db.example.com</host>
  <port>5432</port>
  <replicas>
    <replica>node-1</replica>
    <replica>node-2</replica>
  </replicas>
</server>
"""

# Step 1: XML → Python dict
data = xmltodict.parse(xml)

# Step 2: Python dict → YAML
print(yaml.dump(data, default_flow_style=False))
# → server:
# →   host: db.example.com
# →   port: '5432'
# →   replicas:
# →     replica:
# →     - node-1
# →     - node-2

# With the standard library only (no xmltodict)
import xml.etree.ElementTree as ET

def elem_to_dict(elem):
    d = {}
    if elem.attrib:
        d.update({f"_{k}": v for k, v in elem.attrib.items()})
    for child in elem:
        val = elem_to_dict(child)
        if child.tag in d:
            if not isinstance(d[child.tag], list):
                d[child.tag] = [d[child.tag]]
            d[child.tag].append(val)
        else:
            d[child.tag] = val
    if elem.text and elem.text.strip():
        text = elem.text.strip()
        return text if not d else {**d, "_text": text}
    return d

root = ET.fromstring(xml)
print(yaml.dump({root.tag: elem_to_dict(root)}, default_flow_style=False))

# xq is part of the yq package (pip install yq)
# It parses XML via xq and outputs JSON, then pipe to yq for YAML

echo '<config><host>localhost</host><port>8080</port></config>' | xq . | yq -y .
# → config:
# →   host: localhost
# →   port: "8080"

# Using xmlstarlet + yq (Go version: https://github.com/mikefarah/yq)
xmlstarlet sel -t -c '/' input.xml | yq -p=xml -o=yaml
# Reads XML from file and outputs YAML directly

package main

import (
	"encoding/xml"
	"fmt"
	"strings"

	"gopkg.in/yaml.v3"
)

type Server struct {
	XMLName xml.Name `xml:"server"`
	Host    string   `xml:"host" yaml:"host"`
	Port    int      `xml:"port" yaml:"port"`
	Options []string `xml:"options>option" yaml:"options"`
}

func main() {
	data := `<server>
		<host>db.example.com</host>
		<port>5432</port>
		<options><option>ssl=true</option><option>timeout=30</option></options>
	</server>`

	var srv Server
	xml.NewDecoder(strings.NewReader(data)).Decode(&srv)

	out, _ := yaml.Marshal(srv)
	fmt.Println(string(out))
	// → host: db.example.com
	// → port: 5432
	// → options:
	// →   - ssl=true
	// →   - timeout=30
}

Часті запитання