Подробные практические руководства

Сохранить воспроизводимую версию открытых данных

Связать исходный файл, даты, структуру и преобразования, чтобы находить, сравнивать и повторно использовать данные, различая обновления, исправления и изменения охвата.

Обновление :

Проверка файлов и таблиц на организованном рабочем месте.

Иллюстрация, созданная ИИ

Может ли другой читатель восстановить результат?

Ссылка на меняющуюся базу не определяет использованные данные. Исправление меняет старые ряды, экспорт теряет начальные нули, новая колонка меняет смысл итога. Полезная версия объясняет исходный материал и обработку. Цель — воспроизводимость описанной работы, а не универсальная гарантия качества источника.

  1. Определить охват

    Указать производителя, набор, территорию, совокупность, период и фильтры. Разделить даты наблюдения, публикации и получения. Сегодняшняя выгрузка может описывать старый период. Записать вопрос и значимые исключения.

  2. Сохранить использованный вход

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

  3. Описать структуру

    Документировать поля, типы, единицы, ключи и пропуски. В CSV проверить разделитель, кодировку, кавычки и переносы по реальной выгрузке. Идентификаторы с начальными нулями хранить как текст. Различать ноль, отсутствие и неприменимость.

  4. Записать преобразования

    Указать по порядку фильтры, нормализацию, объединения, конвертации и удаление дублей. Разделить исходник и подготовленный результат. Сохранить ключи сопоставления и нерешённые случаи. Похожее имя не основание объединять сущности. Решения должны быть видны, а не скрыты в итоговом файле.

  5. Сравнить версии

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

  6. Подготовить повторное использование

    Связать результат с версией, шагами и ограничениями. Проверить ссылки на производителя и контекст. Подготовить новую выгрузку с критериями сравнения. Старую версию, поддерживающую опубликованный вывод, хранить отдельно с учётом условий и содержащихся данных.

Практикум чтения данных

Пересмотр не переписывает то, что было известно

Набор DEMO вымышлен. Его версии разделяют исторический анализ и анализ исправленных данных.

Вымышленные данные и записи для обучения: результаты не получены запросами к действующим сервисам.

80 в апреле, 82 после исправления в июне

В обоих файлах одинаковые ключ и период. Вымышленный производитель публикует пояснение исправления. Поздняя правка описания не меняет CSV.

Если таблица шире экрана, прокрутите её по горизонтали; стрелки работают, когда область в фокусе.

80 в апреле, 82 после исправления в июне
Вымышленное состояниеДоступный документЧто меняетсяКак указать использование
v1 доступна в апрелеЗначение 80 для изучаемого ключаПубликация до исправленияДля описания доступного в апреле цитировать v1.
v2 опубликована в июнеИсправленное значение 82 и пояснениеИсправлена прошлая запись, не новое событиеДля пересчитанного анализа цитировать v2 и исправление.
Описание изменено после v2Описание уточнено, CSV в примере не меняетсяТолько метаданныеНе выводить новое значение из даты описания.
Оба анализа сохраненыИсторический результат с v1; пересмотренный с v2Временной вопрос и версия источникаНе смешивать версии без пояснения.

Нужно ли незаметно заменить апрельский результат?

Раскройте каждый вариант и сравните разбор. Дополнительные проверки могут оставаться необходимыми.

Да: только новый файл заслуживает сохранения

Нет. Прежняя версия может объяснять опубликованный тогда вывод.

Нет: явно сохранить вопрос, версию и исправление

Да. Отделить известное в апреле от июньского пересчёта; связать результаты с входными файлами.

Совпадающий хеш удостоверяет качество данных

Нет. Он относится к байтам в сравнении с эталоном, а не к точности и репрезентативности числа.

Вымышленный журнал версий

Набор: DEMO; ключ и период прежние
v1: доступна в апреле; значение=80
v2: опубликована в июне; исправленное значение=82
Причина: документированное исправление вымышленного производителя
Позднее описание: только текст, CSV не меняется
Результаты: исторический связан с v1; пересмотренный с v2

Журнал сохраняет оба аналитических вопроса. Хеши определяют использованные файлы, но не делают сохранённую версию истинной.

Документация правил отдельно от вымышленных примеров

Сравнить другие ситуации и упражнения

При открытии меняются идентификаторы

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

Исторический ряд пересмотрен

