Add support for RuntimeConfig API.

Supports listing and getting variables, but not the other methods, since
I didn't need those, yet.

Author: tswast

runtimeconfig/.coveragerc

@@ -0,0 +1,11 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__

runtimeconfig/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.rst
+graft google
+graft unit_tests
+global-exclude *.pyc

runtimeconfig/README.rst

@@ -0,0 +1,44 @@
+Python Client for Google Cloud RuntimeConfig
+============================================
+
+    Python idiomatic client for `Google Cloud RuntimeConfig`_
+
+.. _Google Cloud RuntimeConfig: https://cloud.google.com/deployment-manager/runtime-configurator/
+
+-  `API Documentation`_
+
+.. _API Documentation: http://googlecloudplatform.github.io/google-cloud-python/
+
+Quick Start
+-----------
+
+::
+
+    $ pip install --upgrade google-cloud-runtimeconfig
+
+Authentication
+--------------
+
+With ``google-cloud-python`` we try to make authentication as painless as
+possible. Check out the `Authentication section`_ in our documentation to
+learn more. You may also find the `authentication document`_ shared by all
+the ``google-cloud-*`` libraries to be helpful.
+
+.. _Authentication section: http://google-cloud-python.readthedocs.io/en/latest/google-cloud-auth.html
+.. _authentication document: https://github.com/GoogleCloudPlatform/gcloud-common/tree/master/authentication
+
+Using the API
+-------------
+
+The Google Cloud `RuntimeConfig`_ (`RuntimeConfig API docs`_) API enables
+developers to dynamically configure and expose variables through Google Cloud
+Platform. In addition, you can also set Watchers and Waiters that will watch
+for changes to your data and return based on certain conditions.
+
+.. _RuntimeConfig: https://cloud.google.com/deployment-manager/runtime-configurator/
+.. _RuntimeConfig API docs: https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/
+
+See the ``google-cloud-python`` API `RuntimeConfig documentation`_ to learn
+how to analyze images using this library.
+
+.. _Vision documentation: https://google-cloud-python.readthedocs.io/en/stable/runtimeconfig-usage.html

runtimeconfig/google/__init__.py

@@ -0,0 +1,20 @@
+# Copyright 2016 Google Inc.
+#
+# 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.
+
+try:
+    import pkg_resources
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+    __path__ = pkgutil.extend_path(__path__, __name__)

runtimeconfig/google/cloud/__init__.py

@@ -0,0 +1,20 @@
+# Copyright 2016 Google Inc.
+#
+# 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.
+
+try:
+    import pkg_resources
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+    __path__ = pkgutil.extend_path(__path__, __name__)

runtimeconfig/google/cloud/runtimeconfig/__init__.py

@@ -0,0 +1,17 @@
+# Copyright 2016 Google Inc.
+#
+# 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.
+
+"""Google Cloud Runtime Configurator API package."""
+
+from google.cloud.runtimeconfig.client import Client

runtimeconfig/google/cloud/runtimeconfig/_helpers.py

@@ -0,0 +1,67 @@
+# Copyright 2016 Google Inc.
+#
+# 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.
+
+"""Shared helper functions for RuntimeConfig API classes."""
+
+
+def config_name_from_full_name(full_name):
+    """Extract the config name from a full resource name.
+
+      >>> config_name_from_full_name('projects/my-proj/configs/my-config')
+      "my-config"
+
+    :type full_name: string
+    :param full_name: the full resource name of a config. The full resource
+                      name looks like
+                      ``projects/project-name/configs/config-name`` and is
+                      returned as the ``name`` field of a config resource.
+                      See:
+                      https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs
+
+    :rtype: string
+    :returns: the config's short name, given its full resource name
+    """
+    _, _, _, result = full_name.split('/')
+    return result
+
+
+def variable_name_from_full_name(full_name):
+    """Extract the variable name from a full resource name.
+
+      >>> variable_name_from_full_name(
+              'projects/my-proj/configs/my-config/variables/var-name')
+      "var-name"
+      >>> variable_name_from_full_name(
+              'projects/my-proj/configs/my-config/variables/another/var/name')
+      "another/var/name"
+
+    :type full_name: string
+    :param full_name: the full resource name of a variable. The full resource
+                      name looks like
+                      ``projects/prj-name/configs/cfg-name/variables/var-name``
+                      and is returned as the ``name`` field of a variable
+                      resource.  See:
+                      https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables
+
+    :rtype: string
+    :returns: the variable's short name, given its full resource name
+    """
+    parts = full_name.split('/')
+    assert parts[0] == 'projects'
+    assert parts[2] == 'configs'
+    assert parts[4] == 'variables'
+
+    # Variables are hierarchical. Each node in the hierarchy is separated by a
+    # / character.
+    return '/'.join(parts[5:])

runtimeconfig/google/cloud/runtimeconfig/client.py

@@ -0,0 +1,59 @@
+# Copyright 2016 Google Inc.
+#
+# 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.
+
+"""Client for interacting with the Google Cloud RuntimeConfig API."""
+
+
+from google.cloud.client import JSONClient
+from google.cloud.runtimeconfig.connection import Connection
+from google.cloud.runtimeconfig.config import Config
+
+
+class Client(JSONClient):
+    """Client to bundle configuration needed for API requests.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of.
+                    If not passed, falls back to the default inferred
+                    from the environment.
+
+    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
+                       :class:`NoneType`
+    :param credentials: The OAuth2 Credentials to use for the connection
+                        owned by this client. If not passed (and if no ``http``
+                        object is passed), falls back to the default inferred
+                        from the environment.
+
+    :type http: :class:`httplib2.Http` or class that defines ``request()``.
+    :param http: An optional HTTP object to make requests. If not passed, an
+                 ``http`` object is created that is bound to the
+                 ``credentials`` for the current object.
+    """
+
+    _connection_class = Connection
+
+    def config(self, config_name):
+        """Factory constructor for config object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a config object owned by this client.
+
+        :type config_name: string
+        :param config_name: The name of the config to be instantiated.
+
+        :rtype: :class:`google.cloud.runtimeconfig.config.Config`
+        :returns: The config object created.
+        """
+        return Config(client=self, name=config_name)