Lint picking.

Author: tseaver

gcloud/pubsub/client.py

@@ -12,6 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+"""Convenience proxies
+
+Define wrappers for ``api`` functions, :class:`gcloud.pubsub.topic.Topic`, and
+:class:`gcloud.pubsub.subscription.Subscription`, passing the memoized
+connection / project as needed.
+"""
+
 from gcloud._helpers import get_default_project
 from gcloud._helpers import _ClientProxy
 from gcloud.pubsub._implicit_environ import _require_connection
@@ -88,6 +95,10 @@ class _Topic(_ClientProxy):
     """Proxy for :class:`gcloud.pubsub.topic.Topic`.
     """
     def subscription(self, name, ack_deadline=None, push_endpoint=None):
+        """ Proxy through to :class:`gcloud.pubsub.subscription.Subscription`.
+
+        :rtype: :class:`_Subscription`
+        """
         subscription = Subscription(
             name,
             self._wrapped,