Ruby Academy · Урок

Выбор формата

Компромиссы

«Выбор формата» — бесплатный урок Ruby Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Ruby Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Ruby Academy содержит 4 уроков всего.

Три формата — три задачи

Теперь Вы знаете JSON, CSV и YAML. Каждый из них лучше всего подходит для разных ситуаций. Правильный выбор позволяет легко создавать, хранить и использовать данные.

JSON для API и веба
CSV для табличных данных и электронных таблиц
YAML для конфигурации

puts ['JSON', 'CSV', 'YAML'].join(', ')

Преимущества JSON

JSON компактен, поддерживается повсеместно и отображается на вложенные хэши и массивы. Это фактический стандарт для веб-API и обмена данными между службами.

require 'json'
puts({ id: 1, items: [1, 2] }.to_json)

Недостатки JSON

В JSON нет комментариев, и его многословно редактировать вручную. Завершающие запятые и одинарные кавычки недопустимы, из-за чего в конфигурационных файлах легко допустить ошибку.

require 'json'
begin
  JSON.parse('{"a":1,}')
rescue JSON::ParserError
  puts 'trailing comma not allowed'
end

Преимущества CSV

CSV идеально подходит для плоских табличных данных: строк и столбцов. Электронные таблицы, экспорт и массовый импорт работают с CSV, а для больших таблиц этот формат исключительно компактен.

require 'csv'
puts(CSV.generate { |c| c << ['a', 'b']; c << [1, 2] })

Недостатки CSV

CSV не может представлять вложенные или иерархические данные. В нём нет стандартной системы типов, поэтому всё остаётся строками, пока Вы не преобразуете данные, а варианты формата (разделители и кавычки) различаются.

require 'csv'
row = CSV.parse_line('5,true')
puts(row[0].class)
puts(row[1].class)

Преимущества YAML

YAML наиболее удобочитаем для людей, поддерживает комментарии и аккуратно обрабатывает вложенность. Поэтому он идеально подходит для конфигурационных файлов, которые разработчики редактируют вручную.

require 'yaml'
text = "# app config\nport: 8081"
puts(YAML.load(text)['port'])

Недостатки YAML

Правила отступов YAML подвержены ошибкам (лишний пробел нарушает структуру), а небезопасная загрузка может представлять угрозу безопасности. Кроме того, YAML разбирается медленнее JSON.

require 'yaml'
cfg = YAML.safe_load("port: 8081")
puts(cfg['port'])

Сравнение вложенности

JSON и YAML естественным образом представляют одну и ту же вложенную структуру, а CSV — нет.

require 'json'
require 'yaml'
data = { 'user' => { 'name' => 'Ada', 'roles' => ['admin'] } }
puts(data.to_json)
puts(data.to_yaml)

Удобочитаемость и компактность

Компромисс таков: YAML наиболее удобочитаем, JSON сбалансирован, а CSV наиболее компактен для таблиц. Выбирайте формат в зависимости от того, кто будет его основным потребителем — люди или машины.

require 'json'
require 'yaml'
h = { 'a' => 1, 'b' => 2 }
puts("JSON len: #{h.to_json.length}")
puts("YAML len: #{h.to_yaml.length}")

Руководство по выбору

Краткие правила:

Обмениваетесь данными с веб-API? JSON
Экспортируете строки для электронной таблицы? CSV
Настройки приложения редактирует человек? YAML

Если сомневаетесь, JSON — наиболее безопасный вариант по умолчанию для обмена данными.

choice = { api: 'JSON', table: 'CSV', config: 'YAML' }
puts(choice[:config])

Преобразование между форматами

Поскольку все три формата разбираются в одинаковые структуры хэшей и массивов Ruby, преобразование выполняется просто: выполните parse для одного формата и dump для другого.

require 'json'
require 'yaml'
data = JSON.parse('{"port":8081,"name":"app"}')
puts(data.to_yaml)

Быстрая проверка

Какой формат лучше всего выбрать по умолчанию для конфигурационного файла, который разработчики редактируют вручную и хотят снабжать комментариями?

Итоги: выбор формата

Теперь Вы можете выбрать подходящий инструмент:

JSON: API, обмен данными, сбалансированность
CSV: плоские таблицы, электронные таблицы, компактность
YAML: конфигурация, удобочитаемость, комментарии, вложенность
Все форматы разбираются в одинаковые структуры Ruby, поэтому преобразование выполняется легко

require 'yaml'
require 'json'
puts(YAML.load('a: 1').to_json)

Часто задаваемые вопросы

Урок «Выбор формата» бесплатный?

Да — полный текст урока «Выбор формата» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Ruby Academy, подпишись на CoddyKit PRO. Курс Ruby Academy содержит 4 уроков всего.

Чему я научусь в уроке «Выбор формата»?

Компромиссы Ты практикуешь Ruby Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Ruby Academy?

Предыдущий опыт не требуется. Ruby Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Выбор формата»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Ruby Academy?

Да. Каждый урок Ruby Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Ruby Academy