googleapis · crwilcox · Nov 30, 2018 · Nov 30, 2018
diff --git a/dns/noxfile.py b/dns/noxfile.py
@@ -25,6 +25,45 @@
 )
 
 
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
 def default(session):
     """Default unit test session.
 
@@ -60,27 +99,6 @@ def unit(session):
     default(session)
 
 
-@nox.session(python='3.6')
-def lint(session):
-    """Run linters.
-
-    Returns a failure if the linters find linting errors or sufficiently
-    serious code quality issues.
-    """
-    session.install('flake8', *LOCAL_DEPS)
-    session.install('.')
-    session.run('flake8', 'google', 'tests')
-
-
-@nox.session(python='3.6')
-def lint_setup_py(session):
-    """Verify that setup.py is valid (including RST check)."""
-
-    session.install('docutils', 'Pygments')
-    session.run(
-        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
-
-
 @nox.session(python='3.6')
 def cover(session):
     """Run the final coverage report.

diff --git a/resource_manager/google/__init__.py b/resource_manager/google/__init__.py
@@ -14,7 +14,9 @@
 
 try:
     import pkg_resources
+
     pkg_resources.declare_namespace(__name__)
 except ImportError:
     import pkgutil
+
     __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/resource_manager/google/cloud/__init__.py b/resource_manager/google/cloud/__init__.py
@@ -14,7 +14,9 @@
 
 try:
     import pkg_resources
+
     pkg_resources.declare_namespace(__name__)
 except ImportError:
     import pkgutil
+
     __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/resource_manager/google/cloud/resource_manager/__init__.py b/resource_manager/google/cloud/resource_manager/__init__.py
@@ -16,12 +16,13 @@
 
 
 from pkg_resources import get_distribution
-__version__ = get_distribution('google-cloud-resource-manager').version
+
+__version__ = get_distribution("google-cloud-resource-manager").version
 
 from google.cloud.resource_manager.client import Client
 from google.cloud.resource_manager.project import Project
 
 
 SCOPE = Client.SCOPE
 
-__all__ = ['__version__', 'Client', 'Project', 'SCOPE']
+__all__ = ["__version__", "Client", "Project", "SCOPE"]
diff --git a/resource_manager/google/cloud/resource_manager/_http.py b/resource_manager/google/cloud/resource_manager/_http.py
@@ -30,15 +30,13 @@ class Connection(_http.JSONConnection):
     :param client: The client that owns the current connection.
     """
 
-    API_BASE_URL = 'https://cloudresourcemanager.googleapis.com'
+    API_BASE_URL = "https://cloudresourcemanager.googleapis.com"
     """The base of the API call URL."""
 
-    API_VERSION = 'v1beta1'
+    API_VERSION = "v1beta1"
     """The version of the API, used in building the API call's URL."""
 
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
+    API_URL_TEMPLATE = "{api_base_url}/{api_version}{path}"
     """A template for the URL of a particular API call."""
 
-    _EXTRA_HEADERS = {
-        _http.CLIENT_INFO_HEADER: _CLIENT_INFO,
-    }
+    _EXTRA_HEADERS = {_http.CLIENT_INFO_HEADER: _CLIENT_INFO}
diff --git a/resource_manager/google/cloud/resource_manager/client.py b/resource_manager/google/cloud/resource_manager/client.py
@@ -51,12 +51,11 @@ class Client(BaseClient):
                   change in the future.
     """
 
-    SCOPE = ('https://www.googleapis.com/auth/cloud-platform',)
+    SCOPE = ("https://www.googleapis.com/auth/cloud-platform",)
     """The scopes required for authenticating as a Resouce Manager consumer."""
 
     def __init__(self, credentials=None, _http=None):
-        super(Client, self).__init__(
-            credentials=credentials, _http=_http)
+        super(Client, self).__init__(credentials=credentials, _http=_http)
         self._connection = Connection(self)
 
     def new_project(self, project_id, name=None, labels=None):
@@ -85,8 +84,7 @@ def new_project(self, project_id, name=None, labels=None):
                   :class:`~google.cloud.resource_manager.project.Project`
                   **without** any metadata loaded.
         """
-        return Project(project_id=project_id,
-                       client=self, name=name, labels=labels)
+        return Project(project_id=project_id, client=self, name=name, labels=labels)
 
     def fetch_project(self, project_id):
         """Fetch an existing project and it's relevant metadata by ID.
@@ -160,21 +158,22 @@ def list_projects(self, filter_params=None, page_size=None):
         extra_params = {}
 
         if page_size is not None:
-            extra_params['pageSize'] = page_size
+            extra_params["pageSize"] = page_size
 
         if filter_params is not None:
-            extra_params['filter'] = [
-                '{}:{}'.format(key, value)
+            extra_params["filter"] = [
+                "{}:{}".format(key, value)
                 for key, value in six.iteritems(filter_params)
             ]
 
         return page_iterator.HTTPIterator(
             client=self,
             api_request=self._connection.api_request,
-            path='/projects',
+            path="/projects",
             item_to_value=_item_to_project,
-            items_key='projects',
-            extra_params=extra_params)
+            items_key="projects",
+            extra_params=extra_params,
+        )
 
 
 def _item_to_project(iterator, resource):

diff --git a/resource_manager/google/cloud/resource_manager/project.py b/resource_manager/google/cloud/resource_manager/project.py
@@ -51,6 +51,7 @@ class Project(object):
     :type labels: dict
     :param labels: A list of labels associated with the project.
     """
