calmjs.webpack 1.2.0

如何工作

calmjs框架提供了允许python包 声明它们所需的对基于 npm 的包的依赖关系 它们提供的javascript代码，还允许python包公开 它们可能包含在声明性 方式：

包含在 calmjs.webpack中的实用程序提供了使用 这些声明，将javascript文件作为源文件和 编译目标，生成最终可部署工件 从 webpack 包中通过 webpack

而通过python包提供的输入源文件 可以用Webpack理解的任何格式编写，目前只有 标准ES5处理正确。原因是 calmjs.parse ，用于 javascript的解析，目前只理解es5，并被使用 用于提取所有import语句以创建动态calmjs 为webpack导入系统，并传输commonjs和amd（异步模块定义） 需要语句才能使用此动态导入系统。

生成的源将与 从node.js包获取的所有已声明的绑定源 管理器或存储库，以及（可选）生成的导入模块。 然后将生成一个webpack配置文件，其中包含 选定的相关来源，以便生成最终 工件文件。然后可以将它们部署到适当的 环境，或者上述整个过程可以作为 通过提供的api提供python后端的功能 通过这个包裹。

最终，calmjs.webpack的目标是简化集成和 客户端javascript与服务器端python的交互， 通过简化建造、运输和部署 一个共享包和环境中的一组源。卡尔姆斯 框架提供了这两个环境和 那里提供的工具将有助于建立一个共同的， 可复制的本地node.js环境。

最后，对于质量控制，此包与 calmjs.dev ，它提供了设置测试所需的工具 运行javascript测试的环境和工具 相关javascript代码的python包。然而， 该包没有声明为直接依赖项，因为不是所有的 案件将需要该包的可用性。请参考 有关详细信息，请参见安装部分。

安装/使用带有calmjs的webpack

为python包建立开发/构建环境 当前对 webpack 到 calmjs.webpack 的支持 工作目录，可以执行以下命令：

$ calmjs npm --install calmjs.webpack

运行npm install webpack时（连同其他相关软件包 由 calmjs.webpack 声明，它需要从 npm 获得 同样的效果，请注意，calmjs框架使得 npm 要向下传播到依赖包的依赖项；如果 声明 calmjs.webpack 为依赖项的python包 （通过安装需要或附加要求 setup.py ）可能有一整套依赖于 使用以下命令安装（假设包名为 示例.包 ：

$ calmjs npm --install example.package

如果对 calmjs.webpack 的依赖被声明为附加要求 在名为 webpack 的节下，该命令将变为 以下内容：

$ calmjs npm --install example.package[webpack]

如果正确声明依赖项，则使用上述命令将 安装javascript/node.js代码所需的所有依赖项 example.package通过 净现值 。注意，它的依赖项也将获得声明的 依赖关系。

有关所有工作原理的详细信息，请参见 calmjs 的文档。否则，请继续使用 部分：

替代安装方法（高级用户）

目前仍在开发calmjs.webpack 功能和错误修复，开发版本可以通过 吉特喜欢这样：

$ pip install calmjs
$ pip install git+https://github.com/calmjs/calmjs.webpack.git#egg=calmjs.webpack

或者，可以直接克隆git存储库并执行e python setup.py在源代码的根目录中开发 目录。

>>>importcalmjs.webpackTraceback(mostrecentcalllast):File"<stdin>",line1,in<module>ImportError:Nomodulenamed'calmjs.webpack'>>>importcalmjs.base>>>importcalmjs.webpack>>>

$ pip install calmjs.webpack

请注意，两者提供的 必须安装calmjs.dev 和calmjs.webpack 。这个罐头 通过声明适当的安装要求很容易完成，或者 手动安装calmjs.dev，然后从 npm 使用 calmjs npm -d --安装 calmjs.webpack[dev]

动态模块导入

虽然webpack本身在某种程度上支持这一点，但是 仅通过直接的文件系统级支持实现。在 calmjs的例子，在这里输入是通过usi完成的上的ng标识符 在generated webpack.conf.js中显式定义的别名 默认情况下， 网页包 无法解析这些别名。

而不是让contextreplacementplugin工作或编写 另一个webpack插件，一个代理项import模块是 自动生成并包含在每个生成的工件中 动态导入将按预期运行。基本原理 使用它作为解决方法只是希望避免可能的api 作为这些性质的插件，对webpack的更改最终将是 紧密耦合到网页包

通过使用代理项导入模块，动态导入也 在通过calmjs生成的多个web包中工作 webpack，但这是一个高级主题，因此需要进一步的文档 将是必需的，作为具体的申报/进口订单和各种其他 存在使实际使用复杂化的警告（例如正确处理 循环导入将始终是一个非常重要的问题。

对于简单的情况，想象一下下面的javascript代码：

$ pip install calmjs.webpack

9

如果 example/lib/core.js 源文件是由 example 导出的 包并包含在网页包中，上述动态导入应 默认情况下，功能完全没有问题，无需进一步配置。

如果这个动态导入模块功能是不需要的，并且 任何要包含的javascript代码都使用动态导入，这是 功能可能被 --禁用calmjs compat标志禁用。