Новый файл заменяет и прежние значения. Сравнить периоды и ключи, сохранить версии и прочитать пояснения производителя. Отличить исправления от новых наблюдений перед описанием тенденции.

Файл вырос без измеренного улучшения

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

Отличать отсутствие от изменения

Вымышленный пример: A меняется с 10 на 11, B исчезает, C появляется. По ключу id получаются один добавленный ключ, один удалённый и одна изменённая общая запись. Новый столбец указан отдельно без выдуманных старых значений. Перестановка строк сама по себе не даёт изменений.

Упражнение с разбором

Отделить пересмотр от добавления в росте

Вымышленный пример: значения и документы служат для изучения метода и не описывают реальную организацию.

Ключ уникален, показатель аддитивен, словарь не изменился. Удалений нет; «отсутствует» означает отсутствие ключа в версии.

Если таблица шире экрана, прокрутите её по горизонтали; стрелки работают, когда область в фокусе.

Исходные данные
КлючВерсия V1Версия V2
A1010
B2025
CОтсутствует5

Что проверить

  1. Сравнить строки по точному ключу.
  2. Отделить изменение B от добавления C.
  3. Согласовать разницу итогов.
Прочитать разбор

Разбор и решение

Итог V1 — 30, V2 — 40: +10. Среди общих ключей изменение B даёт +5; новый C добавляет +5. A не изменена. Рост итога на 33,33 % нельзя целиком приписывать росту ранее существовавших объектов.

Если условия изменятся

Если в V2 меняется единица или определение, приостановить разложение до проверки сопоставимости.

Что сохранить

Сохранить экспорты и хеши, словари, добавленные/изменённые ключи и формулу сверки.

Что сохранить

  • Производитель, URL, публичные параметры, лицензия и отдельные даты.
  • Версия, отпечаток, структура, единицы и правила пропусков.
  • Порядок преобразований, ключи сопоставления и нерешённые случаи.
  • Сравнение версий, восстановленный результат и пределы интерпретации.

Официальные источники

Связанные протоколы

Проверки перед выводом

  • Сохраняет ли идентификатор все символы после импорта и экспорта, включая ведущие нули?
  • Разделяет ли сравнение изменения значений, схемы и охвата вместо сведения различий к числу строк?
  • Может ли другой читатель восстановить результат из сохранённой версии и описанной последовательности преобразований?

Частые вопросы

Хранить каждую выгрузку?

Сохранять версии, необходимые для работы и выводов, по определённому правилу. Избегать бессмысленных копий и соблюдать условия хранения и использования.

Отпечаток гарантирует качество?

Нет. Он идентифицирует содержимое и помогает заметить изменение, но не подтверждает происхождение, трактовку или значения.

Можно объединять строки по имени?

Сначала проверить ключи, контекст и одноимённых участников. Правило должно обрабатывать неоднозначность и записывать объединения.

Как показывать исправленные данные?

Указать версию и исправление, отделив пересмотренный результат от прежнего. Не выдавать пересмотр за новое наблюдение.

Почему повторяющиеся ключи недопустимы?

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

Что нужно хранить с версией данных?

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

ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ

PROV: версия, процесс и ответственность

PROV-O W3C описывает происхождение данных. Стрелки следуют свойствам, не хронологии слева направо. E0, A и E1 учебные метки.

E0 · EntityA · ActivityE1 · EntityusedwasGeneratedBywasDerivedFrom
PROV: версия, процесс и ответственность
ОриентирЗначение или формаЧто обозначает
prov:EntityДанные/документ в описанном состоянииСущность — данные в описанном состоянии; различайте версии, не только изменяемый URL.
prov:ActivityПроцесс во времениДеятельность — процесс во времени, не его результат.
prov:AgentЧеловек, организация или программный агентАгент несёт ответственность. wasAttributedTo связывает сущность-агент, wasAssociatedWith деятельность-агент, не доказывая лицензию.
prov:usedActivity → Entityused идёт от деятельности к сущности: A использует E0.
prov:wasGeneratedByEntity → ActivitywasGeneratedBy от сущности к деятельности: E1 создана A.
prov:wasDerivedFromEntity → EntitywasDerivedFrom от результата к источнику, без формулы, весов или доказательства верности.
prov:wasRevisionOfEntity → EntityРевизия сохраняет существенное содержимое оригинала; цитирование не обязательно ревизия.
prov:wasQuotedFromEntity → EntityФрагмент повторён из более объёмного источника. Сохраните точный текст и его место: сама связь не указывает положение слов.

