rfctr: Blacken code base

Author: scanny

docs/conf.py

@@ -18,7 +18,7 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
+sys.path.insert(0, os.path.abspath(".."))
 
 from docx import __version__  # noqa
 
@@ -31,28 +31,28 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.intersphinx',
-    'sphinx.ext.todo',
-    'sphinx.ext.coverage',
-    'sphinx.ext.viewcode'
+    "sphinx.ext.autodoc",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.todo",
+    "sphinx.ext.coverage",
+    "sphinx.ext.viewcode",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ".rst"
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = "index"
 
 # General information about the project.
-project = u'python-docx'
-copyright = u'2013, Steve Canny'
+project = "python-docx"
+copyright = "2013, Steve Canny"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -193,7 +193,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['.build']
+exclude_patterns = [".build"]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
@@ -211,7 +211,7 @@
 # show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = "sphinx"
 
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
@@ -221,15 +221,15 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'armstrong'
+html_theme = "armstrong"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 # html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = ['_themes']
+html_theme_path = ["_themes"]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -250,7 +250,7 @@
 # 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"]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
@@ -263,8 +263,7 @@
 # Custom sidebar templates, maps document names to template names.
 # html_sidebars = {}
 html_sidebars = {
-    '**': ['localtoc.html', 'relations.html', 'sidebarlinks.html',
-           'searchbox.html']
+    "**": ["localtoc.html", "relations.html", "sidebarlinks.html", "searchbox.html"]
 }
 
 # Additional templates that should be rendered to pages, maps page names to
@@ -298,18 +297,16 @@
 # html_file_suffix = None
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'python-docxdoc'
+htmlhelp_basename = "python-docxdoc"
 
 
 # -- Options for LaTeX output -----------------------------------------------
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
     # 'papersize': 'letterpaper',
-
     # The font size ('10pt', '11pt' or '12pt').
     # 'pointsize': '10pt',
-
     # Additional stuff for the LaTeX preamble.
     # 'preamble': '',
 }
@@ -321,8 +318,7 @@
 #  author,
 #  documentclass [howto/manual]).
 latex_documents = [
-    ('index', 'python-docx.tex', u'python-docx Documentation',
-     u'Steve Canny', 'manual'),
+    ("index", "python-docx.tex", "python-docx Documentation", "Steve Canny", "manual"),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -350,10 +346,7 @@
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'python-docx', u'python-docx Documentation',
-     [u'Steve Canny'], 1)
-]
+man_pages = [("index", "python-docx", "python-docx Documentation", ["Steve Canny"], 1)]
 
 # If true, show URL addresses after external links.
 # man_show_urls = False
@@ -365,9 +358,15 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('index', 'python-docx', u'python-docx Documentation',
-     u'Steve Canny', 'python-docx', 'One line description of project.',
-     'Miscellaneous'),
+    (
+        "index",
+        "python-docx",
+        "python-docx Documentation",
+        "Steve Canny",
+        "python-docx",
+        "One line description of project.",
+        "Miscellaneous",
+    ),
 ]
 
 # Documents to append as an appendix to all manuals.
@@ -381,4 +380,4 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'http://docs.python.org/3/': None}
+intersphinx_mapping = {"http://docs.python.org/3/": None}

docx/api.py

@@ -34,4 +34,4 @@ def _default_docx_path():
     Return the path to the built-in default .docx package.
     """
     _thisdir = os.path.split(__file__)[0]
-    return os.path.join(_thisdir, 'templates', 'default.docx')
+    return os.path.join(_thisdir, "templates", "default.docx")

docx/blkcntnr.py

@@ -25,7 +25,7 @@ def __init__(self, element, parent):
         super(BlockItemContainer, self).__init__(parent)
         self._element = element
 
-    def add_paragraph(self, text='', style=None):
+    def add_paragraph(self, text="", style=None):
         """
         Return a paragraph newly added to the end of the content in this
         container, having *text* in a single run if present, and having
@@ -46,6 +46,7 @@ def add_table(self, rows, cols, width):
         distributed between the table columns.
         """
         from .table import Table
+
         tbl = CT_Tbl.new_tbl(rows, cols, width)
         self._element._insert_tbl(tbl)
         return Table(tbl, self)
@@ -65,6 +66,7 @@ def tables(self):
         Read-only.
         """
         from .table import Table
+
         return [Table(tbl, self) for tbl in self._element.tbl_lst]
 
     def _add_paragraph(self):

docx/compat.py

@@ -13,7 +13,6 @@
 # ===========================================================================
 
 if sys.version_info >= (3, 0):
-
     from collections.abc import Sequence
     from io import BytesIO
 
@@ -28,7 +27,6 @@ def is_string(obj):
 # ===========================================================================
 
 else:
-
     from collections import Sequence  # noqa
     from StringIO import StringIO as BytesIO  # noqa
 

docx/dml/color.py

@@ -4,9 +4,7 @@
 DrawingML objects related to color, ColorFormat being the most prominent.
 """
 
-from __future__ import (
-    absolute_import, division, print_function, unicode_literals
-)
+from __future__ import absolute_import, division, print_function, unicode_literals
 
 from ..enum.dml import MSO_COLOR_TYPE
 from ..oxml.simpletypes import ST_HexColorAuto

docx/document.py

@@ -18,7 +18,7 @@ class Document(ElementProxy):
     a document.
     """
 
-    __slots__ = ('_part', '__body')
+    __slots__ = ("_part", "__body")
 
     def __init__(self, element, part):
         super(Document, self).__init__(element)
@@ -44,7 +44,7 @@ def add_page_break(self):
         paragraph.add_run().add_break(WD_BREAK.PAGE)
         return paragraph
 
-    def add_paragraph(self, text='', style=None):
+    def add_paragraph(self, text="", style=None):
         """
         Return a paragraph newly added to the end of the document, populated
         with *text* and having paragraph style *style*. *text* can contain
@@ -172,9 +172,7 @@ def _block_width(self):
         space between the margins of the last section of this document.
         """
         section = self.sections[-1]
-        return Emu(
-            section.page_width - section.left_margin - section.right_margin
-        )
+        return Emu(section.page_width - section.left_margin - section.right_margin)
 
     @property
     def _body(self):
@@ -191,6 +189,7 @@ class _Body(BlockItemContainer):
     Proxy for ``<w:body>`` element in this document, having primarily a
     container role.
     """
+
     def __init__(self, body_elm, parent):
         super(_Body, self).__init__(body_elm, parent)
         self._body = body_elm

docx/enum/__init__.py

@@ -8,7 +8,6 @@
 
 
 class Enumeration(object):
-
     @classmethod
     def from_xml(cls, xml_val):
         return cls._xml_to_idx[xml_val]