Книги
Google Apps Script
Розділ 10. Формати даних та серіалізація
Робота з YAML

Google Apps Script:
Робота з YAML

Як:

Хоча Google Apps Script (GAS) не підтримує вроджений аналіз YAML або серіалізацію, ви можете маніпулювати даними YAML, використовуючи бібліотеки JavaScript або пишучи власні функції аналізу. Для демонстрації розглянемо, як аналізувати рядок YAML за допомогою користувацької функції, оскільки зовнішні бібліотеки не можна безпосередньо імпортувати в GAS.

Припустимо, у вас є проста конфігурація YAML:

title: Приклад YAML
description: Приклад того, як обробити YAML в Google Apps Script
tags:
  - Google Apps Script
  - YAML
  - Конфігурація

Для аналізу цього в Google Apps Script використовуйте можливості маніпулювання рядками JavaScript:

function parseYAML(yamlString) {
  var result = {};
  var lines = yamlString.split("\n");
  for (var i = 0; i < lines.length; i++) {
    var line = lines[i];
    if (line.includes(":")) {
      var parts = line.split(":");
      var key = parts[0].trim();
      var value = parts[1].trim();
      // Основна обробка масивів
      if (value.startsWith("-")) {
        value = [value.substring(1).trim()];
        while (i + 1 < lines.length && lines[i + 1].trim().startsWith("-")) {
          i++;
          value.push(lines[i].trim().substring(1).trim());
        }
      }
      result[key] = value;
    }
  }
  return result;
}

function testYamlParsing() {
  var yaml = "title: Приклад YAML\ndescription: Приклад того, як обробити YAML в Google Apps Script\ntags:\n  - Google Apps Script\n  - YAML\n  - Конфігурація";
  var parsed = parseYAML(yaml);
  Logger.log(parsed);
}

Коли виконується testYamlParsing(), виводиться:

{ title: 'Приклад YAML',
  description: 'Приклад того, як обробити YAML в Google Apps Script',
  tags: [ 'Google Apps Script', ' YAML', ' Конфігурація' ] }

Цей користувацький метод аналізу досить основний і може вимагати коригування для роботи зі складними файлами YAML.

Поглиблено

YAML, що був випущений у 2001 році, мав на меті бути більш читабельним ніж його попередники, такі як XML або JSON. Хоча його простота та зручність використання широко цінуються, робота з YAML у Google Apps Script представляє певні виклики через відсутність прямої підтримки. У результаті програмісти часто покладаються на універсальність JavaScript для аналізу та генерації даних YAML. Однак для складних випадків використання, особливо тих, що включають глибоку вкладеність та розширені структури даних, цей метод може бути обтяжливим і схильним до помилок.

JSON, навпаки, підтримується вроджено в Google Apps Script та більшості інших програмних середовищ, пропонуючи більш простий підхід для серіалізації та десеріалізації даних без додаткової обробки. Синтаксис JSON менш мовазначний, ніж синтаксис YAML, що робить його більш придатним для обміну даними в веб-додатках. Однак YAML залишається популярним для файлів конфігурації та ситуацій, де читабельність для людини є пріоритетною.

При роботі з YAML у Google Apps Script розгляньте компроміси між читабельністю та зручністю використання. Для всебічної маніпуляції з YAML може бути варто дослідити зовнішні інструменти або сервіси, які можуть конвертувати YAML у JSON перед обробкою його у вашому скрипті.

Робота з XML