{ "info": { "author": "Jakub Ruzicka", "author_email": "jruzicka@redhat.com", "bugtrack_url": null, "classifiers": [ "Environment :: OpenStack", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "# distroinfo\n\n`distroinfo` is a python module for parsing, validating and querying\ndistribution/packaging metadata stored in human readable and reviewable\ntext/YAML files.\n\nThis is a proper generic (re)implementation of\n[rdoinfo](https://github.com/redhat-openstack/rdoinfo) parser which proved\nwell suited for the task of interfacing with distribution metadata in a human\nfriendly way. If you consider code reviews human friendly, that is.\n\n`distroinfo` is a part of\n[Software Factory project](https://softwarefactory-project.io/docs/)\n\n\n## STATUS\n\n`distroinfo` is available from Fedora/EPEL repos and is **BEING INTEGRATED**.\n\n[rdopkg](https://github.com/softwarefactory-project/rdopkg) and\n[DLRN](https://github.com/softwarefactory-project/DLRN) are first adopters.\n\n`rdoinfo` compatibility is ensured through offline and online tests.\n\nCI is enabled.\n\nSee [distroinfo reviews](https://softwarefactory-project.io/dashboard/project_distroinfo).\n\nUse github\n[Issues](https://github.com/softwarefactory-project/distroinfo/issues)\nto make requests and report bugs.\n\nPoke `jruzicka` on `#softwarefactory` or `#rdo` Freenode IRC for more\ninformation.\n\n\n## Installation\n\n\n### from source\n\nIf you want to hack `distroinfo` or just have the latest code without waiting\nfor next release, you can use the git repo directly:\n\n git clone https://github.com/softwarefactory-project/distroinfo\n cd distroinfo\n python setup.py develop --user\n\nYou may set the preference over `distroinfo` RPM by correctly positioning\n`~/.local/bin/distroinfo` in your `$PATH`.\n\nOr you can use virtualenv to avoid conflicts with RPM:\n\n git clone https://github.com/softwarefactory-project/distroinfo\n cd distroinfo\n virtualenv --system-site-packages ~/distroinfo-venv\n source ~/distroinfo-venv/bin/activate\n python setup.py develop\n ln `which distroinfo` ~/bin/distroinfo-dev\n\n distroinfo-dev --version\n\nRequired python modules are listed in\n[requirements.txt](requirements.txt).\n\n\n### from Fedora/EPEL repos (default)\n\n`distroinfo` is available on **Fedora 27** and newer:\n\n dnf install python2-distroinfo\n\nincluding Python 3 version:\n\n dnf install python3-distroinfo\n\nOn CentOS/RHEL 7, `distroinfo` is available from\n[EPEL](https://fedoraproject.org/wiki/EPEL).\n\nOn **CentOS 7**:\n\n yum install epel-release\n yum install python2-distroinfo\n\nOn **RHEL 7**:\n\n yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm\n yum install python2-distroinfo\n\n\n### from PyPI\n\nFor your convenience, `distroinfo` is available from the Cheese Shop:\n\n pip install distroinfo\n\n\n## Usage\n\nYou can **fetch info files from an URL** by specifying `remote_info` base URL:\n\n from distroinfo.info import DistroInfo\n\n RDOINFO_RAW_URL = \\\n 'https://raw.githubusercontent.com/redhat-openstack/rdoinfo/master/'\n\n di = DistroInfo('rdo-full.yml',\n remote_info=RDOINFO_RAW_URL)\n info = di.get_info()\n\nOr you can **fetch info files from a remote git repository** using\n`remote_git_info`:\n\n from distroinfo.info import DistroInfo\n\n RDOINFO_GIT_URL = \\\n 'https://github.com/redhat-openstack/rdoinfo'\n\n di = DistroInfo('rdo-full.yml',\n remote_git_info=RDOINFO_GIT_URL)\n info = di.get_info()\n\nOr you can **fetch info files from a local directory** using\n`local_info`:\n\n from distroinfo.info import DistroInfo\n\n INFO_PATH = '/path/to/info'\n\n di = DistroInfo('rdo-full.yml',\n local_info=INFO_PATH)\n info = di.get_info()\n\nFor remote fetchers info files/repos are cached in `~/.distroinfo/cache`.\n\nYou can navigate info structure yourself or use `query` module:\n\n from distroinfo import query\n\n # get a package info by strict package name\n nova = query.get_package(info, 'openstack-nova')\n\n # find a package by human reference (smart search)\n keystone = query.find_package(info, 'keystone')\n\nAlternatively, you can get info with `packages` and `releases` as dictionaries\nindexed by project/release name for easier access using `info_dicts=True`:\n\n info = di.get_info(info_dicts=True)\n nova = info['packages']['nova']\n\nUntil proper documentation is in place, please refer to:\n\n* [rdoinfo](https://github.com/redhat-openstack/rdoinfo) for prime example of\n `distroinfo` format usage\n* [rdoinfo integration tests](https://github.com/softwarefactory-project/distroinfo/blob/master/tests/integration/test_rdoinfo_online.py)\n for code examples\n* [dlrn.drivers.rdoinfo](https://github.com/softwarefactory-project/DLRN/blob/master/dlrn/drivers/rdoinfo.py)\n for a real world code that uses tags and `remote_git_info`/`local_info`\n* [distroinfo.info](https://github.com/softwarefactory-project/distroinfo/blob/master/distroinfo/info.py)\n to RTFS\n\n\n## Command Line Interface\n\nA simple CLI is provided in `scripts/di.py` which can be used to test basic\n`distroinfo` functionality, profile, dump parsed data, etc.\n\nAn example of dumping parsed rdoinfo into both YAML and JSON files:\n\n $> ./scripts/di.py dump -y rdoinfo.yaml -j rdoinfo.json -f git \\\n 'https://github.com/redhat-openstack/rdoinfo' rdo-full.yml\n\n Dumping YAML to: rdoinfo.yaml\n Dumping JSON to: rdoinfo.json\n\nAdditional `docopt` module is required to run the CLI.\n\n\n## Bugs\n\nPlease use the\n[github Issues](https://github.com/softwarefactory-project/distroinfo/issues)\nto report bugs.\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/softwarefactory-project/distroinfo", "keywords": "", "license": "Apache Software License", "maintainer": "", "maintainer_email": "", "name": "distroinfo", "package_url": "https://pypi.org/project/distroinfo/", "platform": "", "project_url": "https://pypi.org/project/distroinfo/", "project_urls": { "Homepage": "https://github.com/softwarefactory-project/distroinfo" }, "release_url": "https://pypi.org/project/distroinfo/0.3.0/", "requires_dist": [ "PyYAML", "pbr (>=0.5.6)", "requests", "six" ], "requires_python": "", "summary": "python module for parsing, validating and querying distribution/packaging metadata stored in human readable and reviewable text/YAML files", "version": "0.3.0" }, "last_serial": 5666566, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "e7ba4982c0668762f7f5c4cebf22db40", "sha256": "d9943a20a28e79b9f268533c3bb85de03d0c18d7f3b72bed1f001ddc1a6e322d" }, "downloads": -1, "filename": "distroinfo-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "e7ba4982c0668762f7f5c4cebf22db40", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 13157, "upload_time": "2018-05-03T17:45:13", "url": "https://files.pythonhosted.org/packages/cf/6b/0768c4c2736fe8bfa497469a9bc5e54a761b54d29ead7c0c2c88e750055f/distroinfo-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bcd51ec0552ada78158857998348dacd", "sha256": "c6919c327e86bca736b93e09b73d73e2c2ff77419ce6a817a1fe16826403e0d3" }, "downloads": -1, "filename": "distroinfo-0.0.1.tar.gz", "has_sig": false, "md5_digest": "bcd51ec0552ada78158857998348dacd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65442, "upload_time": "2018-05-03T17:45:14", "url": "https://files.pythonhosted.org/packages/30/25/012cc8aca76786770037cc55879332463a3df3133949a73288d4a489a779/distroinfo-0.0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "fdc1162f48f73ca5c876d02d7fd31751", "sha256": "fdb795339806c4b96ff4d454db0359485a77a57a137b7df15ecb3f82628ffa85" }, "downloads": -1, "filename": "distroinfo-0.1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "fdc1162f48f73ca5c876d02d7fd31751", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 15568, "upload_time": "2018-08-14T16:50:21", "url": "https://files.pythonhosted.org/packages/c8/4e/ac00a2fb52ed9f475b866d690b7c339ecf026029af060f6b08d72341669f/distroinfo-0.1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "576672645709304ae990ecac3388b584", "sha256": "a60f4a645b4deb9c62821d6305adcb9975c36deb3a7f8b446231a89a018cbe90" }, "downloads": -1, "filename": "distroinfo-0.1.1.tar.gz", "has_sig": false, "md5_digest": "576672645709304ae990ecac3388b584", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 70171, "upload_time": "2018-08-14T16:50:23", "url": "https://files.pythonhosted.org/packages/6d/06/7d354fb2aa7e649b031d9eacc44910dc5017ffa071a0a2fd364a57f93c7e/distroinfo-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "fcfd004af029fb6abe67ba941455c05d", "sha256": "c835abd2417baa40254bb77a3b6b36404cbfce63739d777c0303bc3a20bb49df" }, "downloads": -1, "filename": "distroinfo-0.2.0-py2-none-any.whl", "has_sig": false, "md5_digest": "fcfd004af029fb6abe67ba941455c05d", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 15608, "upload_time": "2019-01-30T12:58:56", "url": "https://files.pythonhosted.org/packages/15/25/e26b3074681cc598eef080cd72258a1bfb5161457b6e29f7c827c103e1ff/distroinfo-0.2.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bceb759877352aeaab75dfd2366c35af", "sha256": "505ee294f872e42fd73cbe31ee554e3312cca77e29079bbffeba6a46f1a6dcbc" }, "downloads": -1, "filename": "distroinfo-0.2.0.tar.gz", "has_sig": false, "md5_digest": "bceb759877352aeaab75dfd2366c35af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 70633, "upload_time": "2019-01-30T12:58:59", "url": "https://files.pythonhosted.org/packages/f3/90/718d389cc0b0ad262e252d003ec9d4d57a312bf4a0cfa5ee9d283e37ecaf/distroinfo-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "701187480c66e08b186910fd6652ff0b", "sha256": "f93bb710050c4d98bafff626d04bb986fc8f597a1aa4bd0c97c4b7b5d832fd2f" }, "downloads": -1, "filename": "distroinfo-0.3.0-py2-none-any.whl", "has_sig": false, "md5_digest": "701187480c66e08b186910fd6652ff0b", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 16067, "upload_time": "2019-02-25T13:44:06", "url": "https://files.pythonhosted.org/packages/9d/e5/fc6e302552e7cf4abb9623f9599d1530e5094627c72bec1a4594faf67105/distroinfo-0.3.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2c346c8a620256002bd93169828e38cd", "sha256": "dfd8764fa756cf75d95b0e5b76938573c718c0e85462cdfbc7f6d1cb50b0a61d" }, "downloads": -1, "filename": "distroinfo-0.3.0.tar.gz", "has_sig": false, "md5_digest": "2c346c8a620256002bd93169828e38cd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72542, "upload_time": "2019-02-25T13:44:09", "url": "https://files.pythonhosted.org/packages/e4/9c/2f706436d0de300c99593a2feb63fd8c1b191ad007de6e999d59af60aa96/distroinfo-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "701187480c66e08b186910fd6652ff0b", "sha256": "f93bb710050c4d98bafff626d04bb986fc8f597a1aa4bd0c97c4b7b5d832fd2f" }, "downloads": -1, "filename": "distroinfo-0.3.0-py2-none-any.whl", "has_sig": false, "md5_digest": "701187480c66e08b186910fd6652ff0b", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 16067, "upload_time": "2019-02-25T13:44:06", "url": "https://files.pythonhosted.org/packages/9d/e5/fc6e302552e7cf4abb9623f9599d1530e5094627c72bec1a4594faf67105/distroinfo-0.3.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2c346c8a620256002bd93169828e38cd", "sha256": "dfd8764fa756cf75d95b0e5b76938573c718c0e85462cdfbc7f6d1cb50b0a61d" }, "downloads": -1, "filename": "distroinfo-0.3.0.tar.gz", "has_sig": false, "md5_digest": "2c346c8a620256002bd93169828e38cd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72542, "upload_time": "2019-02-25T13:44:09", "url": "https://files.pythonhosted.org/packages/e4/9c/2f706436d0de300c99593a2feb63fd8c1b191ad007de6e999d59af60aa96/distroinfo-0.3.0.tar.gz" } ] }