Ini ialah penyelarasan lesen arahan yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
license-reconcile - mendamaikan debian/hak cipta terhadap sumber
SINOPSIS
lesen-mendamaikan - membantu|--lelaki
lesen-mendamaikan [--hak cipta-fail=fail] [--tiada-semak-hak cipta] [--cadang-rangkap]
[--tiada-format-spesifikasi] [--senyap] [--pemetaan paparan] [--direktori=direktori]
[--penapis=modul1 modul2 ...] [--config-file=fail] [--changelog-file=fail] [fail ...]
DESCRIPTION
lesen-mendamaikan cuba memadankan maklumat lesen dan hak cipta dalam direktori dengan
maklumat yang terdapat dalam "debian/hak cipta". Ia mendapat kebanyakan datanya daripada
"pemeriksaan lesen" jadi harus menghasilkan sesuatu yang patut dilihat di luar kotak. Namun bagi a
pakej yang diberikan ia boleh dikonfigurasikan untuk berjaya dalam keadaan baik yang diketahui, supaya jika dihidupkan
kemas kini huluan berikutnya ia gagal, ia menunjukkan perkara yang perlu dilihat. Secara lalainya
ujian yang dijalankan adalah seperti berikut:
- Adakah fail hak cipta mempunyai spesifikasi format yang diluluskan sebagai baris pertamanya?
- Bolehkah fail hak cipta dihuraikan?
- Adakah setiap fail dalam sumber sepadan dengan sekurang-kurangnya satu klausa dalam fail hak cipta?
- Bolehkah setiap fail, lesen dan datum hak cipta yang diekstrak daripada sumber terkandung dalam
perenggan sepadan yang sepadan daripada fail hak cipta? Data untuk perbandingan ini
datang daripada objek penapis nombor. Lihat "Penapis" untuk mendapatkan maklumat lanjut.
- Adakah setiap fail dalam sumber diberikan hak cipta dan lesen oleh beberapa bahagian
fail "debian/hak cipta".
MENDAPAT BERMULA
keluar of yang kotak
Dari peringkat atas direktori sumber perisian pakej Debian, jalankan sahaja
"lesen-mendamaikan".
menetapkan a config fail
Biasanya untuk membuat apa-apa kemajuan adalah perlu untuk mempunyai fail konfigurasi. lalai
fail ialah "debian/license-reconcile.yml". Fail konfigurasi yang berbeza boleh ditetapkan dengan
--config-file=fail. Fail konfigurasi ditafsir menggunakan Config::Any tetapi untuk tujuan tersebut
daripada dokumentasi ini# kami menganggap formatnya ialah YAML.
mengatasi salah keputusan
Katakan anda benar-benar bertuah. Untuk hanya satu fail, "a/b", penapis lalai yang
pembalut di sekitar "pemeriksaan lesen", telah salah faham. Mereka mempunyai sebab tertentu memutuskan itu
fail itu mempunyai lesen GPL-3, apabila pemeriksaan menunjukkan ia berada dalam domain awam. Ini adalah
menyebabkan pemecahan positif palsu terhadap fail "debian/hak cipta" anda yang direka dengan teliti. awak
boleh membetulkannya dengan serpihan konfigurasi berikut:
Peraturan:
peraturan:
-
Glob: a/b
Lesen: domain awam
Hak Cipta: 1556, Nostrodamus
Lihat Debian::LicenseReconcile::Filter::Peraturan untuk mendapatkan maklumat lanjut tentang cara mengkonfigurasi ini
penapis.
menyediakan a menangkap semua lesen and hak cipta terperlihara
Anda boleh membuat penapis menyediakan lesen lalai, tetapi menyediakan peraturan yang sesuai dalam
Bahagian lalai fail konfigurasi:
default:
peraturan:
-
Lesen: Semua perisian adalah hak milik lesen proletariat
Hak Cipta: 1984, Kementerian Algoritma
Penapis Lalai menggunakan kod yang sama seperti penapis Peraturan, tetapi secara lalai dijalankan
terakhir. Jadi ia mempunyai semua fungsi yang sama tetapi keutamaan terendah.
mengawal yang turutan of penapis.
Secara lalai penapisan dijalankan ialah: Peraturan, Std, Shebang, ChangeLog dan Lalai. Anda boleh berbeza-beza
penapis menggunakan --penapis=modul pilihan. Menetapkan "--filters Peraturan" bermakna begitu
hanya penapis Debian::LicenseReconcile::Filter::Rules akan digunakan. Sebaik sahaja anda nyatakan
satu penapis anda mesti nyatakan kesemuanya.
menapis mengasingkan
Penapis lalai ialah alias untuk Peraturan. Ini bermakna ia menjalankan kod yang sama tetapi mempunyai a
konfigurasi berasingan. Lalai ditakrifkan sebagai "Default~Peraturan". Secara umum "X~Y" bermaksud menggunakan
kod dari Y tetapi dapatkan konfigurasi dari X.
bertulis Matlamat sendiri penapis.
Anda boleh menulis penapis anda sendiri dengan mewarisi daripada Debian::LicenseReconcile::Filter. awak
perlu mentakrifkan kaedah "get_info".
PILIHAN
--hak cipta-fail=fail
Tentukan fail hak cipta alternatif. Lalai kepada "debian/hak cipta".
--tiada-format-spesifikasi
Jangan semak baris pertama fail hak cipta terhadap spesifikasi format yang dibenarkan.
--tiada-semak-hak cipta
Jangan semak klausa hak cipta.
--senyap
Jangan beri sebarang penjelasan, sekadar berjaya atau gagal melalui status keluar.
--pemetaan paparan
Paparkan pemetaan dari direktori ke klausa hak cipta.
--direktori=direktori
Direktori yang hak cipta dan lesennya akan disahkan. Ini lalai kepada ".".
--penapis=modul1 --penapis=modul2 ....
Urutan penapis yang akan memeriksa pakej sumber dan mengembalikan lesen dan
maklumat hak cipta. Setiap nama modul mesti terletak di bawah
Debian::LicenseReconcile::Tapis dan warisi daripadanya. Nilai lalai ialah "Peraturan Std
Shebang ChangeLog Lalai".
--config-file=fail
Fail yang digunakan untuk menyediakan data konfigurasi khusus penapis. Fail dibaca oleh Config::Any
dan bahagian yang berkaitan dihantar kepada setiap pembina penapis melalui parameter "config".
<--changelog-file=>fail
Fail changelog Debian yang lalai kepada "debian/changelog". Penapis Peraturan menggunakan ini
untuk mendapatkan versi semasa dan penapis ChangeLog mendapatkan datanya daripadanya.
--cadang-rangkap
Jika ditetapkan, cetak lesen dan data hak cipta dalam format DEP-5.
Penapis
Secara lalai penapis diproses mengikut susunan di bawah. Sebaik sahaja fail telah dikembalikan oleh
penapis, penapis berikutnya akan mengabaikannya.
- Peraturan
- ChangeLog
- Std
- Shebang
- Lalai
Setiap pembina penapis akan diluluskan parameter berikut:
- direktori - direktori untuk mencari data lesen dan hak cipta.
- files_remaining - ref tatasusunan fail yang belum dianalisis.
- config - struktur data yang mewakili bahagian fail konfigurasi yang berkaitan dengan ini
penapis.
- changelog - objek Parse::DebianChangelog.
- licensecheck - objek Debian::LicenseReconcile::LicenseCheck.
FAIL HUJAH
Sebarang hujah selepas hujah diandaikan sebagai fail. Jika dinyatakan hanya fail ini
akan didamaikan.
HADAH
Spesifikasi DEP-5 adalah berbeza secara halus daripada spesifikasi glob fail. Sejak
Fail::Modul FnMatch adalah satu-satunya pelaksanaan praktikal yang boleh dilakukan
selesai. Akibatnya ialah percubaan untuk menentukan bahawa nama fail harus mengandungi '['
dan kemudian ']' dalam "debian/hak cipta" tidak mungkin berfungsi dengan betul.
Dalam tahun penghuraian hak cipta tidak boleh dinyatakan dalam bentuk dua digit yang disingkatkan. Ini adalah
mungkin perkara yang baik, tetapi ia pasti akan menyebabkan masalah pada satu ketika.
CONTOH
Dua projek Debian sedang menggunakan lesen-mendamaikan, untuk mengesahkan
fail "debian/hak cipta".
license-reconcile|https://anonscm.debian.org/cgit/pkg-perl/packages/license-reconcile.git/tree/debian/license-reconcile.yml
jelas mestilah bersih mengikut piawaiannya sendiri. Pada satu ketika semakan ini akan ditambahkan
ujian binaan.
ksh|http://anonscm.debian.org/cgit/collab-maint/ksh.git/tree/debian/license-reconcile.yml
sedang menggunakan license-reconcile sejak versi 93u+20120801-2.
Gunakan license-reconcilep dalam talian menggunakan perkhidmatan onworks.net
