Add sample for standard library logging handler configuration

logging/cloud-client/README.rst

@@ -63,6 +63,18 @@ To run this sample:
     $ python quickstart.py
 
 
+Handler
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python handler.py
+
+
 Snippets
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 

logging/cloud-client/handler.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python
+
+# Copyright 2016 Google Inc. All Rights Reserved.
+#
+# 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.
+
+
+def use_logging_handler():
+    # [START logging_handler_setup]
+    # Imports the Google Cloud client library
+    import google.cloud.logging
+
+    # Instantiates a client
+    client = google.cloud.logging.Client()
+
+    # Connects the logger to the root logging handler; by default this captures
+    # all logs at INFO level and higher
+    client.setup_logging()
+    # [END logging_handler_setup]
+
+    # [START logging_handler_usage]
+    # Imports Python standard library logging
+    import logging
+
+    # The data to log
+    text = 'Hello, world!'
+
+    # Emits the data using the standard logging module
+    logging.warn(text)
+    # [END logging_handler_usage]
+
+    print('Logged: {}'.format(text))
+
+
+if __name__ == '__main__':
+    use_logging_handler()

logging/cloud-client/handler_test.py

@@ -0,0 +1,22 @@
+# Copyright 2016 Google Inc. All Rights Reserved.
+#
+# 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 handler
+
+
+def test_handler(capsys):
+    handler.use_logging_handler()
+    out, _ = capsys.readouterr()
+    assert 'Logged' in out