Support dynamic documentation versioning using pbr

- Add a version.py file to allow querying of the pbr version for the package
which is pulled from the git tags
- Use this when doing the sphinx docs generation

Change-Id: Ic892b131c9be2cc65a2b468c9cdb2ff23d1d8743

ceilometer_powervm/version.py

@@ -0,0 +1,17 @@
+#    Copyright 2015 IBM Corp.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+import pbr.version
+
+version_info = pbr.version.VersionInfo('__project__')

doc/source/conf.py

@@ -53,10 +53,11 @@ copyright = u'2015, IBM'
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
+import ceilometer_powervm.version
 # The short X.Y version.
-version = '0.1.0'
+version = ceilometer_powervm.version.version_info.version_string()
 # The full version, including alpha/beta/rc tags.
-release = '0.1.0'
+release = ceilometer_powervm.version.version_info.release_string()
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.