numbers-parser 4.4.6__tar.gz → 4.4.8__tar.gz

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: numbers-parser
-Version: 4.4.6
+Version: 4.4.8
 Summary: Read and write Apple Numbers spreadsheets
 Home-page: https://github.com/masaccio/numbers-parser
 License: MIT
@@ -17,11 +17,12 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
 Requires-Dist: compact-json (>=1.1.3,<2.0.0)
-Requires-Dist: pendulum (>=2.1.2,<3.0.0)
+Requires-Dist: pendulum (>=3.0,<4.0)
 Requires-Dist: protobuf (>=4.21.1,<5.0.0)
 Requires-Dist: python-snappy (>=0.6.1,<0.7.0)
 Requires-Dist: regex (>=2022.9.13,<2023.0.0)
 Requires-Dist: roman (>=3.3,<4.0)
+Requires-Dist: setuptools (>=69.0.3,<70.0.0)
 Requires-Dist: sigfig (>=1.3.2,<2.0.0)
 Project-URL: Documentation, https://github.com/masaccio/numbers-parser/blob/main/README.md
 Project-URL: Repository, https://github.com/masaccio/numbers-parser
@@ -34,9 +35,9 @@ Description-Content-Type: text/markdown
 [![codecov](https://codecov.io/gh/masaccio/numbers-parser/branch/main/graph/badge.svg?token=EKIUFGT05E)](https://codecov.io/gh/masaccio/numbers-parser)
 [![PyPI version](https://badge.fury.io/py/numbers-parser.svg)](https://badge.fury.io/py/numbers-parser)
 
-`numbers-parser` is a Python module for parsing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files generated by Numbers version 10.3, and up with the latest tested version being 13.1 (current as of June 2023).
+`numbers-parser` is a Python module for parsing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files generated by Numbers version 10.3, and up with the latest tested version being 13.2 (current as of September 2023).
 
-It supports and is tested against Python versions from 3.8 onwards. It is not compatible with earlier versions of Python.
+It supports and is tested against Python versions from 3.8 onwards. It is not compatible with earlier versions of Python. Python 3.12 is not supported because of dependencies that do not currently work with 3.12. This is expected to be resolved by November 2023. 
 
 ## Installation
 
@@ -78,7 +79,7 @@ C:\Users\Jon>pip install C:\Users\Jon\Downloads\python_snappy-0.6.1-cp311-cp311-
 
 To better partition cell styles, background image data which was supported in earlier versions through the methods `image_data` and `image_filename` is now part of the new `cell_style` property. Using the deprecated methods `image_data` and `image_filename` will issue a `DeprecationWarning` if used.The legacy methods will be removed in a future version of numbers-parser.
 
-`NumberCell` cell values are now limited to 15 significant figures to match the implementation of floating point numbers in Apple Numbers. For example, the value `1234567890123456` is rounded to `1234567890123460` in the same was as in Numbers. Previously, using native `float` with no checking resulted in rounding errors in unpacking internal numbers. Attempting to write a number with too many significant digits results in a `RuntimeWarning`.
+`NumberCell` cell values are now limited to 15 significant figures to match the implementation of floating point numbers in Apple Numbers. For example, the value `1234567890123456` is rounded to `1234567890123460` in the same way as in Numbers. Previously, using native `float` with no checking resulted in rounding errors in unpacking internal numbers. Attempting to write a number with too many significant digits results in a `RuntimeWarning`.
 
 The previously deprecated methods `Document.sheets()` and `Sheet.tables()` are now only available using the properties of the same name (see examples in this README).
 
@@ -282,6 +283,8 @@ with open (cell.style.bg_image.filename, "wb") as f:
     f.write(cell.style.bg_image.data)
 ```
 
+Due to a limitation in Python's [ZipFile](https://docs.python.org/3/library/zipfile.html), Python versions older than 3.11 do not support image filenames with UTF-8 characters (see [issue 69](https://github.com/masaccio/numbers-parser/issues/69)). `cell.style.bg_image` returns `None` for such files and issues a `RuntimeWarning`.
+
 ### Borders
 
 `numbers-parser` supports reading and writing cell borders, though the interface for each differs. Individual cells can have each of their four borders tested, but when drawing new borders, these are set for the table to allow for drawing borders across multiple cells. Setting the border of merged cells is not possible unless the edge of the cells is at the end of the merged region.

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/README.md

@@ -5,9 +5,9 @@
 [![codecov](https://codecov.io/gh/masaccio/numbers-parser/branch/main/graph/badge.svg?token=EKIUFGT05E)](https://codecov.io/gh/masaccio/numbers-parser)
 [![PyPI version](https://badge.fury.io/py/numbers-parser.svg)](https://badge.fury.io/py/numbers-parser)
 
-`numbers-parser` is a Python module for parsing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files generated by Numbers version 10.3, and up with the latest tested version being 13.1 (current as of June 2023).
+`numbers-parser` is a Python module for parsing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files generated by Numbers version 10.3, and up with the latest tested version being 13.2 (current as of September 2023).
 
-It supports and is tested against Python versions from 3.8 onwards. It is not compatible with earlier versions of Python.
+It supports and is tested against Python versions from 3.8 onwards. It is not compatible with earlier versions of Python. Python 3.12 is not supported because of dependencies that do not currently work with 3.12. This is expected to be resolved by November 2023. 
 
 ## Installation
 
@@ -49,7 +49,7 @@ C:\Users\Jon>pip install C:\Users\Jon\Downloads\python_snappy-0.6.1-cp311-cp311-
 
 To better partition cell styles, background image data which was supported in earlier versions through the methods `image_data` and `image_filename` is now part of the new `cell_style` property. Using the deprecated methods `image_data` and `image_filename` will issue a `DeprecationWarning` if used.The legacy methods will be removed in a future version of numbers-parser.
 
-`NumberCell` cell values are now limited to 15 significant figures to match the implementation of floating point numbers in Apple Numbers. For example, the value `1234567890123456` is rounded to `1234567890123460` in the same was as in Numbers. Previously, using native `float` with no checking resulted in rounding errors in unpacking internal numbers. Attempting to write a number with too many significant digits results in a `RuntimeWarning`.
+`NumberCell` cell values are now limited to 15 significant figures to match the implementation of floating point numbers in Apple Numbers. For example, the value `1234567890123456` is rounded to `1234567890123460` in the same way as in Numbers. Previously, using native `float` with no checking resulted in rounding errors in unpacking internal numbers. Attempting to write a number with too many significant digits results in a `RuntimeWarning`.
 
 The previously deprecated methods `Document.sheets()` and `Sheet.tables()` are now only available using the properties of the same name (see examples in this README).
 
@@ -253,6 +253,8 @@ with open (cell.style.bg_image.filename, "wb") as f:
     f.write(cell.style.bg_image.data)
 ```
 
+Due to a limitation in Python's [ZipFile](https://docs.python.org/3/library/zipfile.html), Python versions older than 3.11 do not support image filenames with UTF-8 characters (see [issue 69](https://github.com/masaccio/numbers-parser/issues/69)). `cell.style.bg_image` returns `None` for such files and issues a `RuntimeWarning`.
+
 ### Borders
 
 `numbers-parser` supports reading and writing cell borders, though the interface for each differs. Individual cells can have each of their four borders tested, but when drawing new borders, these are set for the table to allow for drawing borders across multiple cells. Setting the border of merged cells is not possible unless the edge of the cells is at the end of the merged region.

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/pyproject.toml

@@ -12,7 +12,7 @@ name = "numbers-parser"
 packages = [{include = "numbers_parser", from = "src"}]
 readme = "README.md"
 repository = "https://github.com/masaccio/numbers-parser"
-version = "4.4.6"
+version = "4.4.8"
 
 [tool.poetry.scripts]
 cat-numbers = "numbers_parser._cat_numbers:main"
@@ -20,29 +20,31 @@ unpack-numbers = "numbers_parser._unpack_numbers:main"
 
 [tool.poetry.dependencies]
 compact-json = "^1.1.3"
-pendulum = "^2.1.2"
+pendulum = "^3.0"
 protobuf = "^4.21.1"
 python = "^3.8"
 python-snappy = "^0.6.1"
 regex = "^2022.9.13"
 roman = "^3.3"
 sigfig = "^1.3.2"
+setuptools = "^69.0.3"
 
 [tool.poetry.group.dev.dependencies]
 black = {version = "^22.10.0", allow-prereleases = true}
-pylama = {extras = ["toml"], version = "^8.4.1"}
+gprof2dot = "^2022.7.29"
+line-profiler = "^4.0.3"
+mock = "^5.1.0"
+psutil = "^5.9.5"
 pytest = "^7.2.0"
 pytest-check = "^1.0.10"
 pytest-console-scripts = "^1.3.1"
 pytest-cov = "^4.0.0"
 pytest-profiling = "^1.7.0"
-python-magic = "^0.4.27"
-termcolor = "^2.2.0"
-gprof2dot = "^2022.7.29"
-line-profiler = "^4.0.3"
-mock = "^5.1.0"
 pytest-xdist = "^3.3.1"
-psutil = "^5.9.5"
+ruff = "^0.0.292"
+termcolor = "^2.2.0"
+tox = "^4.11.4"
+python-magic = "^0.4.27"
 
 [build-system]
 build-backend = "poetry.core.masonry.api"
@@ -58,31 +60,68 @@ directory = "coverage_html_report"
 show_contexts = true
 
 [tool.pytest.ini_options]
-addopts = "--cov=src/numbers_parser --cov-report=term-missing:skip-covered --cov-context=test"
+addopts = "--cov=src/numbers_parser --cov-report=html --cov-report=term-missing:skip-covered --cov-context=test"
 
 [tool.tox]
 legacy_tox_ini = """
 [tox]
 isolated_build = true
-envlist = py38, py39, py310, py311
+envlist = py38, py39, py310, py311, py312
 [testenv]
-allowlist_externals = poetry
-commands_pre = poetry install --no-root --sync
-commands = poetry run -vvv pytest --import-mode importlib
+deps =
+  pytest
+  pytest-check
+  pytest-console-scripts
+  pytest-cov
+  pytest-xdist
+  python-magic
+  psutil
+commands =
+  pytest tests/ --import-mode importlib -n logical --no-cov
 """
 
-# linter settings
-[tool.pylama]
-linters = "pylint,mccabe,pyflakes"
-max_line_length = 100
-skip = ".bootstrap/*,.tox/*,src/numbers_parser/generated/*,src/debug/lldbutil.py"
+[tool.isort]
+profile = "black"
+
+[tool.ruff]
+exclude = [
+  # Machine-generated files
+  ".bootstrap/*",
+  "src/numbers_parser/generated/*",
+  # Third-party files not to lint
+  "src/debug/lldbutil.py", # Tox
+  ".tox/*",
+]
+fix = true
+ignore = [
+  "PLR2004", # Allow constant values
+]
+line-length = 100
+select = [
+  # Pyflakes including bugbears
+  "F",
+  "B", # Pycodestyle
+  "E",
+  "W", # isort
+  "I", # PEP naming
+  "N", # pyupgrade
+  "UP", # Pylama
+  "PL",
+]
+src = ["src", "tests"]
+target-version = "py38"
+unfixable = [
+  "ERA", # do not autoremove commented out code
+]
+
+[tool.ruff.pylint]
+max-statements = 100
+max-branches = 20
 
-[tool.pylama.linter.pycodestyle]
-format = "pylint"
-ignore = "E203,E231,W503"
+[tool.ruff.flake8-tidy-imports]
+ban-relative-imports = "all"
 
-[tool.pylama.linter.mccabe]
-max-complexity = 15
+[tool.ruff.per-file-ignores]
+"src/bootstrap/**" = ["PLR2004"]
 
-[tool.pylama.linter.pyflakes]
-builtins = "_"
+"tests/**" = ["PLR2004", "S101", "D103", "ANN201", "ANN001"]

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/src/numbers_parser/__init__.py

@@ -23,9 +23,9 @@ import os
 import plistlib
 import warnings
 
-from numbers_parser.document import Document  # NOQA
-from numbers_parser.cell import *  # NOQA
-from numbers_parser.exceptions import *  # NOQA
+from numbers_parser.cell import *
+from numbers_parser.document import Document
+from numbers_parser.exceptions import *
 
 __version__ = importlib.metadata.version("numbers-parser")
 
@@ -53,12 +53,14 @@ def _get_version():
 def _check_installed_numbers_version():
     try:
         fp = open(os.path.join(_DEFAULT_NUMBERS_INSTALL_PATH, _VERSION_PLIST_PATH), "rb")
-    except IOError:
+    except OSError:
         return None
     version_dict = plistlib.load(fp)
     installed_version = version_dict["CFBundleShortVersionString"]
     if installed_version not in _SUPPORTED_NUMBERS_VERSIONS:
-        warnings.warn(f"Numbers version {installed_version} not tested with this version")
+        warnings.warn(
+            f"Numbers version {installed_version} not tested with this version", stacklevel=2
+        )
     fp.close()
     return installed_version
 

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/src/numbers_parser/_cat_numbers.py

@@ -5,9 +5,8 @@ import sys
 
 import sigfig
 
-from numbers_parser import Document, ErrorCell, FileFormatError, NumberCell, FileError
+from numbers_parser import Document, ErrorCell, FileError, FileFormatError, NumberCell, _get_version
 from numbers_parser import __name__ as numbers_parser_name
-from numbers_parser import _get_version
 from numbers_parser.constants import MAX_SIGNIFICANT_DIGITS
 from numbers_parser.experimental import _enable_experimental_features
 

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/src/numbers_parser/_unpack_numbers.py

@@ -1,33 +1,31 @@
-import os
+import contextlib
 import json
 import logging
-import regex
+import os
 import sys
-
-from array import array
 from argparse import ArgumentParser
+from array import array
 from base64 import b64decode
 from binascii import hexlify
+
+import regex
 from compact_json import Formatter
 
-from numbers_parser.file import read_numbers_file
-from numbers_parser import _get_version
 from numbers_parser import __name__ as numbers_parser_name
+from numbers_parser import _get_version
+from numbers_parser.exceptions import FileError, FileFormatError, UnsupportedError
+from numbers_parser.file import read_numbers_file
 from numbers_parser.iwafile import IWAFile
-from numbers_parser.exceptions import FileFormatError, UnsupportedError, FileError
 from numbers_parser.numbers_uuid import NumbersUUID
 
-
 logger = logging.getLogger(numbers_parser_name)
 
 
 def ensure_directory_exists(prefix, path):
     """Ensure that a path's directory exists."""
     parts = os.path.split(path)
-    try:
+    with contextlib.suppress(OSError):
         os.makedirs(os.path.join(*([prefix] + list(parts[:-1]))))
-    except OSError:
-        pass
 
 
 def prettify_uuids(obj):
@@ -54,18 +52,18 @@ def prettify_uuids(obj):
 def prettify_cell_storage(obj):
     if isinstance(obj, dict):
         for k, v in obj.items():
-            if isinstance(v, dict) or isinstance(v, list):
+            if isinstance(v, (dict, list)):
                 prettify_cell_storage(v)
-            elif k == "cell_storage_buffer" or k == "cell_storage_buffer_pre_bnc":
+            elif k in ["cell_storage_buffer", "cell_storage_buffer_pre_bnc"]:
                 obj[k] = str(hexlify(b64decode(obj[k]), sep=":"))
                 obj[k] = obj[k].replace("b'", "").replace("'", "")
-            elif k == "cell_offsets" or k == "cell_offsets_pre_bnc":
+            elif k in ["cell_offsets", k == "cell_offsets_pre_bnc"]:
                 offsets = array("h", b64decode(obj[k])).tolist()
                 obj[k] = ",".join([str(x) for x in offsets])
                 obj[k] = regex.sub(r"(?:,-1)+$", ",[...]", obj[k])
     else:  # list
         for v in obj:
-            if isinstance(v, dict) or isinstance(v, list):
+            if isinstance(v, (dict, list)):
                 prettify_cell_storage(v)
 
 
@@ -137,7 +135,7 @@ def main():
             try:
                 read_numbers_file(
                     document,
-                    file_handler=lambda filename, blob: process_file(
+                    file_handler=lambda filename, blob, output_dir=output_dir: process_file(
                         filename, blob, output_dir, args
                     ),
                 )

{numbers_parser-4.4.6 → numbers_parser-4.4.8}/src/numbers_parser/cell.py

@@ -29,7 +29,7 @@ from numbers_parser.generated import TSTArchives_pb2 as TSTArchives
 from numbers_parser.generated.TSWPArchives_pb2 import (
     ParagraphStylePropertiesArchive as ParagraphStyle,
 )
-from numbers_parser.numbers_cache import cache, Cacheable
+from numbers_parser.numbers_cache import Cacheable, cache
 
 __all__ = [
     "Alignment",
@@ -122,8 +122,7 @@ class Alignment(_Alignment):
                 raise TypeError("invalid vertical alignment")
             vertical = VERTICAL_MAP[vertical]
 
-        self = super(_Alignment, cls).__new__(cls, (horizontal, vertical))
-        return self
+        return super(_Alignment, cls).__new__(cls, (horizontal, vertical))
 
 
 DEFAULT_ALIGNMENT_CLASS = Alignment(*DEFAULT_ALIGNMENT)
@@ -186,13 +185,11 @@ class Style:
 
     @classmethod
     def from_storage(cls, cell_storage: object, model: object):
-        style = Style()
-
         if cell_storage.image_data is not None:
             bg_image = BackgroundImage(*cell_storage.image_data)
         else:
             bg_image = None
-        style = Style(
+        return Style(
             alignment=model.cell_alignment(cell_storage),
             bg_image=bg_image,
             bg_color=model.cell_bg_color(cell_storage),
@@ -212,7 +209,6 @@ class Style:
             _text_style_obj_id=model.text_style_object_id(cell_storage),
             _cell_style_obj_id=model.cell_style_object_id(cell_storage),
         )
-        return style
 
     def __post_init__(self):
         self.bg_color = rgb_color(self.bg_color)
@@ -229,7 +225,8 @@ class Style:
 
     def __setattr__(self, name: str, value: Any) -> None:
         """Detect changes to cell styles and flag the style for
-        possible updates when saving the document"""
+        possible updates when saving the document.
+        """
         if name in ["bg_color", "font_color"]:
             value = rgb_color(value)
         if name == "alignment":
@@ -244,13 +241,13 @@ class Style:
 
 
 def rgb_color(color) -> RGB:
-    """Raise a TypeError if a color is not a valid RGB value"""
+    """Raise a TypeError if a color is not a valid RGB value."""
     if color is None:
         return None
     if isinstance(color, RGB):
         return color
     if isinstance(color, tuple):
-        if not (len(color) == 3 and all([isinstance(x, int) for x in color])):
+        if not (len(color) == 3 and all(isinstance(x, int) for x in color)):
             raise TypeError("RGB color must be an RGB or a tuple of 3 integers")
         return RGB(*color)
     elif isinstance(color, list):
@@ -259,13 +256,13 @@ def rgb_color(color) -> RGB:
 
 
 def alignment(value) -> Alignment:
-    """Raise a TypeError if a alignment is not a valid"""
+    """Raise a TypeError if a alignment is not a valid."""
     if value is None:
         return Alignment()
     if isinstance(value, Alignment):
         return value
     if isinstance(value, tuple):
-        if not (len(value) == 2 and all([isinstance(x, (int, str)) for x in value])):
+        if not (len(value) == 2 and all(isinstance(x, (int, str)) for x in value)):
             raise TypeError("Alignment must be an Alignment or a tuple of 2 integers/strings")
         return Alignment(*value)
     raise TypeError("Alignment must be an Alignment or a tuple of 2 integers/strings")
@@ -285,16 +282,20 @@ class Border:
     def __init__(
         self,
         width: float = DEFAULT_BORDER_WIDTH,
-        color: RGB = RGB(*DEFAULT_BORDER_COLOR),
-        style: BorderType = BorderType(BORDER_STYLE_MAP[DEFAULT_BORDER_STYLE]),
+        color: RGB = None,
+        style: BorderType = None,
         _order: int = 0,
     ):
         if not isinstance(width, float):
             raise TypeError("width must be a float number of points")
         self.width = width
 
+        if color is None:
+            color = RGB(*DEFAULT_BORDER_COLOR)
         self.color = rgb_color(color)
 
+        if style is None:
+            style = BorderType(BORDER_STYLE_MAP[DEFAULT_BORDER_STYLE])
         if isinstance(style, str):
             style = style.lower()
             if style not in BORDER_STYLE_MAP:
@@ -394,14 +395,14 @@ class CellBorder:
 
 
 class MergeReference:
-    """Cell reference for cells eliminated by a merge"""
+    """Cell reference for cells eliminated by a merge."""
 
     def __init__(self, row_start: int, col_start: int, row_end: int, col_end: int):
         self.rect = (row_start, col_start, row_end, col_end)
 
 
 class MergeAnchor:
-    """Cell reference for the merged cell"""
+    """Cell reference for the merged cell."""
 
     def __init__(self, size: Tuple):
         self.size = size
@@ -475,11 +476,12 @@ class Cell(Cacheable):
                 warn(
                     f"'{value}' rounded to {MAX_SIGNIFICANT_DIGITS} significant digits",
                     RuntimeWarning,
+                    stacklevel=2,
                 )
             return NumberCell(row_num, col_num, rounded_value)
-        elif isinstance(value, builtin_datetime) or isinstance(value, DateTime):
+        elif isinstance(value, (DateTime, builtin_datetime)):
             return DateCell(row_num, col_num, pendulum_instance(value))
-        elif isinstance(value, builtin_timedelta) or isinstance(value, Duration):
+        elif isinstance(value, (Duration, builtin_timedelta)):
             return DurationCell(row_num, col_num, value)
         else:
             raise ValueError("Can't determine cell type from type " + type(value).__name__)
@@ -527,6 +529,7 @@ class Cell(Cacheable):
             "image_filename is deprecated and will be removed in the future. "
             + "Please use the style property",
             DeprecationWarning,
+            stacklevel=2,
         )
         if self.style is not None and self.style.bg_image is not None:
             return self.style.bg_image.filename
@@ -539,6 +542,7 @@ class Cell(Cacheable):
             "image_data is deprecated and will be removed in the future. "
             + "Please use the style property",
             DeprecationWarning,
+            stacklevel=2,
         )
         if self.style is not None and self.style.bg_image is not None:
             return self.style.bg_image.data
@@ -555,8 +559,7 @@ class Cell(Cacheable):
     def formula(self):
         if self._formula_key is not None:
             table_formulas = self._model.table_formulas(self._table_id)
-            formula = table_formulas.formula(self._formula_key, self.row, self.col)
-            return formula
+            return table_formulas.formula(self._formula_key, self.row, self.col)
         else:
             return None
 
@@ -580,7 +583,11 @@ class Cell(Cacheable):
 
     @style.setter
     def style(self, _):
-        warn("cell style cannot be set; use Table.set_cell_style() instead", UnsupportedWarning)
+        warn(
+            "cell style cannot be set; use Table.set_cell_style() instead",
+            UnsupportedWarning,
+            stacklevel=2,
+        )
 
     @property
     def border(self):
@@ -592,6 +599,7 @@ class Cell(Cacheable):
         warn(
             "cell border values cannot be set; use Table.set_cell_border() instead",
             UnsupportedWarning,
+            stacklevel=2,
         )
 
 
@@ -718,8 +726,7 @@ range_parts = re.compile(r"(\$?)([A-Z]{1,3})(\$?)(\d+)")
 
 
 def xl_cell_to_rowcol(cell_str: str) -> tuple:
-    """
-    Convert a cell reference in A1 notation to a zero indexed row and column.
+    """Convert a cell reference in A1 notation to a zero indexed row and column.
     Args:
         cell_str:  A1 style string.
     Returns:
@@ -750,8 +757,7 @@ def xl_cell_to_rowcol(cell_str: str) -> tuple:
 
 
 def xl_range(first_row, first_col, last_row, last_col):
-    """
-    Convert zero indexed row and col cell references to a A1:B1 range string.
+    """Convert zero indexed row and col cell references to a A1:B1 range string.
     Args:
        first_row: The first cell row.    Int.
        first_col: The first cell column. Int.
@@ -770,8 +776,7 @@ def xl_range(first_row, first_col, last_row, last_col):
 
 
 def xl_rowcol_to_cell(row, col, row_abs=False, col_abs=False):
-    """
-    Convert a zero indexed row and column cell reference to a A1 style string.
+    """Convert a zero indexed row and column cell reference to a A1 style string.
     Args:
        row:     The cell row.    Int.
        col:     The cell column. Int.
@@ -795,8 +800,7 @@ def xl_rowcol_to_cell(row, col, row_abs=False, col_abs=False):
 
 
 def xl_col_to_name(col, col_abs=False):
-    """
-    Convert a zero indexed column cell reference to a string.
+    """Convert a zero indexed column cell reference to a string.
     Args:
        col:     The cell column. Int.
        col_abs: Optional flag to make the column absolute. Bool.