calmjs 3.4.1

为给定的python包声明package.json

如果包希望声明对由npm托管的包的依赖关系， 它可以在其 设置中执行类似的操作。py ：

fromsetuptoolsimportsetuppackage_json={"dependencies":{"jquery":"~3.0.0","underscore":"~1.8.0",}}setup(name='example.package',# ...setup_requires=['calmjs',# plus other setup_requires ...],package_json=package_json,# ...)

注意， 安装程序需要 节必须指定 calmjs ，以便 为生成 package.json python时给定包的元数据文件 setup.py egg_info 被执行（直接或间接），这样即使 如果当前python中尚未安装calmjs 环境，它将从pypi获得并作为 设置工具的设置过程，并且不直接依赖于 给定的包。如果 提供的数据是有效的json字符串或没有 不兼容的数据类型。例如：

$ python setup.py egg_info
running egg_info
writing package_json to example.package.egg-info/package.json
...
$ cat example.package.egg-info/package.json
{
    "dependencies": {
        "jquery": "~3.0.0",
        "underscore": "~1.8.0"
    }
}

使用setup需要的关键原因是不强制给定 包的依赖项将 calmjs 作为其依赖项的一部分，作为 通常这只是开发人员的要求，而不是 最终用户。这也意味着对于想要使用calmjs的开发人员来说 和实用程序它们必须单独安装（即 pip install 或者通过 使用附加标志需要 ，例如：

setup(name='example.package',# ...setup_requires=['calmjs',# ...],extras_require={'dev':['calmjs',# ... plus other development dependencies],},# ...)

然后使用 附件下列出的依赖项：

$ pip install -e .[dev]Obtaining file://example/package
...
Installing collected packages: ..., calmjs, ...
  Running setup.py develop for example.package
Successfully installed ...

注意，现在 calmjs 包仍然安装在python中 环境和它们提供的实用程序现在可以使用，包括 以下部分。

处理与python包依赖项的依赖项

平的比嵌套的好。所以所有依赖项 任何上游python包声明的devdependencies 由其所有下游包自动继承，但它们具有 通过这个机制用他们想要的任何东西覆盖它的选项 如上所述。他们可以将javascript或node.js包设置为 无论需要什么版本，甚至只是简单地删除依赖项 完全通过将版本设置为 无

每当calmjs需要一个实际的 包.json 时， calmjs npm 实用程序将展平 python包到一个文件中，然后传递到 各自的javascript包管理器。这个过程是 当a calmjs 工具链或实用程序使用这些 声明信息以生成要实现的所需工件 无论手头有什么需要的任务。

当然，如果包的嵌套样式和依赖项 样式为 npm 是理想的，没有人被迫使用它，它们是免费的 使用任何工具解释或使用任何数据文件 以及可用的依赖项，和/或将其包拆分为python 和javascript位，并在两个pypi上部署和托管它们 （对于 pip ）和 npm ，然后找出如何 它们以连贯的方式重新组合在一起。不要问（或和）争论 作者就后一种选择对每个人来说是更好还是更容易 （开发人员、系统集成商和最终用户）参与。

声明节点模块内部路径的显式依赖关系

假设对源于 显式指定了from npm ，构建工具将再次受益于 对这些包中所需文件的显式声明。即， 编译的包可以在 json字符串很像包json，就像这样：

extras_calmjs={'node_modules':{'jquery':'jquery/dist/jquery.js','underscore':'underscore/underscore.js',},}setup(name='example.package',...extras_calmjs=extras_calmjs,...)

由于node_modules 被声明为一个extras_键，因此有冲突 将解析环境中包之间的声明 并以与在中声明的依赖项冲突相同的方式合并 包json

请注意，必须声明完整的路径名（注意 .js 示例中包含文件名后缀；目录可以 也要申报。但是，由于这些声明是从内部完成的 python需要显式的完整路径，因此它一直到下游 正确处理和/或将其转换为 标准node.js工具可能期望的约定（即 .js 省略文件名后缀。

从python包导出javascript代码

在前面的例子中，如果 示例.包的布局如下：

$ pip install calmjs

$ pip install calmjs

$ pip install calmjs

$ pip install calmjs

$ pip install calmjs

$ pip install calmjs

$ pip install calmjs