license-reconcilep - Интернет в облаке

ПРОГРАММА:

ИМЯ

лицензия-согласование - согласование debian / авторских прав с исходным кодом

СИНТАКСИС

согласование лицензий --Помогите|--человек

согласование лицензий [--copyright-file =файл] [--нет проверки авторских прав] [--suggest-строфы]
[--нет спецификации формата] [--тихий] [- отображение-отображение] [--directory =каталог]
[--filters =module1 module2 ...] [--config-file =файл] [--changelog-файл =файл] [файлы ...]

ОПИСАНИЕ

согласование лицензий пытается сопоставить информацию о лицензии и авторских правах в каталоге с
информация доступна в "debian / copyright". Большую часть данных он получает из
"licensecheck" должен произвести что-то стоящее "из коробки". Однако для
данный пакет может быть настроен на успешное выполнение в заведомо исправном состоянии, так что если
при последующих апстрим-обновлениях он терпит неудачу, он указывает на то, на что нужно обратить внимание. По умолчанию
Выполнение тестов выглядит следующим образом:

- Имеется ли в первой строке файла авторских прав утвержденная спецификация формата?
- Можно ли разобрать файл авторских прав?
- Каждый ли файл в источнике соответствует хотя бы одному пункту в файле авторских прав?
- Может ли каждый файл, лицензия и данные об авторских правах, извлеченные из источника, содержаться в
соответствующий соответствующий абзац из файла авторских прав? Данные для этого сравнения
происходит из числа объектов фильтра. См. «Фильтры» для получения дополнительной информации.
- Каждому файлу в источнике присвоены авторские права и лицензия какой-либо частью
файл "debian / copyright".

ПОЛУЧЕНИЕ НАЧАЛ

внешний of домен ящик
С верхнего уровня исходного каталога упакованного программного обеспечения Debian просто запустите
"лицензия-согласование".

установка a конфиг файл
Обычно для достижения прогресса необходим файл конфигурации. По умолчанию
это файл «debian / license -concile.yml». Другой файл конфигурации может быть установлен с помощью
--config-file =файл. Конфигурационный файл интерпретируется с использованием Config :: Any, но для целей
# этой документации мы предполагаем, что используется формат YAML.

переопределение неправильный Результаты
Предположим, вам действительно повезло. Только для одного файла, "a / b", фильтры по умолчанию
обертки вокруг "licensecheck", ошиблись. Почему-то решили, что
файл имеет лицензию GPL-3, когда проверка показывает, что он находится в общественном достоянии. Это
вызывая ложное срабатывание взлома вашего тщательно созданного файла "debian / copyright". Ты
можно исправить это с помощью следующего фрагмента конфигурации:

Правила:
правила:
-
Глоб: а / б
Лицензия: общественное достояние
Авторское право: 1556, Nostrodamus

См. Debian :: LicenseReconcile :: Filter :: Rules для получения дополнительной информации о том, как это настроить.
фильтр.

обеспечение a поймать Найти лицензия и авторское право
Вы можете сделать так, чтобы фильтры предоставляли лицензию по умолчанию, но указав подходящее правило в
Раздел конфигурационного файла по умолчанию:

По умолчанию:
правила:
-
Лицензия: Все программное обеспечение является собственностью пролетариата.
Авторское право: 1984, Министерство алгоритмов

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

управление домен последовательность of фильтры.
По умолчанию выполняются следующие фильтры: Rules, Std, Shebang, ChangeLog и Default. Вы можете варьировать
фильтры, использующие --filters =модуль вариант. Установка "--filters Rules" будет означать, что
будет использоваться только фильтр Debian :: LicenseReconcile :: Filter :: Rules. Как только вы укажете
в одном фильтре вы должны указать их все.

фильтр алиасинг
Фильтр по умолчанию - это псевдоним для правил. Это означает, что он запускает тот же код, но имеет
отдельный конфиг. По умолчанию определяется как «Default ~ Rules». Обычно "X ~ Y" означает использование
код из Y, но получить конфигурацию из X.

письмо надежная собственный фильтр.
Вы можете написать свои собственные фильтры, унаследовав от Debian :: LicenseReconcile :: Filter. Ты
необходимо определить метод "get_info".

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--copyright-file =файл
Укажите альтернативный файл авторских прав. По умолчанию «debian / copyright».

--нет спецификации формата
Не сверяйте первую строку файла авторских прав с допустимыми спецификациями формата.

--нет проверки авторских прав
Не проверяйте статьи об авторских правах.

--тихий
Не давайте никаких объяснений, просто успех или неудача через статус выхода.

- отображение-отображение
Отображение сопоставления каталога с положениями об авторских правах.

--directory =каталог
Каталог, авторские права и лицензии которого будут проверены. По умолчанию это ".".

--filters =module1 --filters =module2 ....
Последовательность фильтров, которые проверят исходный пакет и вернут лицензию и
информация об авторских правах. Имя каждого модуля должно располагаться под
Debian :: LicenseReconcile :: Filter и наследовать от него. Значение по умолчанию - "Стандартные правила".
Shebang ChangeLog по умолчанию ".

--config-file =файл
Файл, используемый для предоставления конкретных данных конфигурации фильтра. Файл читается Config :: Any
и соответствующий раздел передается каждому конструктору фильтра через параметр «config».

<- файл журнала изменений =>файл
Файл журнала изменений Debian, значение по умолчанию - «debian / changelog». Фильтр правил использует это
чтобы получить текущую версию, и фильтр ChangeLog получает из нее свои данные.

--suggest-строфы
Если установлено, распечатайте лицензию и данные об авторских правах в формате DEP-5.

Фильтры

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

- Правила
- Журнал изменений
- Стандарт
- Шебанг
- По умолчанию

Каждому конструктору фильтра будут переданы следующие параметры:

- каталог - каталог, в котором можно найти данные о лицензиях и авторских правах.
- files_remaining - ссылка на массив файлов, которые не анализировались.
- config - структура данных, представляющая часть файла конфигурации, относящуюся к этому
фильтр.
- changelog - объект Parse :: DebianChangelog.
- licensecheck - объект Debian :: LicenseReconcile :: LicenseCheck.

ФАЙЛОВ АРГУМЕНТЫ

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

ОГРАНИЧЕНИЯ

Спецификация DEP-5 немного отличается от спецификации файлового глобуса. Поскольку
Модуль File :: FnMatch - единственная практическая реализация, которая мало что может быть
сделано. Как следствие, попытка указать, что имя файла должно содержать "["
а затем "]" в "debian / copyright" вряд ли будет работать правильно.

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

ПРИМЕРЫ

Два проекта Debian в настоящее время используют согласование лицензий для проверки
файл "debian / copyright".

согласование лицензий | https: //anonscm.debian.org/cgit/pkg-perl/packages/license-reconcile.git/tree/debian/license-reconcile.yml
очевидно, должен быть чистым по своим стандартам. В какой-то момент эта проверка будет добавлена ​​к
тесты сборки.
кш |http://anonscm.debian.org/cgit/collab-maint/ksh.git/tree/debian/license-reconcile.yml
использует согласование лицензий, начиная с версии 93u + 20120801-2.

Используйте license-reconcilep онлайн с помощью сервисов onworks.net