feat: update black and format code to match Python 3.11

1.  Update required version of `black` in `pyproject.toml` and `.circleci/config.yml`.
2.  Update Python version identifiers in `tool.black` section of `pyproject.toml` to include `py311` and `py312`.
3.  Modify invocation of `black` in `commands.py` to format with `py311`.
4.  Regenerate and reformat code.

Author: gvwilson

.circleci/config.yml

@@ -129,7 +129,7 @@ jobs:
           command: |
             python -m venv venv
             . venv/bin/activate
-            pip install black==22.3.0
+            pip install black==25.1.0
       - run:
           name: Check formatting with black
           command: |

_plotly_utils/colors/__init__.py

@@ -73,6 +73,7 @@
 Be careful! If you have a lot of unique numbers in your color column you will
 end up with a colormap that is massive and may slow down graphing performance.
 """
+
 import decimal
 from numbers import Number
 

codegen/__init__.py

@@ -26,6 +26,10 @@
     get_data_validator_instance,
 )
 
+# Target Python version for code formatting with Black.
+# Must be one of the values listed in pyproject.toml.
+BLACK_TARGET_VERSION = "py311"
+
 
 # Import notes
 # ------------
@@ -326,9 +330,10 @@ def __getattr__(import_name):
 
     # ### Run black code formatter on output directories ###
     if reformat:
-        subprocess.call(["black", "--target-version=py36", validators_pkgdir])
-        subprocess.call(["black", "--target-version=py36", graph_objs_pkgdir])
-        subprocess.call(["black", "--target-version=py36", graph_objects_path])
+        target_version = f"--target-version={BLACK_TARGET_VERSION}"
+        subprocess.call(["black", target_version, validators_pkgdir])
+        subprocess.call(["black", target_version, graph_objs_pkgdir])
+        subprocess.call(["black", target_version, graph_objects_path])
     else:
         print("skipping reformatting")
 

commands.py

@@ -22,6 +22,7 @@
     ]
 )
 
+
 # Load plotly.js version from js/package.json
 def plotly_js_version():
     path = os.path.join(PROJECT_ROOT, "js", "package.json")

plotly/__init__.py

@@ -25,6 +25,7 @@
 - exceptions: defines our custom exception classes
 
 """
+
 import sys
 from typing import TYPE_CHECKING
 from _plotly_utils.importers import relative_import

plotly/basedatatypes.py

@@ -86,6 +86,7 @@ def _make_underscore_key(key):
             return key.replace("-", "_")
 
         key_path2b = list(map(_make_hyphen_key, key_path2))
+
         # Here we want to split up each non-empty string in the list at
         # underscores and recombine the strings using chomp_empty_strings so
         # that leading, trailing and multiple _ will be preserved
@@ -1611,6 +1612,7 @@ def _add_annotation_like(
                 )
             ):
                 return self
+
             # in case the user specified they wanted an axis to refer to the
             # domain of that axis and not the data, append ' domain' to the
             # computed axis accordingly

plotly/data/__init__.py

@@ -1,6 +1,7 @@
 """
 Built-in datasets for demonstration, educational and test purposes.
 """
+
 import os
 from importlib import import_module
 

plotly/express/_core.py

@@ -985,9 +985,11 @@ def make_trace_spec(args, constructor, attrs, trace_patch):
 
 def make_trendline_spec(args, constructor):
     trace_spec = TraceSpec(
-        constructor=go.Scattergl
-        if constructor == go.Scattergl  # could be contour
-        else go.Scatter,
+        constructor=(
+            go.Scattergl
+            if constructor == go.Scattergl  # could be contour
+            else go.Scatter
+        ),
         attrs=["trendline"],
         trace_patch=dict(mode="lines"),
         marginal=None,
@@ -2456,9 +2458,11 @@ def get_groups_and_orders(args, grouper):
         full_sorted_group_names = [
             tuple(
                 [
-                    ""
-                    if col == one_group
-                    else sub_group_names[required_grouper.index(col)]
+                    (
+                        ""
+                        if col == one_group
+                        else sub_group_names[required_grouper.index(col)]
+                    )
                     for col in grouper
                 ]
             )

plotly/express/data/__init__.py

@@ -1,5 +1,4 @@
-"""Built-in datasets for demonstration, educational and test purposes.
-"""
+"""Built-in datasets for demonstration, educational and test purposes."""
 
 from plotly.data import *
 

plotly/io/_templates.py

@@ -273,6 +273,7 @@ def _merge_2_templates(self, template1, template2):
 templates = TemplatesConfig()
 del TemplatesConfig
 
+
 # Template utilities
 # ------------------
 def walk_push_to_template(fig_obj, template_obj, skip):