Цитата, перевод или новая редакция?

Четыре вымышленных случая показывают, почему связь должна описывать реальное преобразование. Результат — субъект отношения; источник или агент указан справа.

Скопированный фрагмент

quote → prov:wasQuotedFrom → source-v1

Фрагмент повторён из более объёмного источника. Сохраните точный текст и его место: сама связь не указывает положение слов.

Перевод

translation → prov:wasDerivedFrom → source-v1

Перевод — новая производная сущность. Сохраните исходный и целевой языки, версию и проверку точности; отделяйте перевод от исходного фрагмента.

Исправление документа

source-v2 → prov:wasRevisionOf → source-v1

Исправленная версия сохраняет существенную часть предыдущей. Храните оба состояния и изменения; связь не устанавливает, какая версия верна.

Атрибуция результата

analysis → prov:wasAttributedTo → editor

Сущность приписывается агенту. Для ответственности за процесс используется Activity → prov:wasAssociatedWith → Agent. Атрибуция не подтверждает права повторного использования.

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

Что учитывать в досье

Описывайте известное без выдумок. Происхождение не подтверждает расчёт, права или подлинность автоматически. Храните версии и источники.

wasDerivedFrom достаточно для повторения показателя?

Нет: нужны версии, фильтры, формула, параметры и правила пропусков.

Первичная документация

Документация просмотрена .

ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ

Объединение фрагментов: покрытие, пропуски и идентичность представления

Сумма полученных длин может скрывать неполную передачу: перекрытия многократно учитывают одни позиции. Нужно вычислить объединение интервалов и сравнить его с нужным представлением. Геометрическое покрытие не заменяет проверку байтов и происхождения.

Объединение фрагментов: покрытие, пропуски и идентичность представления
ОриентирЗначение или формаЧто обозначает
0-399,300-599,700-999Σ = 1000; ∪ = 900При L = 1 000 фрагменты 0–399, 300–599 и 700–999 дают 1 000 заявленных байтов. Но объединение покрывает лишь 900 позиций: отсутствует 600–699, а 100 получений байтов избыточны.
0-499,500-999∪ = 1000Смежные интервалы объединяются без пропуска: 0–499 и 500–999 покрывают 1 000 позиций. Три получения одного байта дают два избыточных получения, а не две разные перекрытые позиции.
Content-Rangefirst ≤ last < LВ Content-Range ответа конец не может быть меньше начала, а известная полная длина должна строго превышать конец. Неизвестная длина, обозначенная *, не позволяет установить полное покрытие.
ETagstrong validatorФрагменты должны относиться к одному представлению. Для объединения частичных ответов в кеше RFC 9111 требует общего сильного валидатора и выполнения условий HTTP. Совпадение URL или размера не заменяет эту проверку.
If-Rangestrong comparisonIf-Range использует сильное сравнение ETag. Клиент не должен отправлять в нём слабый ETag; при ложном условии Range игнорируется и запрашивается полная передача. Дата допустима лишь при выполнении условий сильного валидатора HTTP.

Проверить покрытие фрагментов

Авторские учебные примеры; реальный сервер не измеряется.

L: целое от 1 до 1 000 000 000 000. От 1 до 20 включительных интервалов a-b, по одному в строке, в пределах представления. Пустые строки пропускаются; пробелы и табуляции по краям разрешены. Не более 2 000 символов; без заголовка HTTP.

Расчёт выполняется в браузере; введённые данные не передаются и не сохраняются.

Расчёт обновлён.

Сумма заявленных длин
1000
Различных покрытых позиций
900
Избыточных получений байтов
100
Недостающих позиций
100

Только арифметическое покрытие: идентичность представления и целостность байтов требуют отдельной проверки.

Покрытие представленияПолоса слева направо: позиции от 0 до L − 1. Сплошные участки покрыты, штрихованные отсутствуют. Таблица содержит точные границы; очень малые диапазоны могут быть незаметны в этом масштабе.0999
Полоса слева направо: позиции от 0 до L − 1. Сплошные участки покрыты, штрихованные отсутствуют. Таблица содержит точные границы; очень малые диапазоны могут быть незаметны в этом масштабе.
Объединение фрагментов
Включительный интервалДлина
0–599600
700–999300
Пропущенные интервалы
Включительный интервалДлина
600–699100

