XCOP—XML Style Checker

The following text is a partial translation of the original English article, performed by ChatGPT (gpt-3.5-turbo) and this Jekyll plugin:

Одним из самых больших преимуществ XML по сравнению с многими другими форматами данных является его читаемость для человека. Хотя, можно сказать, только до некоторой степени. Действительно, плохо отформатированный XML-документ может быть довольно сложным для восприятия. Сейчас я не говорю о правильности XML, а о его стиле форматирования. Как мы красиво форматируем наши программы на Java/Ruby/Python и затем проверяем их “красоту” с помощью статических анализаторов, так же мы можем проверять наши XML-документы. Шесть лет назад я обратился к сообществу Stack Overflow с просьбой о таком инструменте, но, к сожалению, мой вопрос был оценен негативно и закрыт (чтобы его увидеть, вам понадобится репутация 10 тысяч и более). На прошлой неделе я наконец решил создать такой инструмент сам и назвал его xcop.

Это очень простая командная строка Ruby-пакет. Сначала его нужно установить:

А затем вы просите его проверить ваш XML-файл, скажем, pom.xml:

Если файл не “красивый”, xcop будет жаловаться и показывать, что не так. Вы можете попросить xcop исправить файл.

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

Я считаю, что хорошая практика - использовать xcop вместе с Checkstyle (для файлов Java), Rubocop (для файлов Ruby) и другими статическими анализаторами, чтобы всегда иметь красивый вид ваших XML-файлов.

Прочитайте, как вы можете интегрировать xcop с Rake, Maven и другими средствами сборки. Я буду признателен, если вы внесете свои собственные интеграции.

Translated by ChatGPT gpt-3.5-turbo/42 on 2023-12-27 at 13:59

sixnines availability badge   GitHub stars