chore: automatically format code using isort and black

Author: parthea

noxfile.py

@@ -16,6 +16,10 @@
 import nox
 import shutil
 
+BLACK_VERSION = "black==22.3.0"
+ISORT_VERSION = "isort==5.10.1"
+BLACK_PATHS = ["apiclient", "scripts", "tests", "describe.py", "owlbot.py", "noxfile.py", "setup.py"]
+
 test_dependencies = [
     "django>=2.0.0",
     "google-auth",
@@ -44,6 +48,24 @@ def lint(session):
         "--statistics",
     )
 
+@nox.session(python="3.8")
+def format(session):
+    """
+    Run isort to sort imports. Then run black
+    to format code to uniform standard.
+    """
+    session.install(BLACK_VERSION, ISORT_VERSION)
+    # Use the --fss option to sort imports using strict alphabetical order.
+    # See https://pycqa.github.io/isort/docs/configuration/options.html#force-sort-within-sections
+    session.run(
+        "isort",
+        "--fss",
+        *BLACK_PATHS,
+    )
+    session.run(
+        "black",
+        *BLACK_PATHS,
+    )
 
 @nox.session(python=["3.6", "3.7", "3.8", "3.9", "3.10"])
 @nox.parametrize(

owlbot.py

@@ -14,7 +14,7 @@
 
 import synthtool as s
 from synthtool import gcp
-
+from pathlib import Path
 from synthtool.languages import python
 
 common = gcp.CommonTemplates()
@@ -43,3 +43,7 @@
 # ----------------------------------------------------------------------------
 
 python.py_samples(skip_readmes=True)
+
+for noxfile in Path(".").glob("**/noxfile.py"):
+    s.shell.run(["nox", "-s", "format"], cwd=noxfile.parent, hide_output=False)
+