Unduh kat cr - unduh kode sumber kat cr

kat cr

Kode sumber lainnya

1.0.0

Unduh

kat-cr

kat-cr adalah aplikasi CLI sederhana dan fleksibel serta modul simpul yang mencari torrent di kat.cr. JSON API tidak lagi sepenuhnya didukung oleh Kickass Torrents dan RSS feed juga kurang. Mesin pencari berbasis browser utama yang disediakan oleh Kickass Torrents menawarkan fitur paling banyak, sehingga aplikasi ini digunakan untuk mencari torrent.

Instalasi

Untuk menggunakan aplikasi CLI, gunakan

 npm install -g kat-cr

Ini akan menginstal kickass yang dapat dieksekusi ke PATH Anda.

Untuk digunakan sebagai modul, instal ke proyek Anda dengan

 npm install --save kat-cr

Penggunaan Aplikasi CLI

Pencarian torrent dasar akan terlihat seperti ini

 kickass -c tv south park

Dalam contoh ini, flag opsional -c diteruskan untuk menentukan kategori pencarian. kat.cr mengembalikan hasil pencarian dalam kumpulan 25, dan membatasi hasil pada 10.000. Anda dapat menentukan halaman # yang ingin Anda kembalikan dengan meneruskan tanda -p. Jadi jika Anda ingin membuka halaman kedua torrent South Park TV, Anda harus lari

 kickass south park -c tv -p 2

Secara default, kickass akan menampilkan tautan torrent langsung tetapi jika Anda memberikan opsi -m atau --magnet , tautan yang dikembalikan akan menjadi tautan magnet. Sebagai contoh:

 kickass south park -c tv -p 2 -m

Judul torrent akan ditampilkan dengan warna kuning tebal jika torrent tersebut diposting oleh anggota terverifikasi Kickass Torrents, dan akan ada kualifikasi ELITE berwarna ungu sebelum torrent apa pun yang diposting oleh anggota elit Kickass Torrents.

Dan hanya itu saja. Aplikasi dan modul mengurutkan torrent berdasarkan seeder dalam urutan menurun secara default. Untuk mengubah perilaku ini, berikan tanda -f/--field atau -s/--sorder (detail tentang kemungkinan nilai untuk opsi ini ada di bawah). Perhatikan bahwa Anda tidak perlu mengapit kueri penelusuran multi-kata dalam tanda kutip.

Penggunaan modul

Untuk menggunakan modul ini di aplikasi Anda, instal modul ini ke proyek Anda dan gunakan

 var kickass = require('kat-cr');

kat-cr menggunakan API Janji; Anda dapat melakukan pencarian dasar dengan

 kickass('search query').then(function (results) {
  // do something with results
}, function (err) {
 // handle error
});

Anda dapat melakukan pencarian lanjutan dengan meneruskan objek ke fungsi, bukan string. Objek tersebut dapat berisi kunci berikut

search {string}: Permintaan pencarian
category {string}: Kategori pencarian
page {number}: Halaman # dari hasil yang dikembalikan
field {string}: Bidang yang digunakan untuk mengurutkan hasil, defaultnya adalah 'seeder'. Kemungkinan lain termasuk 'time_add', 'files_count', 'size', dan 'leechers'
sorder {string}: Urutan hasil yang ditampilkan, defaultnya adalah 'desc'. Alternatifnya, Anda dapat menggunakan 'asc'

Objek yang diselesaikan dengan janji ini dirancang untuk meniru respons JSON yang dikembalikan oleh Kickass Torrent JSON API yang saat ini kekurangan fitur, tetapi objek sebenarnya adalah objek KickassResultGroup khusus, yang pada tahap ini tidak memiliki metode apa pun pada prototipenya, tetapi berisi beberapa properti yang relevan dengan keseluruhan hasil pencarian:

results.total_results {number}: Jumlah total hasil torrent
results.link {string}: Selalu 'http://kat.cr'
results.language {string}: Dengan menggunakan modul ini Anda akan selalu mendapatkan 'en-us'
results.list {Array}: Array yang berisi torrent dan infonya

Sebagian besar informasinya ada di results.list . Properti objek torrent adalah:

title {string}: Judul torrent
category {string}: Kategori torrent
link {string}: Tautan ke halaman torrent di kat.cr
pubDate {Date}: contoh Tanggal yang mewakili tanggal torrent diterbitkan
torrentLink {string}: Tautan http langsung ke file torrent
magnetLink {string}: Tautan magnet yang terkait dengan torrent
files {number}: Jumlah file yang terkait dengan torrent
comments {number}: Jumlah komentar yang diterima torrent di kat.cr
hash {number}: Intisari hash dari torrent
peers {number}: Jumlah rekan-rekan yang terkait dengan torrent
seeds {number}: Jumlah seeder yang terkait dengan torrent
leechs {number}: Jumlah lintah yang mengunduh torrent
size {number}: Ukuran file yang disediakan oleh torrent, dalam byte
verified {boolean}: Apakah torrent tersebut diposting oleh pengguna terverifikasi Kickass Torrents atau tidak
elite {boolean}: Apakah torrent tersebut diposting oleh pengguna elit Kickass Torrents atau tidak
id {string}: ID torrent di kat.cr yang dapat digunakan untuk memanggil fungsi API

Setiap item di results.list sebenarnya adalah objek KickassResult , yang saat ini memiliki metode berikut pada prototipenya:

KickassResult#getComments() : Mengembalikan janji yang diselesaikan dengan serangkaian objek komentar, yang masing-masing memiliki owner dan properti comment yang mewakili nama layar pembuat komentar dan konten komentar
KickassResult#getDetails() : Buat permintaan HTTP ke halaman web khusus yang terkait dengan hasil torrent dan kembalikan janji yang diselesaikan dengan objek yang berisi detail tambahan tentang torrent. Pada tahap ini satu-satunya detail tambahan yang disediakan oleh objek yang diselesaikan disimpan dalam properti description , yang berisi deskripsi torrent versi teks saja

Contoh

Catat tautan magnetnya dan dapatkan komentar untuk torrent South Park yang paling diunggulkan:

 kickass({
  search: 'south park',
  field: 'seeders',
  sorder: 'desc',
  category: 'tv'
}).then(function (results) {
  console.log(results.list[0].magnetLink);
  results.list[0].getComments().then(function (comments) {
    // do something with comments
  });
});

Catatan

URL ke Kickass Torrents diperkirakan akan berubah. Jika belum diperbarui, masukkan URL baru ke config/kickass-url.json

Selalu perbarui paket kat-cr global Anda.

Pengujian

kat-cr adalah modul web scraping dan karenanya bergantung pada struktur respons pencarian Kickass Torrents, serta nama domain server torrent Kickass saat ini. Jika ada pembaruan pada Kickass Torrents, berjalan

 npm test

di direktori proyek akan menunjukkan apa yang sebenarnya salah dengan upaya untuk mengubah respons pencarian Kickass Torrents menjadi objek KickassResultGroup , dan kontributor diundang untuk mengirimkan permintaan penarikan yang mengoreksi titik akhir API, nama domain, atau pemilih CSS.

Pastikan mocha diinstal secara global, dan Anda menjalankan npm install di direktori proyek sebelum mencoba menjalankan pengujian.

Dokumentasi

Kode sumber didokumentasikan sepenuhnya. Untuk membuat dokumentasi, pastikan paket grunt-cli diinstal secara global dan Anda telah menjalankan npm install di direktori proyek, lalu jalankan