MNT: apply black again

Author: tacaswell

docs/source/conf.py

@@ -18,12 +18,13 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
 import os
+
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
 from pathlib import Path
 
 # are we running circle CI?
-CIRCLECI = 'CIRCLECI' in os.environ
+CIRCLECI = "CIRCLECI" in os.environ
 
 # -- General configuration ------------------------------------------------
 
@@ -35,18 +36,18 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.autosummary',
-    'sphinx.ext.githubpages',
-    'sphinx.ext.intersphinx',
-    'sphinx.ext.mathjax',
-    'sphinx.ext.viewcode',
-    'IPython.sphinxext.ipython_directive',
-    'IPython.sphinxext.ipython_console_highlighting',
-    'matplotlib.sphinxext.plot_directive',
-    'numpydoc',
-    'sphinx_copybutton',
-    'sphinx_gallery.gen_gallery',
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.githubpages",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.mathjax",
+    "sphinx.ext.viewcode",
+    "IPython.sphinxext.ipython_directive",
+    "IPython.sphinxext.ipython_console_highlighting",
+    "matplotlib.sphinxext.plot_directive",
+    "numpydoc",
+    "sphinx_copybutton",
+    "sphinx_gallery.gen_gallery",
 ]
 
 # Configuration options for plot_directive. See:
@@ -63,8 +64,8 @@
 
 # Sphinx gallery configuration
 
-def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
-                                     **kwargs):
+
+def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf, **kwargs):
     """
     Reduce srcset when creating a PDF.
 
@@ -73,56 +74,59 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
     """
     from sphinx_gallery.scrapers import matplotlib_scraper
 
-    if gallery_conf['builder_name'] == 'latex':
-        gallery_conf['image_srcset'] = []
+    if gallery_conf["builder_name"] == "latex":
+        gallery_conf["image_srcset"] = []
     return matplotlib_scraper(block, block_vars, gallery_conf, **kwargs)
 
 
 sphinx_gallery_conf = {
-    'examples_dirs': ['../../examples', ],
-    'filename_pattern': '^((?!sgskip).)*$',
-    'gallery_dirs': ['gallery'],
-    'doc_module': ('data_prototype',),
-    'reference_url': {
-        'matplotlib': None,
+    "examples_dirs": [
+        "../../examples",
+    ],
+    "filename_pattern": "^((?!sgskip).)*$",
+    "gallery_dirs": ["gallery"],
+    "doc_module": ("data_prototype",),
+    "reference_url": {
+        "matplotlib": None,
     },
-    'backreferences_dir': Path('api') / Path('_as_gen'),
-    'remove_config_comments': True,
-    'min_reported_time': 1,
-    'thumbnail_size': (320, 224),
-    'image_scrapers': (matplotlib_reduced_latex_scraper, ),
+    "backreferences_dir": Path("api") / Path("_as_gen"),
+    "remove_config_comments": True,
+    "min_reported_time": 1,
+    "thumbnail_size": (320, 224),
+    "image_scrapers": (matplotlib_reduced_latex_scraper,),
     # Compression is a significant effort that we skip for local and CI builds.
-    'compress_images': ('thumbnails', 'images') if is_release_build else (),
-    'matplotlib_animations': True,
-    'image_srcset': ["2x"],
-    'junit': '../test-results/sphinx-gallery/junit.xml' if CIRCLECI else '',
+    "compress_images": ("thumbnails", "images") if is_release_build else (),
+    "matplotlib_animations": True,
+    "image_srcset": ["2x"],
+    "junit": "../test-results/sphinx-gallery/junit.xml" if CIRCLECI else "",
 }
 
 mathmpl_fontsize = 11.0
-mathmpl_srcset = ['2x']
+mathmpl_srcset = ["2x"]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_suffix = ".rst"
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = "index"
 
 # General information about the project.
-project = 'data_prototype'
-copyright = '2022, Thomas A Caswell'
-author = 'Thomas A Caswell'
+project = "data_prototype"
+copyright = "2022, Thomas A Caswell"
+author = "Thomas A Caswell"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 import data_prototype
+
 # The short X.Y version.
 version = data_prototype.__version__
 # The full version, including alpha/beta/rc tags.
@@ -141,7 +145,7 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
 exclude_patterns = []
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = "sphinx"
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = False
@@ -160,32 +164,30 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
 # documentation.
 #
 
-html_theme_options = {
-    "logo": {}
-}
+html_theme_options = {"logo": {}}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = ["_static"]
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.
 #
 # This is required for the alabaster theme
 # refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
 html_sidebars = {
-    '**': [
-        'relations.html',  # needs 'show_related': True theme option to display
-        'searchbox.html',
+    "**": [
+        "relations.html",  # needs 'show_related': True theme option to display
+        "searchbox.html",
     ]
 }
 
 
 # -- Options for HTMLHelp output ------------------------------------------
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'data_prototype'
+htmlhelp_basename = "data_prototype"
 
 
 # -- Options for LaTeX output ---------------------------------------------
@@ -194,15 +196,12 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
     # The paper size ('letterpaper' or 'a4paper').
     #
     # 'papersize': 'letterpaper',
-
     # The font size ('10pt', '11pt' or '12pt').
     #
     # 'pointsize': '10pt',
-
     # Additional stuff for the LaTeX preamble.
     #
     # 'preamble': '',
-
     # Latex figure (float) alignment
     #
     # 'figure_align': 'htbp',
@@ -212,19 +211,15 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, 'data_prototype.tex', 'data_prototype Documentation',
-     'Contributors', 'manual'),
+    (master_doc, "data_prototype.tex", "data_prototype Documentation", "Contributors", "manual"),
 ]
 
 
 # -- Options for manual page output ---------------------------------------
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'data_prototype', 'data_prototype Documentation',
-     [author], 1)
-]
+man_pages = [(master_doc, "data_prototype", "data_prototype Documentation", [author], 1)]
 
 
 # -- Options for Texinfo output -------------------------------------------
