debundle

Debundle

Ini adalah alat yang dibangun untuk membongkar bundel JavaScript yang ditentukan oleh Webpack dan Browserify.

---

? Di sini menjadi naga! ?

Ini adalah proyek penelitian yang tidak lagi dipertahankan . Saya membangun untuk membantu saya memahami bagaimana bundel JavaScript dituntun. Ini bekerja di lingkungan label hampir sepanjang waktu, tetapi seringkali gagal pada bundel JavaScript dunia nyata. Sudah lama sejak saya mengerjakan proyek ini, jadi jika Anda mengalami masalah, saya mungkin tidak dapat membantu Anda sebanyak itu.

---

Mengapa saya ingin membuat kode saya?

Alasan bervariasi, tetapi alat ini awalnya dikembangkan untuk membantu saya dengan proyek rekayasa terbalik. Tak perlu dikatakan, menyaring bundel yang lebih kecil untuk mencoba dan mencari tahu cara kerja layanan tidak menyenangkan dan jauh lebih mudah ketika bundel itu dipecah menjadi file dan file -file tersebut memiliki nama semantik.

Instalasi

 npm i -g debundle

Berlari

$ debundle
Usage: debundle [input file] {OPTIONS}

Options:
   --input,  -i  Bundle to debundle
   --output, -o  Directory to debundle code into.
   --config, -c  Configuration file

$ curl https://raw.githubusercontent.com/1egoman/debundle/master/test_bundles/browserify/bundle.js > bundle.js
$ curl https://raw.githubusercontent.com/1egoman/debundle/master/test_bundles/browserify/debundle.config.json > debundle.config.json
$ cat debundle.config.json
{
  " type " : " browserify " ,
  " knownPaths " : {}
}
$ debundle -i bundle.js -o dist/ -c debundle.config.json
$ tree dist/
dist/
├── index.js
└── node_modules
    ├── number
    │   └── index.js
    └── uuid
        ├── index.js
        ├── lib
        │   ├── bytesToUuid.js
        │   └── rng.js
        ├── v1.js
        └── v4.js
4 directories, 7 files

Konfigurasi

Konfigurasi sederhana

 {
  "type": "browserify",
  "entryPoint": 1,
  "knownPaths": {}
}

(Untuk merusak bundel webpack sederhana, ganti browserify konfigurasi di atas dengan webpack )

Konfigurasi dapat memiliki sejumlah bendera - mereka didokumentasikan dalam Docs.md.

FAQ

Apakah Debundling Lossless? Yaitu, jika saya menggabungkan kode saya kemudian debundle, apakah saya akan mendapatkan sumber yang sama yang awalnya dibundel?

Tidak. Ada sekelompok metadata yang hilang saat mengikat:

• package.json kustom.json apa pun untuk setiap node_module dan paket root.
• Di bundel webpack, nama -nama modul tidak ada di dalam bundel. Secara default, debundling akan menghasilkan file yang dinamai sesuai dengan ID modul (yaitu, 1.js ) kecuali ditimpa secara manual.
• Jika kode Anda diminifikasi, file output dari proses debundling juga akan diminifikasi (yaitu, tidak ada spasi putih, variabel huruf tunggal, dll). Terserah Anda untuk menjalankan sumber melalui alat lain agar terlihat lebih bagus.

Kode Debundled saya tidak dapat dijalankan!

• Pastikan baik saat membangun kembali atau berjalan dengan simpul yang Anda gunakan file yang benar sebagai titik masuk Anda.
• Baca semua opsi konfigurasi. Beberapa dari mereka memiliki peringatan.
• Anda bisa mengalami kasus tepi yang belum saya lihat. Jangan ragu untuk membuka masalah jika Anda yakin itu terjadi.

Apakah alat ini mendukung bundel yang dibuat oleh alat selain Browserify dan Webpack?

Tidak resmi. Namun, jika bundel membagikan tata letak modul tipe yang sama seperti browserify atau webpack dimungkinkan untuk mengatur opsi konfigurasi Moduleast untuk menunjuk ke lokasi modul.

Berkontribusi

• Setelah mengkloning proyek, jalankan npm install - itu seharusnya.
• Titik masuk debundler adalah ./src/index.js (begitulah cara Anda menjalankannya!)
• Sekelompok bundel sampel ada di test_bundles/ . Sebuah skrip, test_bundles/run_test.sh dapat menjalankan debundler terhadap bundel yang diberikan dan mencoba untuk meremehkannya menjadi dist/ . (CI akan, sebagai bagian dari menjalankan tes, debundle semua bundel di folder itu.)
• Pastikan setiap kontribusi lulus tes: npm test

Catatan hukum

Beberapa perusahaan menentukan dalam persyaratan layanan mereka bahwa kode mereka tidak dapat "direkayasa terbalik". Debundling dapat (tergantung pada bagaimana Anda menggunakan kode) termasuk dalam payung itu. Pahami apa yang Anda lakukan sehingga Anda tidak melanggar perjanjian apa pun?