Правила расчёта

sum = Σ(lastᵢ − firstᵢ + 1)
unique = |∪ intervals|
redundant = sum − unique
missing = L − unique
Восемь примеров покрытия
Восемь примеров покрытия
LЗаявленные фрагменты (a-b, по одному в строке)Сумма заявленных длинРазличных покрытых позицийИзбыточных получений байтовНедостающих позицийПропущенные интервалы
10000–399; 300–599; 700–9991000900100100600–699
10000–499; 500–9991000100000Нет
10000–999; 0–9992000100010000Нет
100–0; 0–0; 0–031291–9
109–9; 0–022081–8
102–7; 3–486240–1; 8–9
10–01100Нет
10000000000000–999999999998; 999999999999–9999999999991000000000000100000000000000Нет

Что учитывать в досье

Покрытие предполагает заявленные позиции одного представления. Инструмент не читает файлы и не проверяет ETag, Content-Encoding, кеш или хеш. Он не доказывает равенство байтов в перекрытиях. Полное покрытие не является сертификатом целостности.

Удостоверяет ли совпадающий ETag подлинность документа?

Нет. ETag — валидатор HTTP, не обязательно криптографический хеш или подпись автора. Проверяйте также вариант, длины и фактически полученные байты; отдельно фиксируйте происхождение и проверки целостности.

Первичная документация

Документация просмотрена .

ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ

JSON Patch: операции над текущим документом

Список JSON Patch вычисляется по порядку. Каждый путь обращается к документу после предыдущих операций, а не к неизменному снимку исходного. Девять авторских примеров показывают состояния расчёта и условия остановки.

JSON Patch: операции над текущим документом
ОриентирЗначение или формаЧто обозначает
addinsert / replaceadd вставляет значение по индексу массива, сдвигая следующие элементы; конечный дефис добавляет в конец. В объекте add также заменяет существующий член. Родительский контейнер должен существовать.
remove / replaceexisting targetremove и replace требуют существующей цели. Удаление элемента массива сдвигает большие индексы влево: тот же путь затем может выбрать другой элемент.
moveremove → addmove сначала удаляет значение from, затем добавляет его по path в изменённом документе. При переносе на более позднюю позицию нужны получившиеся индексы. Перенос внутрь собственного потомка запрещён.
copy / testvalue / equalitycopy добавляет значение без связывания двух мест. test сравнивает по правилам JSON, ничего не записывает и останавливает вычисление при неудаче. Порядок членов объекта не влияет на равенство.
HTTP PATCHatomicОшибка останавливает последовательность. HTTP PATCH требует атомарного применения: при неудаче не применяется ни одно изменение. Промежуточные состояния объясняют расчёт, а не уже подтверждённые записи.
Content-Typepatch formatContent-Type различает application/json-patch+json и application/merge-patch+json. Поддержка PATCH не гарантирует оба формата. Предусловие HTTP, например If-Match, может предотвратить обновление устаревшей версии; test не заменяет его автоматически.

Просмотр последовательности JSON Patch

Авторские учебные примеры; реальные документы не изменяются.

Выберите пример и шаг. Каждая операция обращается к предыдущему результату. При ошибке читатель показывает исходную цель для иллюстрации атомарности HTTP; дальнейшие операции не выполняются.

Просмотр готовых примеров; произвольный patch здесь не исполняется.

Исходное состояние · 0 / 2

Исходная цель

{
    "items": [
        "A",
        "B",
        "C"
    ]
}

Операция

На этом шаге операции нет.

Состояние расчёта

{
    "items": [
        "A",
        "B",
        "C"
    ]
}
Девять примеров со всеми состояниями
Удаление и сдвиг индексов
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "items": [
            "A",
            "B",
            "C"
        ]
    }
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "remove",
        "path": "/items/0"
    }

    Состояние расчёта

    {
        "items": [
            "B",
            "C"
        ]
    }
  3. Последовательность успешна

    Операция

    {
        "op": "replace",
        "path": "/items/1",
        "value": "X"
    }

    Состояние расчёта

    {
        "items": [
            "B",
            "X"
        ]
    }
