apic rest到python适配器
arya的Python项目详细描述
#apic rest python适配器(arya)
原作者:paul lesiak-[palesiak@cisco.com](palesiak@cisco.com)
合著者:mike timm-[mtimm@cisco.com](mtimm@cisco.com)
#说明
arya是一个将apic对象文档从其xml或json转换为apic对象文档的工具。 利用cobra sdk形成等价的python代码。
arya支持多种格式的输入,包括xml、json、一个包含 多个XML或JSON文档,以及标准输入。标准输入 选项对于在大多数文本编辑器中用作筛选器非常有用,其中 可以复制从apic visore或api检查器中提取的json或xml,并且很快 生成python源代码框架,然后可以对其进行修改、标记化 很快就变成了功能原型。
注意,雅利雅是一个非常有用的工具,为转换物体的重型提升。 将模型转换为源代码,但是它不验证配置,执行 高级查找逻辑或实现一些应该 接着,执行查找以验证目标,引用对象 属性而不是硬编码dns和名称,以及其他正确的编码实践
强烈建议对于高级用例,获取专家建议 并验证你的代码,你联系思科高级服务的支持。 有关详细信息,请访问http://www.cisco.com/go/aci
如果您遇到与Arya有关的问题,请在Github上打开一个问题
#安装
##环境 必需的
- Python2.7+
推荐:
- pip(从pypi安装)
- git(从github安装)
##下载和安装
选项A:
从pypi下载并安装:
pip install arya
有了这个选项,这是唯一的步骤。
选项B:
如果已安装Git,请克隆存储库
git clone https://github.com/datacenter/arya.git
按照以下说明安装。
选项C:
如果您没有git[下载存储库的zip副本](https://github.com/datacenter/arya/archive/master.zip)并解压缩。
###如果使用选项B或C进行安装
cd arya
运行安装脚本
python setup.py install
检查arya是否可以从命令行运行
$ arya.py
#用法
一旦安装arya,就会将文件arya.py放在您的路径中,因此您应该能够从任何提示调用arya.py。
用法如下:
$ arya.py
- usage: Code generator for APIC cobra SDK [-h] [-f FILEIN] [-s] [-d SOURCEDIR]
- [-t TARGETDIR] [-i IP] [-u USERNAME] [-p PASSWORD] [-nc] [-b]
- optional arguments:
-h, --help show this help message and exit -f FILEIN, --filein FILEIN Document containing post to be sent to REST API -s, --stdin Parse input from stdin, for use as a filter, e.g., cat doc.xml | arya.py -s -d SOURCEDIR, --sourcedir SOURCEDIR Specify a source directory containing ACI object files you want to convert to python. -t TARGETDIR, --targetdir TARGETDIR Where to write the .py files that come from the -d directory. If none is specified, it will default to SOURCEDIR -i IP, --ip IP IP address of APIC to be pre-populated -u USERNAME, --username USERNAME Username for APIC account to be pre-populated in generated code -p PASSWORD, --password PASSWORD Password for APIC account to be pre-populated in generated code -nc, --nocommit Generate code without final commit to changes -b, --brief Generate brief code (without headers, comments, etc) Password for admin account on APIC
#许可证
版权所有(c)2014 Cisco Systems Inc.
根据apache许可证2.0版(以下简称“许可证”)授权; 除非符合许可证,否则您不能使用此文件。 您可以在
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则软件 根据许可证分发是按“原样”分发的, 无任何明示或默示的保证或条件。 有关管理权限的特定语言和 许可下的限制。