debundle

Debundle

Esta é uma ferramenta criada para descompactar os pacotes JavaScript Prudeded by Webpack e BrowSerify.

---

? Aqui estão os dragões! ?

Este foi um projeto de pesquisa que não é mais mantido . Eu construí para me ajudar a entender como os pacotes de JavaScript são sofridos. Funciona em um ambiente laboratório na maioria das vezes, mas muitas vezes falha nos feixes JavaScript do mundo real. Já faz um tempo desde que trabalhei neste projeto, por isso, se você tiver problemas, talvez eu não consiga ajudá -lo tanto.

---

Por que eu gostaria de desviar meu código?

Os motivos variam, mas essa ferramenta foi originalmente desenvolvida para me ajudar com um projeto de engenharia reversa. Escusado será dizer que vasculhar pacotes minificados para tentar descobrir como um serviço funciona não é divertido e é muito mais fácil quando esse pacote é dividido em arquivos e esses arquivos têm nomes semânticos.

Instalação

 npm i -g debundle

Correndo

$ 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

Configuração

Configuração simples

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

(Para desviar um pacote simples de webpack, substitua browserify acima da configuração acima com webpack )

Uma configuração pode ter várias bandeiras - elas são documentadas em docs.md.

Perguntas frequentes

Debundling está sem perdas? Isto é, se eu agrupar meu código, então o debruçar, terei a mesma fonte que foi originalmente agrupada?

Não. Lá, um monte de metadados que se perdeu ao agrupar:

• Quaisquer configurações package.json personalizadas para cada node_module e o pacote raiz.
• Em um pacote de webpack, os nomes dos módulos não estão no pacote. Por padrão, o Debundling produzirá arquivos com o nome do ID do módulo (ou seja, 1.js ), a menos que seja substituído manualmente.
• Se o seu código foi minificado, os arquivos de saída do processo de debundação também serão minificados (ou seja, sem espaço em branco, variáveis ​​de letra única, etc.). Cabe a você executar a fonte através de outras ferramentas para torná -la melhor.

Meu código em debundo não pode ser executado!

• Certifique -se de que, ao se reegnitar ou executar com o nó que você esteja usando o arquivo correto como seu ponto de entrada.
• Leia todas as opções de configuração. Alguns deles têm advertências.
• Você poderia ter encontrado um caso de borda que ainda não vi. Sinta -se à vontade para abrir um problema se você acredita que esse seja o caso.

Essa ferramenta suporta pacotes fabricados por ferramentas que não sejam navegadores e webpack?

Não oficialmente. No entanto, se um pacote compartilhar o mesmo layout do módulo de tipo que o BrowSerify ou Webpack, pode ser possível definir a opção de configuração Moduleast para apontar para a localização dos módulos.

Contribuindo

• Depois de clonar o projeto, execute npm install - deve ser isso.
• O ponto de entrada do Debundler é ./src/index.js (é assim que você o executa!)
• Um monte de pacotes de amostra estão em test_bundles/ . Um script, test_bundles/run_test.sh pode executar o debundir contra um determinado pacote e tentar desviar -o em dist/ . (O CI, como parte dos testes de execução, desmembrará todos os pacotes nessa pasta.)
• Certifique -se de que qualquer contribuição passe nos testes: npm test

Nota legal

Algumas empresas especificam em seus termos de serviço que seu código não pode ser "projetado reverso". Definitivamente, o debundling pode (dependendo de como você está usando o código) se enquadra nesse guarda -chuva. Entenda o que você está fazendo para não quebrar nenhum acordado?