uzgadnianie licencji - Online w chmurze

PROGRAM:

IMIĘ

licence-reconcile - uzgadnia debian/prawa autorskie ze źródłem

STRESZCZENIE

uzgadnianie licencji --help|--facet

uzgadnianie licencji [--plik-praw autorskich=filet] [--nie-sprawdzaj-prawa autorskie] [--sugeruj zwrotki]
[--no-format-specyfikacja] [--cichy] [--mapowanie wyświetlania] [--katalog=katalog]
[--filtry=moduł 1 moduł 2 ...] [--config-plik=filet] [--changelog-file=filet] [akta...]

OPIS

uzgadnianie licencji próbuje dopasować informacje o licencji i prawach autorskich w katalogu z
informacje dostępne w „debian/copyright”. Pobiera większość danych z
„licensecheck”, więc powinno dać coś wartego uwagi od razu po wyjęciu z pudełka. Jednak dla
dany pakiet można skonfigurować tak, aby powiódł się w znanym dobrym stanie, więc jeśli jest włączony
kolejne aktualizacje upstream kończą się niepowodzeniem, wskazuje, na co należy zwrócić uwagę. Domyślnie
przebieg testów wygląda następująco:

- Czy plik praw autorskich ma zatwierdzoną specyfikację formatu w pierwszej linii?
- Czy można przeanalizować plik praw autorskich?
- Czy każdy plik w źródle odpowiada przynajmniej jednej klauzuli w pliku dotyczącym praw autorskich?
- Czy każdy plik, licencja i dane dotyczące praw autorskich pobrane ze źródła mogą być zawarte w
odpowiedni pasujący akapit z pliku dotyczącego praw autorskich? Dane do tego porównania
pochodzi z obiektów filtrów liczbowych. Aby uzyskać więcej informacji, zobacz „Filtry”.
- Czy każdemu plikowi w źródle przypisane są prawa autorskie i licencja jakiejś części
plik „debian/copyright”.

DOSTAĆ ZACZĘŁA SIĘ

na zewnątrz of dotychczasowy pudełko
Po prostu uruchom z najwyższego poziomu katalogu źródłowego oprogramowania spakowanego w Debianie
„uzgadnianie licencji”.

ustawienie a config filet
Zwykle, aby uzyskać jakikolwiek postęp, konieczne będzie posiadanie pliku konfiguracyjnego. Domyślny
plik to „debian/license-reconcile.yml”. Można ustawić inny plik konfiguracyjny za pomocą opcji
--config-plik=filet. Plik konfiguracyjny jest interpretowany przy użyciu Config::Any, ale do celów
tej dokumentacji# zakładamy, że format to YAML.

zastępowanie nieprawidłowy wyniki
Załóżmy, że masz naprawdę szczęście. Tylko dla jednego pliku „a/b” są to domyślne filtry
opakowania wokół „licencecheck”, źle to zrozumiałem. Z jakiegoś powodu tak zdecydowali
plik posiada licencję GPL-3, jeśli kontrola wykaże, że należy do domeny publicznej. To jest
powodując fałszywie pozytywne naruszenie starannie przygotowanego pliku „debian/copyright”. Ty
można to naprawić za pomocą następującego fragmentu konfiguracji:

zasady:
zasady:
-
Glob: a/b
Licencja: domena publiczna
Prawa autorskie: 1556, Nostrodamus

Zobacz Debian::LicenseReconcile::Filter::Rules, aby uzyskać więcej informacji na temat konfigurowania tego
filtr.

że a łapać cała kolekcja licencja i prawo autorskie
Możesz ustawić, aby filtry zapewniały domyślną licencję, ale zapewniając odpowiednią regułę w pliku
Domyślna sekcja pliku konfiguracyjnego:

Zaniedbanie:
zasady:
-
Licencja: Całe oprogramowanie jest własnością licencji proletariatu
Copyright: 1984, Ministerstwo Algorytmów

Filtr domyślny używa dokładnie tego samego kodu, co filtr Reguły, ale domyślnie działa
ostatni. Ma więc tę samą funkcjonalność, ale najniższy priorytet.

kontrolowania dotychczasowy sekwencja of filtry.
Domyślnie uruchamiane są filtry: Rules, Std, Shebang, ChangeLog i Default. Możesz się różnić
filtry za pomocą --filtry=moduł opcja. Ustawienie „--filters Rules” mogłoby to oznaczać
używany będzie tylko filtr Debian::LicenseReconcile::Filter::Rules. Gdy już określisz
jeden filtr, musisz określić je wszystkie.

