debundle

se débrouiller

Ceci est un outil conçu pour déballer les bundles JavaScript répartis par WebPack et Browserify.

---

? Voici des dragons! ?

Il s'agissait d'un projet de recherche qui n'est plus maintenu . J'ai construit pour m'aider à comprendre comment les faisceaux JavaScript sont étouffés. Il fonctionne dans un environnement labratoire la plupart du temps, mais échoue souvent sur les faisceaux JavaScript du monde réel. Cela fait un moment que je n'ai pas travaillé sur ce projet, donc si vous rencontrez des problèmes, je ne pourrais pas vraiment vous aider.

---

Pourquoi voudrais-je réparer mon code?

Les raisons varient, mais cet outil a été initialement développé pour m'aider avec un projet d'ingénierie inverse. Inutile de dire que le crible à travers les faisceaux minifiés pour essayer de comprendre comment un service ne fonctionne pas n'est pas amusant et est beaucoup plus facile lorsque ce bundle est divisé en fichiers et que ces fichiers ont des noms sémantiques.

Installation

 npm i -g debundle

En cours d'exécution

$ 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

Configuration

Configuration simple

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

(Pour démystifier un simple bundle WebPack, remplacez la configuration browserify ci-dessus par webpack )

Une configuration peut avoir un certain nombre de drapeaux - ils sont documentés dans docs.md.

FAQ

Est-ce que débundling est sans perte? C'est-à-dire que si je regroupe mon code, puis-je obtenir la même source qui a été à l'origine regroupé?

Non

• Tous les paramètres package.json personnalisés pour chaque node_module et le package racine.
• Dans un bundle WebPack, les noms des modules ne sont pas dans le bundle. Par défaut, Debundling produira des fichiers nommés d'après l'ID du module (c.- 1.js .
• Si votre code a été minifié, les fichiers de sortie du processus de débandage seront également minifiés (c.-à-d. Aucun espace blanc, variables de lettres uniques, etc.). C'est à vous de faire passer la source à travers d'autres outils pour le rendre plus agréable.

Mon code débunlé ne peut pas être exécuté!

• Assurez-vous que lors du remboursement ou de l'exécution avec le nœud, vous utilisez le fichier correct comme point d'entrée.
• Lisez toutes les options de configuration. Certains d'entre eux ont des mises en garde.
• Vous auriez pu rencontrer un cas de bord que je n'ai pas encore vu. N'hésitez pas à ouvrir un problème si vous croyez que c'est le cas.

Cet outil prend-il en charge les faisceaux fabriqués par des outils autres que Browserify et WebPack?

Pas officiellement. Cependant, si un bundle partage la même disposition du module de type que Browserify ou WebPack, il peut être possible de définir l'option de configuration de la module de module pour pointer à l'emplacement des modules.

Contributif

• Après le clonage du projet, exécutez npm install - ce devrait être le cas.
• Le point d'entrée Debundler est ./src/index.js (c'est comme ça que vous l'exécutez!)
• Un tas de faisceaux d'échantillons sont dans test_bundles/ . Un script, test_bundles/run_test.sh peut exécuter le débundler contre un bundle donné et essayer de le dégonfler dans dist/ . (CI, dans le cadre des tests d'exécution, sera démystifié tous les faisceaux de ce dossier.)
• Assurez-vous que toute contribution passe les tests: npm test

Note juridique

Certaines entreprises spécifient dans leurs conditions d'utilisation que leur code ne peut pas être "inversé". Le débundling peut certainement (selon la façon dont vous utilisez le code) dans ce parapluie. Comprenez ce que vous faites pour ne pas casser les accords?