debundle

Debundle

Это инструмент, созданный для распакованности JavaScript Bundles Prudiced Webpack и Browserify.

---

? Здесь будь драконами! ?

Это был исследовательский проект, который больше не поддерживается . Я построил, чтобы помочь мне понять, как javaScript Puckles страдают. Большую часть времени он работает в лабораторной среде, но часто терпит неудачу в реальных связях JavaScript. Прошло много времени с тех пор, как я работал над этим проектом, поэтому, если вы столкнетесь с проблемами, я, возможно, на самом деле не смогу помочь вам все так много.

---

Зачем мне захотеть разобрать свой код?

Причины варьируются, но этот инструмент был первоначально разработан, чтобы помочь мне с обратным проектированием. Само собой разумеется, просеивать минимизированные пачки, чтобы попытаться выяснить, как работает сервис, не является веселым и намного проще, когда этот пакет разбит на файлы, и эти файлы имеют семантические имена.

Установка

 npm i -g debundle

Бег

$ 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

Конфигурация

Простая конфигурация

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

(Чтобы разобраться в простом пакете WebPack, замените browserify вышеуказанной конфигурации на webpack )

Конфигурация может иметь ряд флагов - они задокументированы в docs.md.

Часто задаваемые вопросы

Debundling без потерь? Т.е., если я свяжу свой код, то раздачу, получу ли я тот же источник, который был изначально связан?

Нет. Там куча метаданных, которые теряются при объединении:

• Любой настройки node_module package.json .
• В пакете WebPack имена модулей не в пакете. По умолчанию Debundling будет создавать файлы, названные в честь идентификатора модуля (т.е. 1.js ), если только вручную не переоценку.
• Если ваш код был министерством, выходные файлы из процесса дебюнда также будут минимизированы (т.е. без пробелов, одноразовых переменных и т. Д.). Вы должны запускать источник через другие инструменты, чтобы он выглядел лучше.

Мой Debundled Code не может быть запущен!

• Убедитесь, что при перебоке или запуске с узлом вы используете правильный файл в качестве вашей точки входа.
• Прочитайте все параметры конфигурации. У некоторых из них есть предостережения.
• Вы могли бы столкнуться с краем, который я еще не видел. Не стесняйтесь открывать проблему, если вы считаете, что это так.

Этот инструмент поддерживает комплексы, изготовленные другими инструментами, отличными от браузероиза и WebPack?

Официально не. Однако, если комплект использует тот же макет модуля типа, что и Browserify или Webpack, может быть возможно установить параметр конфигурации Moduleast, чтобы указать на местоположение модулей.

Внося

• После клонирования проекта запустите npm install - это должно быть.
• Точка входа Debundler - ./src/index.js (вот как вы его запускаете!)
• Куча образцов пучков находится в test_bundles/ . Скрипт, test_bundles/run_test.sh может запустить Debundler против данного пакета и попытаться развернуть его в dist/ . (CI будет, как часть запуска тестов, разоблачить все пакеты в этой папке.)
• Убедитесь, что любой вклад проходит тесты: npm test

Юридическая записка

Некоторые компании указывают в своих условиях обслуживания, что их код не может быть «обратно спроектирован». Debundling определенно может (в зависимости от того, как вы используете код) подпадать под этот зонтик. Понять, что вы делаете, чтобы вы не нарушаете никаких соглашений?