distroinfo 0.6.2

状态

distroinfo可以从Fedora/EPEL仓库获取，并且正在被集成。

rdopkg 和 DLRN 是首批采用者。

通过离线和在线测试确保了 rdoinfo 兼容性。

已启用 CI。

请参阅 distroinfo reviews。

请使用 github Issues 提出请求和报告错误。

安装

git clone https://github.com/softwarefactory-project/distroinfo
cd distroinfo
python setup.py develop --user

git clone https://github.com/softwarefactory-project/distroinfo
cd distroinfo
virtualenv --system-site-packages ~/distroinfo-venv
source ~/distroinfo-venv/bin/activate
python setup.py develop
ln `which distroinfo` ~/bin/distroinfo-dev

distroinfo-dev --version

dnf install python2-distroinfo

dnf install python3-distroinfo

yum install epel-release
yum install python2-distroinfo

yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum install python2-distroinfo

pip install distroinfo

使用方法

您可以通过指定 remote_info 基础 URL 来从 URL 获取信息文件

from distroinfo.info import DistroInfo

RDOINFO_RAW_URL = \
    'https://raw.githubusercontent.com/redhat-openstack/rdoinfo/master/'

di = DistroInfo('rdo-full.yml',
                remote_info=RDOINFO_RAW_URL)
info = di.get_info()

或者您可以使用 remote_git_info 从远程 git 仓库获取信息文件

from distroinfo.info import DistroInfo

RDOINFO_GIT_URL = \
    'https://github.com/redhat-openstack/rdoinfo'

di = DistroInfo('rdo-full.yml',
                remote_git_info=RDOINFO_GIT_URL)
info = di.get_info()

或者您可以使用 local_info 从本地目录获取信息文件

from distroinfo.info import DistroInfo

INFO_PATH = '/path/to/info'

di = DistroInfo('rdo-full.yml',
                local_info=INFO_PATH)
info = di.get_info()

对于远程获取器，信息文件/仓库被缓存于 ~/.distroinfo/cache。

您可以选择自行导航信息结构或使用 query 模块

from distroinfo import query

# get a package info by strict package name
nova = query.get_package(info, 'openstack-nova')

# find a package by human reference (smart search)
keystone = query.find_package(info, 'keystone')

或者，您可以使用 info_dicts=True 以项目/发布名称为索引的字典形式获取信息，以便于访问

info = di.get_info(info_dicts=True)
nova = info['packages']['nova']

您还可以根据给定标准过滤匹配的软件包。以下查询将显示所有匹配 conf: client AND tags: antelope 的软件包。

::

# rexen 是应用过滤器的字典。 # pkg 是当前处理的软件包。 info = di.get_info() pkgs = info[‘packages’] rexen = {“conf”: “client”, “tags”: “antelope”}

finding = query.filter_pkgs(pkgs, rexen)

您还可以使用带有“~”字符的负过滤，它可以与其他过滤器结合，如 conf: client。

::

info = di.get_info() pkgs = info[‘packages’] rexen = {“tags”: “~newton”, “conf”: “client”} finding = query.filter_pkgs(pkgs, rexen)

使用此功能时，输出将包含不带 newton 标记但包含 conf:client 的软件包。

在适当文档到位之前，请参阅

• rdoinfo 以了解 distroinfo 格式使用的示例

• rdoinfo integration tests 以获取代码示例

• dlrn.drivers.rdoinfo 以获取使用标签和 remote_git_info/local_info 的真实世界代码

• distroinfo.info 以 RTFS

命令行界面

在 scripts/di.py 中提供了一个简单的 CLI，可用于测试基本 distroinfo 功能、性能分析、转储解析数据等。

将解析的 rdoinfo 转储到 YAML 和 JSON 文件的示例

$> ./scripts/di.py dump -y rdoinfo.yaml -j rdoinfo.json -f git \
       'https://github.com/redhat-openstack/rdoinfo' rdo-full.yml

Dumping YAML to: rdoinfo.yaml
Dumping JSON to: rdoinfo.json

运行 CLI 需要额外的 docopt 模块。

错误

请使用 github Issues 报告错误。