对calmjs框架的bower支持。
calmjs.bower的Python项目详细描述
卡尔姆斯鲍尔
简介
这个包通过 calmjs 框架。通过使用这个包,可以 通过a bower json 对于给定的 python包,生成一个 bower.json 文件元数据,可以是 其他使用 calmjs 框架。
有关如何工作的详细信息,请参阅 calmjs 包。
安装
而calmjs.bower的目标是引入bower的支持 进入 calmjs ,此库可以在未安装bower的情况下运行 在这之前,可以利用calmjs把bower带入当前 python环境。但是,必须安装 node.js 和 npm ,并且 可实现此功能;如果未安装,请 遵循适合于运行的node.js的安装步骤 环境/平台。
要在给定的python环境中安装calmjs.bower 使用以下命令直接从pypi安装:
$ pip install calmjs.bower
如果需要将bower本地安装到当前目录中, 可以使用以下命令通过 calmjs 完成此操作:
$ calmjs npm --install calmjs.bower
相当于npm安装bower 看起来很有优势,其他的python包声明了 可以像这样调用特定工具集的依赖项,并且 坚持到底。例如, example.package 可以声明 依赖于Bower-Through NPM 加上许多其他包 可通过 bower 获得,该过程随后简单地变成:
$ calmjs npm --install example.package $ calmjs bower --install example.package
example.package的所有标准javascript和node.js依赖项 现在将通过相关的 工具。此过程还将安装所有其他依赖项 其他python包依赖于 example.package 已声明。有关更多用法,请参阅 再往下看文档或 calmjs 的文档
替代安装方法(高级用户)
Calmjs.bower的最新开发仍在进行中 功能和错误修复,开发版本可以通过 吉特喜欢这样:
$ pip install calmjs
$ pip install git+https://github.com/calmjs/calmjs.bower.git#egg=calmjs.bower
或者,可以直接克隆git存储库并执行 python setup.py在源代码的根目录中开发 目录。
请记住 calmjs 必须在 设置之前可用。py 在 calmjs.bower 源代码树中执行,因为它需要 在 calmjs 中编写功能。请参考 基本套装,了解更多信息。
as calmjs 同时声明为命名空间和包,混合 与其他设备一起安装时,采用上述安装方法 calmjs 包可能导致模块导入程序无法查看 向上移动目标模块。虽然这通常不会影响最终用户, 如果它们使用相同的标准安装方法(即车轮), 对于开发人员来说,这可能很麻烦。要解决这个问题,要么坚持 所有包的安装方法相同(即 python setup.py 开发 ),或从main calmjs 包导入模块。在这里 是一个运行示例:
>>>importcalmjs.bowerTraceback(mostrecentcalllast):File"<stdin>",line1,in<module>ImportError:Nomodulenamed'calmjs.bower'>>>importcalmjs.base>>>importcalmjs.bower>>>
如果这种行为(和解决方法)是不可取的,请确保 安装所有与calmjs相关的包都遵循相同的方法 (即对于所有包,要么 python setup.py develop ,要么使用 通过 pip 获得的车轮。
测试安装
为了确保 calmjs 安装正常工作, 内置测试套件可以通过以下命令执行:
$ python -m unittest calmjs.bower.tests.make_suite
如果出现故障,请在问题跟踪程序中使用 完整的回溯和/或安装方法。也请 记住要包含特定于平台的信息,比如python 版本、操作系统环境和版本以及其他相关 与当前问题相关的信息。
用法
calmjs.bower包将在 calmjs 控制台入口点和设置工具 从 当前软件包或当前环境中安装的其他软件包。
如果没有安装声明冲突的包,则 bower 通过环境变量(或 在当前目录的节点模块中,运行该实用程序将 结果如下:
$ calmjs usage: calmjs [-h][-d][-q][-v][-V] <command> ... positional arguments: <command> npm npm compatibility helper bower bower compatibility helper
如果Bower不可用,也会显示警告, 但是,这只会影响需要二进制文件本身的操作。 有关用法的详细信息,请调用 calmjs bower --help
以下帮助概述了带有声明的 bower 的典型用法 通过 calmjs 支持python包,所以大部分帮助是 从该包中复制和共享,从其对 新产品管理
为给定的python包声明a bower.json
如果包希望声明对通过 bower ,它可能在其 设置中执行类似的操作。py :
fromsetuptoolsimportsetupbower_json={"dependencies":{"jquery":"~3.0.0","underscore":"~1.8.0",}}setup(name='example.package',...install_requires=['calmjs.bower',...],bower_json=bower_json,...)
这将允许此包的用户通过 安装中概述的适当的包管理器 部分:
声明对内部路径的显式依赖关系 鲍尔组件
假设对源于 从 bower 中显式指定,构建工具将再次受益 从这些包所需文件的显式声明中。即, 编译后的包可以在 extras\u calmjs 部分声明 在json字符串中非常类似于 bower_json ,例如:
extras_calmjs={'bower_components':{'jquery':'jquery/dist/jquery.js','underscore':'underscore/underscore.js',},}setup(name='example.package',...extras_calmjs=extras_calmjs,...)
由于 bower_components 被声明为一个 附加键, 与 环境将被合并,就像在 bower_json
请注意必须声明完整的路径(注意 .js 示例中包含文件名后缀;目录可以 也要申报。但是,由于这些声明是从内部完成的 python需要显式的完整路径,因此它一直到下游 正确处理和/或将其转换为 标准node.js工具可能期望的约定(即 .js 省略文件名后缀。
到目前为止,对 .bowerrc 配置设置的支持还没有 目前已实现,因此通过calmjs使用 bower 的行为 将不考虑该文件中可能指定的位置。为了 将依赖项安装到某个独立的 目录作为典型的calmjs工作流的一部分,它不应该构成 问题.
故障排除
以下是典型用法可能遇到的一些常见问题 钙质的
运行时警告:找不到"bower"二进制文件;
如果出现此消息,则表示默认模块设置 (即来自calmjs import bower的 )找不到可用的 bower 导入时的二进制/运行时。就像默认运行时一样 各种各样的设置只意味着helper方法可能不可用 开箱即用。这总是可以通过已经有 鲍尔 来纠正的 安装在当前目录中(通过 npm )或 通过 路径 环境变量提供。详细信息 可以执行的操作将写入错误消息。
贡献
- 问题跟踪器:https://github.com/calmjs/calmjs.bower/issues" rel="nofollow">https://github.com/calmjs/calmjs.bower/issues
- 源代码:https://github.com/calmjs/calmjs.bower" rel="nofollow">https://github.com/calmjs/calmjs.bower
法律
calmjs.bower包是calmjs项目的一部分。
CALMJS项目版权所有(c)2016奥克兰生物工程 奥克兰大学研究所。 calmjs.bower 根据 GPLV2或更高版本的条款。