+
     def __init__(self, project_id, client, name=None, labels=None):
         self._client = client
         self.project_id = project_id
@@ -61,7 +62,7 @@ def __init__(self, project_id, client, name=None, labels=None):
         self.parent = None
 
     def __repr__(self):
-        return '<Project: %r (%r)>' % (self.name, self.project_id)
+        return "<Project: %r (%r)>" % (self.name, self.project_id)
 
     @classmethod
     def from_api_repr(cls, resource, client):
@@ -76,30 +77,30 @@ def from_api_repr(cls, resource, client):
         :rtype: :class:`google.cloud.resource_manager.project.Project`
         :returns: The project created.
         """
-        project = cls(project_id=resource['projectId'], client=client)
+        project = cls(project_id=resource["projectId"], client=client)
         project.set_properties_from_api_repr(resource)
         return project
 
     def set_properties_from_api_repr(self, resource):
         """Update specific properties from its API representation."""
-        self.name = resource.get('name')
-        self.number = resource['projectNumber']
-        self.labels = resource.get('labels', {})
-        self.status = resource['lifecycleState']
-        if 'parent' in resource:
-            self.parent = resource['parent']
+        self.name = resource.get("name")
+        self.number = resource["projectNumber"]
+        self.labels = resource.get("labels", {})
+        self.status = resource["lifecycleState"]
+        if "parent" in resource:
+            self.parent = resource["parent"]
 
     @property
     def full_name(self):
         """Fully-qualified name (ie, ``'projects/purple-spaceship-123'``)."""
         if not self.project_id:
-            raise ValueError('Missing project ID.')
-        return 'projects/%s' % (self.project_id)
+            raise ValueError("Missing project ID.")
+        return "projects/%s" % (self.project_id)
 
     @property
     def path(self):
         """URL for the project (ie, ``'/projects/purple-spaceship-123'``)."""
-        return '/%s' % (self.full_name)
+        return "/%s" % (self.full_name)
 
     def _require_client(self, client):
         """Check client or verify over-ride.
@@ -129,13 +130,10 @@ def create(self, client=None):
         """
         client = self._require_client(client)
 
-        data = {
-            'projectId': self.project_id,
-            'name': self.name,
-            'labels': self.labels,
-        }
-        resp = client._connection.api_request(method='POST', path='/projects',
-                                              data=data)
+        data = {"projectId": self.project_id, "name": self.name, "labels": self.labels}
+        resp = client._connection.api_request(
+            method="POST", path="/projects", data=data
+        )
         self.set_properties_from_api_repr(resource=resp)
 
     def reload(self, client=None):
@@ -164,7 +162,7 @@ def reload(self, client=None):
 
         # We assume the project exists. If it doesn't it will raise a NotFound
         # exception.
-        resp = client._connection.api_request(method='GET', path=self.path)
+        resp = client._connection.api_request(method="GET", path=self.path)
         self.set_properties_from_api_repr(resource=resp)
 
     def exists(self, client=None):
@@ -186,7 +184,7 @@ def exists(self, client=None):
         try:
             # Note that we have to request the entire resource as the API
             # doesn't provide a way tocheck for existence only.
-            client._connection.api_request(method='GET', path=self.path)
+            client._connection.api_request(method="GET", path=self.path)
         except NotFound:
             return False
         else:
@@ -205,14 +203,9 @@ def update(self, client=None):
         """
         client = self._require_client(client)
 
-        data = {
-            'name': self.name,
-            'labels': self.labels,
-            'parent': self.parent,
-        }
+        data = {"name": self.name, "labels": self.labels, "parent": self.parent}
 
-        resp = client._connection.api_request(
-            method='PUT', path=self.path, data=data)
+        resp = client._connection.api_request(method="PUT", path=self.path, data=data)
         self.set_properties_from_api_repr(resp)
 
     def delete(self, client=None, reload_data=False):
@@ -240,7 +233,7 @@ def delete(self, client=None, reload_data=False):
                             Default: :data:`False`.
         """
         client = self._require_client(client)
-        client._connection.api_request(method='DELETE', path=self.path)
+        client._connection.api_request(method="DELETE", path=self.path)
 
         # If the reload flag is set, reload the project.
         if reload_data:
@@ -270,8 +263,7 @@ def undelete(self, client=None, reload_data=False):
                             Default: :data:`False`.
         """
         client = self._require_client(client)
-        client._connection.api_request(
-            method='POST', path=self.path + ':undelete')
+        client._connection.api_request(method="POST", path=self.path + ":undelete")
 
         # If the reload flag is set, reload the project.
         if reload_data:

diff --git a/resource_manager/noxfile.py b/resource_manager/noxfile.py
@@ -25,6 +25,45 @@
 )
 
 
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
 def default(session):
     """Default unit test session.
 
@@ -58,27 +97,6 @@ def unit(session):
     default(session)
 
 
-@nox.session(python='3.6')
-def lint(session):
-    """Run linters.
-
-    Returns a failure if the linters find linting errors or sufficiently
-    serious code quality issues.
-    """
-    session.install('flake8', *LOCAL_DEPS)
-    session.install('.')
-    session.run('flake8', 'google', 'tests')
-
-
-@nox.session(python='3.6')
-def lint_setup_py(session):
-    """Verify that setup.py is valid (including RST check)."""
-
-    session.install('docutils', 'Pygments')
-    session.run(
-        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
-
-
 @nox.session(python='3.6')
 def cover(session):
     """Run the final coverage report.