`CFME::Versions`

Command line utility and library for viewing versions across ManageIQ, CloudForms Management Engine (CFME), CloudForms, and IBM CloudPak for Multicloud Management (CP4MCM)

ManageIQ		CFME	CloudForms	CP4MCM	Ruby	Rails	PostgreSQL
		5.1.z	2.0
		5.2.z	3.0
Anand	1.y.z	5.3.z	3.1
Botvinnik	2.y.z	5.4.z	3.2
Capablanca	3.y.z	5.5.z	4.0		2.2.z	4.2.z	9.4.z
Darga	4.y.z	5.6.z	4.1		2.2.z	5.0.z	9.4.z
Euwe	5.y.z	5.7.z	4.2		2.3.z	5.0.z	9.5.z
Fine	6.y.z	5.8.z	4.5		2.3.z	5.0.z	9.5.z
Gaprindashvili	7.y.z	5.9.z	4.6		2.3.z	5.0.z	9.5.z
Hammer	8.y.z	5.10.z	4.7		2.4.z	5.0.z	9.5.z
Ivanchuk	9.y.z	5.11.z	5.0	1.2,1.3	2.5.z	5.1.z	10.y
Jansa	10.y.z			2.0	2.5.z	5.2.z	10.y
Kasparov	11.y.z				2.6.z	5.2.z	10.y

Requirements

A ruby runtime

Installation

via `bundler`

Add the following to your Gemfile:

gem 'cfme-versions'

via `rubygems`

$ gem install cfme-versions

Versioning

Ideally we will keep the version of this gem in-sync with the version of the most recent numeric version of ManageIQ. However, in the case of bug fixes, patch versions might be included.

In the cases where a patch is needed, just update the CFME::Versions.version to set the version directly. When a new version is released, reset the end of the string to + ".0.0" for consistency.

Note: Previously the CFME version number was used to version this gem, but since that is reaching EOL the decision was made to use the upstream miq_semver variable instead as that project will continue forward. This also means the gem release "jumped" from 5.12 to 11.0.0, but that is intentional since 5.11 is the last CFME release.

Usage

CLI

$ cfme-versions

There is a --help flag available for a few (minor) options.

As a library

The CFME::Versions gem is also available as a Enumerable lib, so you can do things like the following:

require 'cfme-versions'

CFME::Versions.first.cfme_release
#=> "5.1.z"
CFME::Versions.first.cloud_forms_release
#=> "2.0"
CFME::Versions.last.miq_release
#=> "Jansa"
CFME::Versions.last.ruby
#=> "2.5.z"
CFME::Versions.last
#=> #<struct CFME::Version
#       miq_release="Jansa",
#       cfme_release="5.12.z",
#       cloud_forms_release="5.1",
#       cp4mcm_release="2.0",
#       ruby="2.5.z",
#       rails="5.2.z",
#       postgresql="10.y">

Contributing

Bug reports and pull requests are welcome on GitHub.

If you wish to add a version to the list, make sure to run the tests and fix any errors as a result (designed to fail when things change).

You can use rake to run the specs as you would expect.

License

This project is available as open source under the Apache License 2.0.

chessbyte/cfme-versions

CFME::Versions