API: new method KiwiTCMS.version()

requires the user to be logged in and will return the string version of
Kiwi TCMS.

Primarily useful for informational purposes. We're also going to use
this method in some of our performance evaluations because it doesn't
touch the DB and essentially returns a static value!

docs/source/modules/tcms.rpc.api.kiwitcms.rst

@@ -0,0 +1,7 @@
+tcms.rpc.api.kiwitcms module
+============================
+
+.. automodule:: tcms.rpc.api.kiwitcms
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/source/modules/tcms.rpc.api.rst

@@ -27,6 +27,7 @@ Submodules
    tcms.rpc.api.category
    tcms.rpc.api.classification
    tcms.rpc.api.component
+   tcms.rpc.api.kiwitcms
    tcms.rpc.api.markdown
    tcms.rpc.api.plantype
    tcms.rpc.api.priority

tcms/rpc/api/kiwitcms.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+
+from modernrpc.auth.basic import http_basic_auth_login_required
+from modernrpc.core import rpc_method
+
+from tcms import __version__
+
+__all__ = ("version",)
+
+
+@http_basic_auth_login_required
+@rpc_method(name="KiwiTCMS.version")
+def version():
+    """
+    .. function:: RPC KiwiTCMS.version()
+
+        :return: Current version of Kiwi TCMS installation.
+        :rtype: string
+    """
+    return __version__

tcms/settings/common.py

@@ -383,6 +383,7 @@
     "tcms.rpc.api.classification",
     "tcms.rpc.api.component",
     "tcms.rpc.api.markdown",
+    "tcms.rpc.api.kiwitcms",
     "tcms.rpc.api.plantype",
     "tcms.rpc.api.priority",
     "tcms.rpc.api.product",