distroinfo 0.0.1

python module for parsing, validating and querying distribution/packaging metadata stored in human readable and reviewable text/YAML files

# distroinfo

distroinfo is a python module for parsing, validating and querying distribution/packaging metadata stored in human readable and reviewable text/YAML files.

This is a proper generic (re)implementation of [rdoinfo](https://github.com/redhat-openstack/rdoinfo) parser which proved well suited for the task of interfacing with distribution metadata in a human friendly way. If you consider code reviews human friendly, that is.

distroinfo is a part of [Software Factory project](https://softwarefactory-project.io/docs/)

## STATUS

distroinfo is READY FOR ALPHA TESTING IN THE WILD

rdoinfo compatibility is ensured through offline and online tests.

CI is ready to be enabled.

More features, documentation, and packaging are on the way.

See [distroinfo reviews](https://softwarefactory-project.io/dashboard/project_distroinfo).

Use github [Issues](https://github.com/softwarefactory-project/distroinfo/issues) to make requests and report bugs.

Poke jruzicka on #softwarefactory or #rdo Freenode IRC for more information.

## Installation

### from source

If you want to hack ditroinfo or just have the latest code without waiting for next release, you can use the git repo directly:

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

You may set the preference over distroinfo RPM by correctly positioning ~/.local/bin/distroinfo in your $PATH.

Or you can use virtualenv to avoid conflicts with RPM:

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

Required python modules are listed in [requirements.txt](requirements.txt).

### from Fedora/EPEL repos (default)

TODO: distroinfo is going to hit Fedora/EPEL repos as soon as it’s ready.

### from PyPI

TODO:

For your convenience, distroinfo is also GOING TO BE available from the Cheese Shop as soon as ready.

# TODO: NOT YET pip install distroinfo

## Bugs

Please use the [github Issues](https://github.com/softwarefactory-project/distroinfo/issues) to report bugs.