filtrować aliasing
Filtr domyślny jest aliasem Reguł. Oznacza to, że działa ten sam kod, ale ma
osobna konfiguracja. Wartość domyślna jest zdefiniowana jako „Domyślne ~ Reguły”. Ogólnie „X~Y” oznacza użycie
kod z Y, ale pobierz konfigurację z X.

pisanie Twój własny filtr.
Możesz pisać własne filtry, dziedzicząc z Debian::LicenseReconcile::Filter. Ty
należy zdefiniować metodę „get_info”.

OPCJE

--plik-praw autorskich=filet
Określ alternatywny plik praw autorskich. Domyślnie jest to „debian/copyright”.

--no-format-specyfikacja
Nie sprawdzaj pierwszego wiersza pliku dotyczącego praw autorskich pod kątem dozwolonych specyfikacji formatu.

--nie-sprawdzaj-prawa autorskie
Nie sprawdzaj klauzul dotyczących praw autorskich.

--cichy
Nie udzielaj żadnych wyjaśnień, po prostu powiedz o sukcesie lub porażce poprzez status wyjścia.

--mapowanie wyświetlania
Wyświetl mapowanie z katalogu na klauzule dotyczące praw autorskich.

--katalog=katalog
Katalog, którego prawa autorskie i licencje zostaną zweryfikowane. Domyślnie jest to „.”

--filtry=moduł 1 --filtry=moduł 2 ....
Sekwencja filtrów, która sprawdzi pakiet źródłowy i zwróci licencję oraz
Informacje o prawach autorskich. Każda nazwa modułu musi znajdować się poniżej pliku
Debian::LicenseReconcile::Filtruj i dziedzicz z niego. Wartość domyślna to „Reguły Std
Domyślny dziennik zmian Shebang”.

--config-plik=filet
Plik używany do dostarczania danych konfiguracyjnych dotyczących filtra. Plik jest odczytywany przez Config::Any
a odpowiednia sekcja jest przekazywana do każdego konstruktora filtra poprzez parametr „config”.

<--plik-changelog=>filet
Plik dziennika zmian Debiana, którego domyślnym ustawieniem jest „debian/changelog”. Filtr Reguły wykorzystuje to
aby uzyskać aktualną wersję, a filtr ChangeLog pobierze z niej dane.

--sugeruj zwrotki
Jeśli tak, wydrukuj dane licencji i praw autorskich w formacie DEP-5.

filtry

Domyślnie filtry są przetwarzane w poniższej kolejności. Po zwróceniu pliku przez
filtr, kolejne filtry będą go ignorować.

- Zasady
- Dziennik zmian
- Standardowe
- Shebang
- Domyślny

Do każdego konstruktora filtra zostaną przekazane następujące parametry:

- katalog - katalog, w którym można znaleźć dane dotyczące licencji i praw autorskich.
- files_remaining - tablica referencyjna plików, które nie zostały przeanalizowane.
- config - struktura danych reprezentująca odpowiednią do tego część pliku konfiguracyjnego
filtr.
- dziennik zmian - obiekt Parse::DebianChangelog.
- licencjonowanie - obiekt Debian::LicenseReconcile::LicenseCheck.

FILE ARGUMENTY

Zakłada się, że wszelkie argumenty następujące po argumentach są plikami. Jeśli określono tylko te pliki
zostanie pojednany.

OGRANICZENIA

Specyfikacja DEP-5 nieznacznie różni się od specyfikacji globalnej pliku. Od
Moduł File::FnMatch jest jedyną praktyczną implementacją, niewiele może być
zrobione. Konsekwencją jest to, że próba określenia, że ​​nazwa pliku powinna zawierać „[”
a później „]” w „debian/copyright” raczej nie będzie działać poprawnie.

W przypadku analizy praw autorskich lat nie można wyrazić w skróconej formie dwucyfrowej. To jest
prawdopodobnie jest to dobra rzecz, ale z pewnością spowoduje problem w pewnym momencie.

PRZYKŁADY

Dwa projekty Debiana używają obecnie uzgadniania licencji, aby zweryfikować
plik „debian/copyright”.

uzgadnianie licencji|https://anonscm.debian.org/cgit/pkg-perl/packages/license-reconcile.git/tree/debian/license-reconcile.yml
musi oczywiście być czysty według własnych standardów. W pewnym momencie ta kontrola zostanie dodana
testy kompilacji.
ksz|http://anonscm.debian.org/cgit/collab-maint/ksh.git/tree/debian/license-reconcile.yml
używa uzgadniania licencji od wersji 93u+20120801-2.

Skorzystaj z uzgadniania licencji online, korzystając z usług onworks.net