@@ -233,19 +228,23 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    (master_doc, 'data_prototype', 'data_prototype Documentation',
-     author, 'data_prototype', 'Experimental code for the upcoming Matplotlib data refactor.',
-     'Miscellaneous'),
+    (
+        master_doc,
+        "data_prototype",
+        "data_prototype Documentation",
+        author,
+        "data_prototype",
+        "Experimental code for the upcoming Matplotlib data refactor.",
+        "Miscellaneous",
+    ),
 ]
 
 
-
-
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    'python': ('https://docs.python.org/3/', None),
-    'numpy': ('https://numpy.org/doc/stable/', None),
-    'scipy': ('https://docs.scipy.org/doc/scipy/reference/', None),
-    'pandas': ('https://pandas.pydata.org/pandas-docs/stable', None),
-    'matplotlib': ('https://matplotlib.org/stable', None),
+    "python": ("https://docs.python.org/3/", None),
+    "numpy": ("https://numpy.org/doc/stable/", None),
+    "scipy": ("https://docs.scipy.org/doc/scipy/reference/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable", None),
+    "matplotlib": ("https://matplotlib.org/stable", None),
 }

examples/first.py

@@ -13,7 +13,7 @@
 from data_prototype.wrappers import LineWrapper
 from data_prototype.containers import FuncContainer, SeriesContainer
 
-fc = FuncContainer({"x": (("N", ), lambda x: x), "y": (("N", ), np.sin)})
+fc = FuncContainer({"x": (("N",), lambda x: x), "y": (("N",), np.sin)})
 lw = LineWrapper(fc, lw=5, color="green", label="sin (function)")
 
 th = np.linspace(0, 2 * np.pi, 16)

setup.py

@@ -18,31 +18,32 @@
 Upgrade pip like so:
 
 pip install --upgrade pip
-""".format(*(sys.version_info[:2] + min_version))
+""".format(
+        *(sys.version_info[:2] + min_version)
+    )
     sys.exit(error)
 
 here = path.abspath(path.dirname(__file__))
 
-with open(path.join(here, 'README.rst'), encoding='utf-8') as readme_file:
+with open(path.join(here, "README.rst"), encoding="utf-8") as readme_file:
     readme = readme_file.read()
 
-with open(path.join(here, 'requirements.txt')) as requirements_file:
+with open(path.join(here, "requirements.txt")) as requirements_file:
     # Parse requirements.txt, ignoring any commented-out lines.
-    requirements = [line for line in requirements_file.read().splitlines()
-                    if not line.startswith('#')]
+    requirements = [line for line in requirements_file.read().splitlines() if not line.startswith("#")]
 
 
 setup(
-    name='data_prototype',
+    name="data_prototype",
     description="Experimental code for the upcoming Matplotlib data refactor.",
     long_description=readme,
     author="Thomas A Caswell",
-    author_email='tcaswell@gmail.com',
-    url='https://github.com/tacaswell/data_prototype',
-    python_requires='>={}'.format('.'.join(str(n) for n in min_version)),
-    packages=find_packages(exclude=['docs', 'tests']),
+    author_email="tcaswell@gmail.com",
+    url="https://github.com/tacaswell/data_prototype",
+    python_requires=">={}".format(".".join(str(n) for n in min_version)),
+    packages=find_packages(exclude=["docs", "tests"]),
     entry_points={
-        'console_scripts': [
+        "console_scripts": [
             # 'command = some.module:some_function',
         ],
     },
@@ -59,7 +60,7 @@
     },
     include_package_data=True,
     package_data={
-        'data_prototype': [
+        "data_prototype": [
             # When adding files here, remember to update MANIFEST.in as well,
             # or else they will not be included in the distribution on PyPI!
             # 'path/to/data_file',
@@ -68,8 +69,8 @@
     install_requires=requirements,
     license="BSD (3-clause)",
     classifiers=[
-        'Development Status :: 2 - Pre-Alpha',
-        'Natural Language :: English',
-        'Programming Language :: Python :: 3',
+        "Development Status :: 2 - Pre-Alpha",
+        "Natural Language :: English",
+        "Programming Language :: Python :: 3",
     ],
 )