license-reconcilep - Online di Cloud

PROGRAM:

NAMA

license-reconcile - merekonsiliasi debian/hak cipta dengan sumber

RINGKASAN

rekonsiliasi-lisensi --membantu|--pria

rekonsiliasi-lisensi [--file-hak cipta=fillet] [--tanpa-cek-hak cipta] [--suggest-bait]
[--tidak ada-format-spesifikasi] [--diam] [--pemetaan-tampilan] [--direktori=direktori]
[--filter=modul 1 modul 2 ...] [--file-config=fillet] [--changelog-file=fillet] [file ...]

DESKRIPSI

rekonsiliasi-lisensi mencoba mencocokkan informasi lisensi dan hak cipta dalam direktori dengan
informasi yang tersedia di "debian/hak cipta". Ia mendapatkan sebagian besar datanya dari
"licensecheck" jadi harus menghasilkan sesuatu yang layak dilihat di luar kotak. Namun untuk
paket yang diberikan dapat dikonfigurasi untuk berhasil dalam keadaan baik yang diketahui, sehingga jika aktif
pembaruan hulu berikutnya gagal, ini menunjukkan apa yang perlu dilihat. Secara default
pengujian yang dijalankan adalah sebagai berikut:

- Apakah file hak cipta memiliki spesifikasi format yang disetujui sebagai baris pertama?
- Bisakah file hak cipta diurai?
- Apakah setiap file dalam sumber cocok dengan setidaknya satu klausa dalam file hak cipta?
- Dapatkah setiap file, lisensi, dan datum hak cipta yang diekstrak dari sumbernya dimuat di
paragraf yang cocok yang sesuai dari file hak cipta? Data untuk perbandingan ini
berasal dari sejumlah objek filter. Lihat "Filter" untuk informasi lebih lanjut.
- Apakah setiap file dalam sumber diberikan hak cipta dan lisensi oleh beberapa bagian dari
berkas "debian/hak cipta".

MENDAPATKAN DIMULAI

di luar of itu kotak
Dari tingkat atas direktori sumber perangkat lunak paket Debian, jalankan saja
"lisensi-rekonsiliasi".

pengaturan a config fillet
Biasanya untuk membuat kemajuan apa pun, Anda perlu memiliki file konfigurasi. Standarnya
filenya adalah "debian/license-reconcile.yml". File konfigurasi yang berbeda dapat diatur dengan
--file-config=fillet. File konfigurasi ditafsirkan menggunakan Config::Any but for the purpose
dari dokumentasi ini# kami menganggap formatnya adalah YAML.

utama salah hasil
Misalkan Anda benar-benar beruntung. Untuk hanya satu file, "a/b", filter default yang
pembungkus di sekitar "lisensi", salah. Mereka karena suatu alasan memutuskan itu
file tersebut memiliki lisensi GPL-3, saat pemeriksaan menunjukkan bahwa file tersebut berada dalam domain publik. Ini adalah
menyebabkan jeda positif palsu terhadap file "debian/hak cipta" Anda yang dibuat dengan hati-hati. Anda
dapat memperbaikinya dengan fragmen konfigurasi berikut:

Aturan:
aturan:
-
Bola: a/b
Lisensi: domain publik
Hak Cipta: 1556, Nostrodamus

Lihat Debian::LicenseReconcile::Filter::Rules untuk informasi lebih lanjut tentang cara mengkonfigurasi ini
menyaring.

menyediakan a menangkap semua lisensi dan hak cipta
Anda dapat membuat filter memberikan lisensi default, tetapi memberikan aturan yang sesuai di
Bagian default dari file konfigurasi:

Default:
aturan:
-
Lisensi: Semua perangkat lunak adalah milik lisensi proletariat
Hak Cipta: 1984, Kementerian Algoritma

Filter Default menggunakan kode yang persis sama dengan filter Aturan, tetapi secara default berjalan
terakhir. Jadi ia memiliki semua fungsi yang sama tetapi prioritas terendah.

mengendalikan itu urutan of filter.
Secara default filter yang dijalankan adalah: Rules, Std, Shebang, ChangeLog dan Default. Anda dapat bervariasi
filter menggunakan --filter=modul pilihan. Menyetel "--filters Rules" berarti bahwa
hanya filter Debian::LicenseReconcile::Filter::Rules yang akan digunakan. Setelah Anda menentukan
satu filter Anda harus menentukan semuanya.