Вставка и добавление в конец
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    [
        "A",
        "C"
    ]
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "add",
        "path": "/1",
        "value": "B"
    }

    Состояние расчёта

    [
        "A",
        "B",
        "C"
    ]
  3. Последовательность успешна

    Операция

    {
        "op": "add",
        "path": "/-",
        "value": "D"
    }

    Состояние расчёта

    [
        "A",
        "B",
        "C",
        "D"
    ]
Null и последующее удаление
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "note": "old",
        "keep": true
    }
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "replace",
        "path": "/note",
        "value": null
    }

    Состояние расчёта

    {
        "note": null,
        "keep": true
    }
  3. Последовательность успешна

    Операция

    {
        "op": "remove",
        "path": "/note"
    }

    Состояние расчёта

    {
        "keep": true
    }
Копия без связи
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "source": {
            "n": 1
        }
    }
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "copy",
        "from": "/source",
        "path": "/backup"
    }

    Состояние расчёта

    {
        "source": {
            "n": 1
        },
        "backup": {
            "n": 1
        }
    }
  3. Последовательность успешна

    Операция

    {
        "op": "replace",
        "path": "/source/n",
        "value": 2
    }

    Состояние расчёта

    {
        "source": {
            "n": 2
        },
        "backup": {
            "n": 1
        }
    }
Перенос после удаления
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    [
        "A",
        "B",
        "C",
        "D"
    ]
  2. Последовательность успешна

    Операция

    {
        "op": "move",
        "from": "/1",
        "path": "/3"
    }

    Состояние расчёта

    [
        "A",
        "C",
        "D",
        "B"
    ]
Ошибка test и атомарность
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "rev": 1,
        "label": "A"
    }
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "replace",
        "path": "/label",
        "value": "B"
    }

    Состояние расчёта

    {
        "rev": 1,
        "label": "B"
    }
  3. Ошибка: HTTP PATCH не применяет изменений

    Операция

    {
        "op": "test",
        "path": "/rev",
        "value": 2
    }

    Состояние расчёта

    {
        "rev": 1,
        "label": "A"
    }
  4. Не выполнено после ошибки

    Операция

    {
        "op": "add",
        "path": "/extra",
        "value": true
    }

    Состояние расчёта

    {
        "rev": 1,
        "label": "A"
    }
Отсутствующий родитель
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "a": []
    }
  2. Ошибка: HTTP PATCH не применяет изменений

    Операция

    {
        "op": "add",
        "path": "/missing/x",
        "value": 1
    }

    Состояние расчёта

    {
        "a": []
    }
Экранированный путь и корень
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "a/b": {
            "~key": 1
        }
    }
  2. Промежуточное состояние, не подтверждено

    Операция

    {
        "op": "test",
        "path": "/a~1b/~0key",
        "value": 1
    }

    Состояние расчёта

    {
        "a/b": {
            "~key": 1
        }
    }
  3. Последовательность успешна

    Операция

    {
        "op": "add",
        "path": "",
        "value": [
            "root"
        ]
    }

    Состояние расчёта

    [
        "root"
    ]
add существующего члена
  1. Исходное состояние

    На этом шаге операции нет.

    Состояние расчёта

    {
        "x": 1
    }
  2. Последовательность успешна

    Операция

    {
        "op": "add",
        "path": "/x",
        "value": 2
    }

    Состояние расчёта

    {
        "x": 2
    }

Что учитывать в досье

Это просмотр документированных примеров, не универсальный исполнитель JSON Patch. Он не обращается к серверу и не предсказывает статус ответа. Показанная атомарность относится к HTTP PATCH; локальная библиотека должна описывать собственные ошибки и изменения данных.

Определяет ли само слово PATCH обработку тела?

Нет. Нужны тип данных и контракт ресурса. Accept-Patch может объявлять поддерживаемые форматы. Название метода и локальный пример не доказывают поддержку формата или разрешение на изменение удалённого API.

Первичная документация

Документация просмотрена .

ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ

SemVer: сравнение приоритета без подмены идентичности

SemVer 2.0.0 задаёт синтаксис и приоритет версий ПО с объявленным публичным API. Сравнение как обычных строк или десятичных чисел даёт ошибки. Дата набора данных или имя тега не принимает этот контракт автоматически.

