Veracity的命令行界面Python包装器。
项目描述
简介
此库提供了Veracity的命令行界面的Python包装器。它包括用于存储库、工作副本和其他常用项目的对象。该库还安装了几个命令行工具，用于与Veracity的分布式构建跟踪功能一起使用。
入门指南
要求
Python 3.3
Veracity 2.5
依赖项
sh: https://pypi.python.org/pypi/sh (Mac/Linux的子进程包装器)
pbs: https://pypi.python.org/pypi/pbs (Windows的子进程包装器)
virtualenv: https://pypi.python.org/pypi/virtualenv (隔离构建)
安装
可以使用pip安装此包
pip install python-veracity
或直接从源代码安装
python setup.py install
安装后，可以在名称为veracity下使用
>>> import veracity >>> veracity.__version__ >>> from veracity import vv >>> vv.version() >>> vv.repos()
脚本接口
一个示例脚本可能看起来像以下这样
#!/usr/bin/env python
from veracity import Repository, WorkingCopy, Item
# Clone a repo
repo = Repository('veracity', remote='http://public.veracity-scm.com/repos/veracity')
# Display Repository attributes
print repo.name
print repo.users
print repo.branches
print repo.tags
# Check out a working copy (from a Repository)
work = repo.checkout("~/v/veracity")
work.delete()
# Check out a working copy (by repo name)
work = WorkingCopy("~/v/veracity", repo='veracity')
work.update(branch='master')
# Change some files
item = Item('docs/GettingStarted.txt', work=work)
item.lock()
构建跟踪
此包还安装了一套命令行工具，用于与Veracity的构建跟踪功能一起使用：http://veracity-scm.com/qa/questions/123
配置
在你的主分支中，创建一个类似于以下的setup.cfg
[vv-tracking] repositories = python-veracity series = N, C environments = W, M, L virtualenv = True [vv-poller] N_branches = * N_command = [ $( date "+%H" ) = 00 ] N_command-nt = if %TIME:~0,2%==00 (exit /b 0) else (exit /b 1) N_sleep = 60 * 30 N_start = Q C_branches = master, develop, feature-*, release-*, hotfix-* C_sleep = 60 C_start = Q [vv-builder] U_enter = Q U_path = . U_command = make depends U_fail = UF B_enter = U B_path = . B_command = make install B_fail = BF T_enter = B T_path = . T_command = make test T_fail = TF C_enter = T C_path = . C_command = make check C_fail = CF C_exit = D
系列、环境和状态必须与您的存储库构建配置页面中定义的内容相匹配： http://SERVER.com/repos/REPO/build-setup
轮询器
运行您的存储库的轮询器的一个迭代
vv-poller <repository names>
或者，作为一个守护进程永久运行
vv-poller <repository names> --daemon
在副本内部，可以使用以下命令测试轮询器配置
vv-poller --test
构建器
运行您仓库的构建器的一次迭代
vv-builder <repository names> --env <environment alias>
或者，作为一个守护进程永久运行
vv-builder <repository names> --env <environment alias> --daemon
在工作副本中，可以使用以下命令测试构建器配置：
vv-builder --test
变更日志
0.0.11 (2014/01/26)
从模板更新了包。
0.0.10 (2013/11/19)
切换到Python 3。
0.0.9 (2013/09/19)
准备文件以移植到Python 3
0.0.8 (2013/08/24)
扩展vv-tracking接口以初始化仓库和删除构建。
现在在创建构建时总是推送。
0.0.7 (2013/08/01)
向vv-poller/builder添加了‘–no-config’参数以忽略本地配置。
实现了WorkingCopy.copy()方法。
现在总是推送新的构建请求和更新的构建状态。
0.0.6 (2013/07/23)
Repository.get_builds()现在按起始时间降序返回构建。
0.0.5 (2013/07/23)
保留setup.cfg选项中的大小写。
[vv-tracking] ‘virtualenv’现在是一个布尔值（环境名称：vv-builder-env）
现在限制Repository.get_builds()解析的构建请求为50个。
0.0.4 (2013/07/20)
从守护程序中删除了拉取/推送日志。
0.0.3 (2013/07/20)
守护程序现在仅在活动时显示日志输出。
在poller和builder中添加了更好的仓库同步。
0.0.2 (2013/07/19)
添加了[vv-tracking]设置以在虚拟环境中构建：virtualenv=
添加了[vv-poller]设置以允许重建：_rebuild = True
从示例构建配置中删除了非ETA状态（UP，BP，TP，CP）。
限制自动推送/拉取的频率为每30秒一次。
0.0.1 (2013/07/16)
python-veracity的初始版本。
python-veracity-0.0.11.tar.gz的散列
| 算法 | 散列摘要 | |
|---|---|---|
| SHA256 | 125e274f01937d29a8b505d7a7b4590d6a0045682ef02220cea4dbb1fcdcbfe8 |
|
| MD5 | a614877729e4f6e4b5d5913dd704282e |
|
| BLAKE2b-256 | 18e71031a5dde420566109759aca66a9f255c0b297135a59f158b7de47d585e5 |