menyaring alias
Filter Default adalah alias untuk Aturan. Ini berarti ia menjalankan kode yang sama tetapi memiliki
konfigurasi terpisah Default didefinisikan sebagai "Default~Aturan". Secara umum "X~Y" berarti menggunakan
kode dari Y tetapi dapatkan konfigurasi dari X.

penulisan Tujuan sendiri menyaring.
Anda dapat menulis filter Anda sendiri dengan mewarisi dari Debian::LicenseReconcile::Filter. Anda
perlu mendefinisikan metode "get_info".

PILIHAN

--file-hak cipta=fillet
Tentukan file hak cipta alternatif. Default ke "debian/hak cipta".

--tidak ada-format-spesifikasi
Jangan periksa baris pertama file hak cipta terhadap spesifikasi format yang diizinkan.

--tanpa-cek-hak cipta
Jangan periksa klausa hak cipta.

--diam
Jangan memberikan penjelasan apa pun, cukup berhasil atau gagal melalui status keluar.

--pemetaan-tampilan
Tampilkan pemetaan dari direktori ke klausa hak cipta.

--direktori=direktori
Direktori yang hak cipta dan lisensinya akan diverifikasi. Ini default ke ".".

--filter=modul 1 --filter=modul 2 ....
Urutan filter yang akan memeriksa paket sumber dan mengembalikan lisensi dan
informasi hak cipta. Setiap nama modul harus berada di bawah
Debian::LicenseReconcile::Filter dan mewarisinya. Nilai defaultnya adalah "Aturan Std
Shebang ChangeLog Default".

--file-config=fillet
File yang digunakan untuk menyediakan data konfigurasi khusus filter. File dibaca oleh Config::Any
dan bagian yang relevan diteruskan ke setiap konstruktor filter melalui parameter "config".

<--changelog-file=>fillet
File changelog Debian yang defaultnya adalah "debian/changelog". Filter Aturan menggunakan ini
untuk mendapatkan versi saat ini dan filter ChangeLog mendapatkan datanya dari itu.

--suggest-bait
Jika diatur, cetak data lisensi dan hak cipta dalam format DEP-5.

filter

Secara default, filter diproses dalam urutan di bawah ini. Setelah file dikembalikan oleh
filter, filter berikutnya akan mengabaikannya.

- Aturan
- Ubah Log
- St
- Shebang
- Bawaan

Setiap konstruktor filter akan melewati parameter berikut:

- direktori - direktori untuk menemukan data lisensi dan hak cipta.
- files_remaining - ref array file yang belum dianalisis.
- config - struktur data yang mewakili bagian dari file konfigurasi yang relevan dengan ini
menyaring.
- changelog - objek Parse::DebianChangelog.
- licensecheck - objek Debian::LicenseReconcile::LicenseCheck.

FILE ARGUMEN

Argumen apa pun setelah argumen dianggap sebagai file. Jika ditentukan hanya file-file ini
akan didamaikan.

PEMBATASAN

Spesifikasi DEP-5 agak berbeda dari spesifikasi file glob. Sejak
File::Modul FnMatch adalah satu-satunya implementasi praktis yang bisa dilakukan
selesai. Konsekuensinya adalah mencoba menentukan bahwa nama file harus berisi '['
dan kemudian ']' di "debian/hak cipta" tidak mungkin berfungsi dengan benar.

Dalam penguraian hak cipta, tahun tidak dapat dinyatakan dalam bentuk dua digit yang disingkat. Ini adalah
mungkin hal yang baik, tetapi itu pasti akan menyebabkan masalah di beberapa titik.

CONTOH

Dua proyek Debian saat ini menggunakan rekonsiliasi lisensi, untuk memverifikasi
berkas "debian/hak cipta".

lisensi-rekonsiliasi|https://anonscm.debian.org/cgit/pkg-perl/packages/license-reconcile.git/tree/debian/license-reconcile.yml
jelas harus bersih menurut standarnya sendiri. Pada titik tertentu cek ini akan ditambahkan ke
tes membangun.
ksh|http://anonscm.debian.org/cgit/collab-maint/ksh.git/tree/debian/license-reconcile.yml
menggunakan rekonsiliasi-lisensi sejak versi 93u+20120801-2.

Gunakan rekonsiliasi-lisensi online menggunakan layanan onworks.net