SemVer: сравнение приоритета без подмены идентичности
ОриентирЗначение или формаЧто обозначает
MAJOR.MINOR.PATCH0 | [1-9][0-9]*Ядро содержит три неотрицательных целых: MAJOR.MINOR.PATCH. Ведущие нули запрещены, кроме самого 0. Тег v1.2.3 может обозначать выпуск, но вся эта строка не является строгой версией SemVer.
1.9.0 / 1.10.0numericЧисла ядра сравниваются численно слева направо. Поэтому 1.9.0 предшествует 1.10.0. SemVer не ограничивает длину числа: инструмент сравнивает цифры без преобразования в числа с плавающей точкой.
-alpha.1pre-releaseПри равном ядре предварительная версия предшествует обычной. Разделённые точками идентификаторы не должны быть пустыми. Чисто числовой идентификатор не допускает ведущих нулей; буква или дефис переводит его в другой случай.
-2 / -alphanumeric < non-numericЧисловые идентификаторы сравниваются численно, остальные — по ASCII. Числовой предшествует нечисловому. При равенстве всех общих идентификаторов больший приоритет имеет предварительная версия с большим их числом.
+001ignored in precedenceМетаданные после + никогда не влияют на приоритет. В отличие от числовых идентификаторов предварительной версии, они могут содержать 001. Разные строки могут иметь равный приоритет, не обозначая одинаковые файлы или взаимозаменяемые артефакты.

Сравнить две версии SemVer

Авторские учебные примеры; реальные выпуски не оцениваются.

Две строгие версии SemVer 2.0.0, не более 256 символов ASCII каждая. Без пробелов, префикса v и операторов ограничений. Числовые идентификаторы сравниваются точно, без округления.

Расчёт локально в браузере; ввод не передаётся и не сохраняется.

A предшествует B в порядке SemVer.

1.9.0 < 1.10.0

Первый решающий критерий : MINOR

Компоненты версий
КомпонентВерсия AВерсия B
MAJOR11
MINOR910
PATCH00
Предварительная частьНетНет
Метаданные сборкиНетНет
Десять сравнений приоритета
Десять сравнений приоритета
Версия A< / = / >Версия BПервый решающий критерий
1.9.0<1.10.0MINOR
2.0.0>1.99.99MAJOR
1.0.9<1.0.10PATCH
1.2.3-rc.9<1.2.3Предварительная и обычная версия
1.2.3-alpha.2<1.2.3-alpha.11Идентификатор предварительной части
1.2.3-9<1.2.3-alphaИдентификатор предварительной части
1.2.3-alpha<1.2.3-alpha.0Число предварительных идентификаторов
1.2.3-Beta<1.2.3-alphaИдентификатор предварительной части
1.2.3+linux.001=1.2.3+windows.002Метаданные не участвуют в приоритете
9007199254740992.0.0<9007199254740993.0.0MAJOR
Десять примеров строгого синтаксиса
Десять примеров строгого синтаксиса
ВводДиагноз
1.2.3Корректна
0.0.0-0Корректна
1.2.3+001Корректна
1.2.3-01aКорректна
1.2.3--Корректна
v1.2.3Некорректна
1.02.3Некорректна
1.2.3-01Некорректна
1.2.3-alpha..1Некорректна
1.2.3+Некорректна

Авторские трактовка и примеры по SemVer 2.0.0, изначально написанному Tom Preston-Werner; исходный текст под CC BY 3.0. SemVer 2.0.0 · CC BY 3.0

Продолжить проверку

Что учитывать в досье

Сравниваются синтаксис и приоритет, а не примечания к выпуску, содержимое, безопасность или реальная совместимость. Ограничения зависимостей, диапазоны npm и версии Python или Debian не поддерживаются. Предел 256 символов принадлежит форме, а не SemVer.

Нужно ли объединять версии равного приоритета в реестре?

Не автоматически. Храните полную строку и ссылку на артефакт: 1.2.3+linux и 1.2.3+windows равны по приоритету, но метаданные могут различать сборки. Хеш и контракт публикации проверяются отдельно.

Первичная документация

Документация просмотрена .

ПОДРОБНЕЕ / ПРАКТИКА

Сохранить различия между версиями набора данных

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

Обновлено .

Приоритетные проверки

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

Ошибки интерпретации

Новая дата загрузки не обязательно означает новый контент. Изменение структуры может сделать грубое сравнение трудно интерпретировать.

Рабочий документ для сохранения

Журнал версий объединяет состояние, отпечатки, изменения и эффект на анализы. Расчеты четко указывают на используемую версию.