calmjs.bower 1.0.2

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

calmjs.bower仍在开发中，对于最新功能和错误修复，可以通过git安装开发版本，如下所示：

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

或者，可以直接克隆git仓库，在源目录的根目录下执行python setup.py develop。

请注意，在执行calmjs.bower源树中的setup.py之前，calmjs必须可用，因为它需要calmjs中的package_json写入能力。请参阅基本包以获取更多信息。

由于calmjs既被声明为命名空间又被声明为包，因此在安装其他calmjs包时混合上述安装方法可能导致模块导入器无法查找目标模块。虽然这通常不会影响最终用户（只要他们使用相同的标准安装方法，即wheel），但对于开发者来说可能会很麻烦。为了解决这个问题，可以选择为所有包使用相同的安装方法（即对于所有包使用python setup.py develop），或者从主calmjs包导入一个模块。以下是一个示例运行：

>>> import calmjs.bower
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: No module named 'calmjs.bower'
>>> import calmjs.base
>>> import calmjs.bower
>>>

如果这种行为（和解决方案）不理想，请确保所有与calmjs相关的包的安装遵循相同的方法（即对于所有包使用python setup.py develop，或者使用通过pip获得的wheel）。

测试安装

为了确保calmjs的安装正确无误，可以使用以下命令执行内置的测试套件：

$ python -m unittest calmjs.bower.tests.make_suite

如果出现失败，请在问题跟踪器上提交问题，包括完整的堆栈跟踪，以及安装方法。请记住包括平台特定的信息，例如Python版本、操作系统环境和版本，以及与问题相关的其他信息。

声明特定 Python 包的 bower.json

如果某个包希望声明对通过 bower 可用的包的依赖关系，它可以在其 setup.py 中这样做：

from setuptools import setup

bower_json = {
    "dependencies": {
        "jquery": "~3.0.0",
        "underscore": "~1.8.0",
    }
}

setup(
    name='example.package',
    ...
    install_requires=[
        'calmjs.bower',
        ...
    ],
    bower_json=bower_json,
    ...
)

这将允许用户通过上述安装部分中概述的适当包管理器安装所有依赖项。

在 bower_components 内部声明显式依赖关系

鉴于对从 bower 源的特定版本包的依赖关系已显式指定，构建工具将从对这些包中所需文件的显式声明中再次受益。具体来说，编译的包可以在与 bower_json 类似的 JSON 字符串中的 extras_calmjs 部分声明，如下所示：

extras_calmjs = {
    'bower_components': {
        'jquery': 'jquery/dist/jquery.js',
        'underscore': 'underscore/underscore.js',
    },
}

setup(
    name='example.package',
    ...
    extras_calmjs=extras_calmjs,
    ...
)

由于 bower_components 已声明为 extras_key，因此环境内其他包中现有声明的冲突将像 bower_json 中声明的依赖关系部分那样合并。

请注意，必须声明完整路径（请注意，示例中包含 .js 文件名后缀）；也可以声明目录。然而，由于这些声明是在 Python 内部完成的，因此需要显式、完整的路径，因此这取决于下游集成包正确处理和/或将其转换为标准 Node.js 工具可能期望的约定（即省略 .js 文件名后缀）。

到目前为止，尚未实现 .bowerrc 配置设置的支持，因此 calmjs 通过 bower 的使用行为将不考虑在该文件中指定的位置。对于将依赖项安装到作为典型 calmjs 工作流程一部分的某些单独目录的标准用例，这不应成为问题。

RuntimeWarning: 无法定位 'bower' 二进制文件；

如果出现此消息，这仅仅意味着默认模块设置（即 from calmjs import bower）在导入时找不到可用的 bower 二进制/运行时。由于默认运行时进行各种设置，这意味着辅助方法可能无法直接使用。这总是可以通过在当前目录（通过 npm）中预先安装 bower 或通过 PATH 环境变量使其可用来纠正。有关可以执行的操作的详细信息，请参阅错误消息。