pyexcel 0.7.2__tar.gz → 0.7.3__tar.gz

{pyexcel-0.7.2 → pyexcel-0.7.3}/CHANGELOG.rst

@@ -1,6 +1,16 @@
 Change log
 ================================================================================
 
+0.7.3 - 12.04.2025
+--------------------------------------------------------------------------------
+
+**Fixed**
+
+#. `#263 <https://github.com/pyexcel/pyexcel/issues/263>`_: support pathlib from
+   python 3.4
+#. `#267 <https://github.com/pyexcel/pyexcel/issues/267>`_: better error message
+   for file_name
+
 0.7.2 - 23.03.2025
 --------------------------------------------------------------------------------
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pyexcel
-Version: 0.7.2
+Version: 0.7.3
 Summary: A wrapper library that provides one API to read, manipulate and writedata in different excel formats
 Home-page: https://github.com/pyexcel/pyexcel
-Download-URL: https://github.com/pyexcel/pyexcel/archive/0.7.2.tar.gz
+Download-URL: https://github.com/pyexcel/pyexcel/archive/0.7.3.tar.gz
 Author: C.W.
 Author-email: info@pyexcel.org
 License: New BSD
@@ -1244,6 +1244,16 @@ In alphabetical order:
 Change log
 ================================================================================
 
+0.7.3 - 12.04.2025
+--------------------------------------------------------------------------------
+
+**Fixed**
+
+#. `#263 <https://github.com/pyexcel/pyexcel/issues/263>`_: support pathlib from
+   python 3.4
+#. `#267 <https://github.com/pyexcel/pyexcel/issues/267>`_: better error message
+   for file_name
+
 0.7.2 - 23.03.2025
 --------------------------------------------------------------------------------
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/docs/source/conf.py

@@ -26,9 +26,9 @@ project = 'pyexcel'
 copyright = '2014-2025 Onni Software Ltd.'
 author = 'C.W.'
 # The short X.Y version
-version = '0.7.2'
+version = '0.7.3'
 # The full version, including alpha/beta/rc tags
-release = '0.7.2'
+release = '0.7.3'
 
 # -- General configuration ---------------------------------------------------
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/__init__.py

@@ -1,14 +1,15 @@
 """
-    pyexcel
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel
+~~~~~~~~~~~~~~~~~~~
 
-    **pyexcel** is a wrapper library to read, manipulate and
-    write data in different excel formats: csv, ods, xls, xlsx
-    and xlsm. It does not support formulas, styles and charts.
+**pyexcel** is a wrapper library to read, manipulate and
+write data in different excel formats: csv, ods, xls, xlsx
+and xlsm. It does not support formulas, styles and charts.
 
-    :copyright: (c) 2014-2025 by Onni Software Ltd.
-    :license: New BSD License, see LICENSE for more details
+:copyright: (c) 2014-2025 by Onni Software Ltd.
+:license: New BSD License, see LICENSE for more details
 """
+
 from .book import Book
 from .core import (
     save_as,
@@ -23,15 +24,16 @@ from .core import (
     iget_records,
     save_book_as,
     get_book_dict,
-    isave_book_as
+    isave_book_as,
 )
 from .sheet import Sheet
+
 # flake8: noqa
 from .cookbook import (
     split_a_book,
     merge_all_to_a_book,
     merge_csv_to_a_book,
-    extract_a_sheet_from_a_book
+    extract_a_sheet_from_a_book,
 )
 from .deprecated import (
     Reader,
@@ -43,7 +45,7 @@ from .deprecated import (
     load_from_dict,
     load_from_memory,
     load_from_records,
-    load_book_from_memory
+    load_book_from_memory,
 )
 from .__version__ import __author__, __version__
 from .internal.garbagecollector import free_resources

pyexcel-0.7.3/pyexcel/__version__.py

@@ -0,0 +1,2 @@
+__version__ = '0.7.3'
+__author__ = 'C.W.'

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/_compact.py

@@ -1,12 +1,13 @@
 """
-    pyexcel._compact
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel._compact
+~~~~~~~~~~~~~~~~~~~
 
-    Compatibles
+Compatibles
 
-    :copyright: (c) 2014-2025 by Onni Software Ltd.
-    :license: New BSD License, see LICENSE for more details
+:copyright: (c) 2014-2025 by Onni Software Ltd.
+:license: New BSD License, see LICENSE for more details
 """
+
 # flake8: noqa
 # pylint: disable=unused-import
 # pylint: disable=import-error
@@ -18,9 +19,9 @@ import sys
 import warnings
 from io import BytesIO, StringIO
 from urllib import request
+from pathlib import Path
 from textwrap import dedent
 from itertools import zip_longest
-
 from collections import OrderedDict
 
 PY2 = sys.version_info[0] == 2
@@ -72,3 +73,9 @@ def append_doc(value):
         return func
 
     return _doc
+
+
+def get_string_file_name(file_name):
+    if isinstance(file_name, Path):
+        file_name = str(file_name.resolve())
+    return file_name

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/book.py

@@ -1,16 +1,17 @@
 """
-    pyexcel.book
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.book
+~~~~~~~~~~~~~~~~~~~
 
-    Excel book
+Excel book
 
-    :copyright: (c) 2014-2025 by Onni Software Ltd.
-    :license: New BSD License, see LICENSE for more details
+:copyright: (c) 2014-2025 by Onni Software Ltd.
+:license: New BSD License, see LICENSE for more details
 """
+
 from pyexcel.sheet import Sheet
+from pyexcel._compact import OrderedDict
 from pyexcel.internal.meta import BookMeta
 from pyexcel.internal.common import SheetIterator
-from pyexcel._compact import OrderedDict
 
 LOCAL_UUID = 0
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/constants.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.constants
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.constants
+~~~~~~~~~~~~~~~~~~~
 
-    Constants appeared in pyexcel
+Constants appeared in pyexcel
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 # flake8: noqa
 DEFAULT_NA = ""
 DEFAULT_NAME = "pyexcel sheet"

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/cookbook.py

@@ -1,17 +1,18 @@
 """
-    pyexcel.cookbook
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.cookbook
+~~~~~~~~~~~~~~~~~~~
 
-    Cookbook for pyexcel
+Cookbook for pyexcel
 
-    :copyright: (c) 2014-2025 by Onni Software Ltd.
-    :license: New BSD License, see LICENSE for more details
+:copyright: (c) 2014-2025 by Onni Software Ltd.
+:license: New BSD License, see LICENSE for more details
 """
+
 import os
 
 from pyexcel.book import Book
 from pyexcel.core import save_as, get_book, get_sheet
-from pyexcel._compact import OrderedDict
+from pyexcel._compact import OrderedDict, get_string_file_name
 from pyexcel.constants import MESSAGE_WARNING
 
 DEFAULT_OUT_FILE = "pyexcel_merged.csv"
@@ -19,24 +20,25 @@ DEFAULT_OUT_XLS_FILE = "merged.xls"
 OUT_FILE_FORMATTER = "pyexcel_%s"
 
 
-def update_columns(infilename, column_dicts, outfilename=None):
+def update_columns(in_file_name, column_dicts, out_file_name=None):
     """Update one or more columns of a data file with series
 
     The data structure of column_dicts should be:
     key should be first row of the column
     the rest of the value should an array
-    :param str infilename: an accessible file name
+    :param str in_file_name: an accessible file name
     :param dict column_dicts: dictionaries of columns
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
 
 
     """
-    default_out_file = OUT_FILE_FORMATTER % infilename
-    if outfilename:
-        default_out_file = outfilename
+    in_file_name = get_string_file_name(in_file_name)
+    default_out_file = OUT_FILE_FORMATTER % in_file_name
+    if out_file_name:
+        default_out_file = get_string_file_name(out_file_name)
     if os.path.exists(default_out_file):
         raise NotImplementedError(MESSAGE_WARNING)
-    sheet = get_sheet(file_name=infilename, name_columns_by_row=0)
+    sheet = get_sheet(file_name=in_file_name, name_columns_by_row=0)
     series = sheet.colnames
     for k in column_dicts.keys():
         index = series.index(str(k))
@@ -44,21 +46,22 @@ def update_columns(infilename, column_dicts, outfilename=None):
     sheet.save_as(default_out_file)
 
 
-def update_rows(infilename, row_dicts, outfilename=None):
+def update_rows(in_file_name, row_dicts, out_file_name=None):
     """Update one or more rows of a data file with series
 
-    datastucture: key should an integer of the row to be updated
+    data stucture: key should an integer of the row to be updated
     value should be an array of the data
-    :param str infilename: an accessible file name
+    :param str in_file_name: an accessible file name
     :param dict row_dicts: dictionaries of rows
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
-    default_out_file = OUT_FILE_FORMATTER % infilename
-    if outfilename:
-        default_out_file = outfilename
+    in_file_name = get_string_file_name(in_file_name)
+    default_out_file = OUT_FILE_FORMATTER % in_file_name
+    if out_file_name:
+        default_out_file = get_string_file_name(out_file_name)
     if os.path.exists(default_out_file):
         raise NotImplementedError(MESSAGE_WARNING)
-    sheet = get_sheet(file_name=infilename, name_rows_by_column=0)
+    sheet = get_sheet(file_name=in_file_name, name_rows_by_column=0)
     series = sheet.rownames
     for k in row_dicts.keys():
         index = series.index(str(k))
@@ -66,11 +69,12 @@ def update_rows(infilename, row_dicts, outfilename=None):
     sheet.save_as(default_out_file)
 
 
-def merge_files(file_array, outfilename=DEFAULT_OUT_FILE):
+def merge_files(file_array, out_file_name=DEFAULT_OUT_FILE):
     """merge many files horizontally column after column
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
-    if os.path.exists(outfilename):
+    out_file_name = get_string_file_name(out_file_name)
+    if os.path.exists(out_file_name):
         raise NotImplementedError(MESSAGE_WARNING)
     content = []
     for file_name in file_array:
@@ -78,54 +82,56 @@ def merge_files(file_array, outfilename=DEFAULT_OUT_FILE):
         content.extend(list(sheet.columns()))
     merged_sheet = get_sheet(array=content)
     merged_sheet.transpose()
-    merged_sheet.save_as(outfilename)
-    return outfilename
+    merged_sheet.save_as(out_file_name)
+    return out_file_name
 
 
-def merge_two_files(file1, file2, outfilename=DEFAULT_OUT_FILE):
+def merge_two_files(file1, file2, out_file_name=DEFAULT_OUT_FILE):
     """merge two files
 
     :param str file1: an accessible file name
     :param str file2: an accessible file name
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
-    if os.path.exists(outfilename):
+    out_file_name = get_string_file_name(out_file_name)
+    if os.path.exists(out_file_name):
         raise NotImplementedError(MESSAGE_WARNING)
     files = [file1, file2]
-    merge_files(files, outfilename)
+    merge_files(files, out_file_name)
 
 
-def merge_readers(reader_array, outfilename=DEFAULT_OUT_FILE):
+def merge_readers(reader_array, out_file_name=DEFAULT_OUT_FILE):
     """merge many readers
 
     With FilterableReader and SeriesReader, you can do custom filtering
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
-    if os.path.exists(outfilename):
+    out_file_name = get_string_file_name(out_file_name)
+    if os.path.exists(out_file_name):
         raise NotImplementedError(MESSAGE_WARNING)
     content = OrderedDict()
     for reader in reader_array:
         content.update(reader.dict)
-    save_as(dest_file_name=outfilename, adict=content)
+    save_as(dest_file_name=out_file_name, adict=content)
 
 
-def merge_two_readers(reader1, reader2, outfilename=DEFAULT_OUT_FILE):
+def merge_two_readers(reader1, reader2, out_file_name=DEFAULT_OUT_FILE):
     """merge two readers
 
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
 
     """
-    if os.path.exists(outfilename):
+    if os.path.exists(out_file_name):
         raise NotImplementedError(MESSAGE_WARNING)
     reader_array = [reader1, reader2]
-    merge_readers(reader_array, outfilename)
+    merge_readers(reader_array, out_file_name)
 
 
-def merge_csv_to_a_book(filelist, outfilename=DEFAULT_OUT_XLS_FILE):
+def merge_csv_to_a_book(filelist, out_file_name=DEFAULT_OUT_XLS_FILE):
     """merge a list of csv files into a excel book
 
     :param list filelist: a list of accessible file path
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
     merged = Book()
     for file_name in filelist:
@@ -133,30 +139,30 @@ def merge_csv_to_a_book(filelist, outfilename=DEFAULT_OUT_XLS_FILE):
         _, tail = os.path.split(file_name)
         sheet.name = tail
         merged += sheet
-    merged.save_as(outfilename)
+    merged.save_as(out_file_name)
 
 
-def merge_all_to_a_book(filelist, outfilename=DEFAULT_OUT_XLS_FILE):
+def merge_all_to_a_book(filelist, out_file_name=DEFAULT_OUT_XLS_FILE):
     """merge a list of excel files into a excel book
 
     :param list filelist: a list of accessible file path
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
     merged = Book()
     for file_name in filelist:
         merged += get_book(file_name=file_name)
-    merged.save_as(outfilename)
+    merged.save_as(out_file_name)
 
 
-def split_a_book(file_name, outfilename=None):
+def split_a_book(file_name, out_file_name=None):
     """Split a file into separate sheets
 
     :param str file_name: an accessible file name
-    :param str outfilename: save the sheets with file suffix
+    :param str out_file_name: save the sheets with file suffix
     """
     book = get_book(file_name=file_name)
-    if outfilename:
-        saveas = outfilename
+    if out_file_name:
+        saveas = out_file_name
     else:
         saveas = file_name
     for sheet in book:
@@ -164,16 +170,16 @@ def split_a_book(file_name, outfilename=None):
         sheet.save_as(filename)
 
 
-def extract_a_sheet_from_a_book(file_name, sheetname, outfilename=None):
+def extract_a_sheet_from_a_book(file_name, sheetname, out_file_name=None):
     """Extract a sheet from a excel book
 
     :param str file_name: an accessible file name
     :param str sheetname: a valid sheet name
-    :param str outfilename: save the sheet as
+    :param str out_file_name: save the sheet as
     """
     book = get_book(file_name=file_name)
-    if outfilename:
-        saveas = outfilename
+    if out_file_name:
+        saveas = out_file_name
     else:
         saveas = file_name
     sheet = book[sheetname]

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/core.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.core
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.core
+~~~~~~~~~~~~~~~~~~~
 
-    A list of pyexcel signature functions
+A list of pyexcel signature functions
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 import re
 
 from pyexcel import constants

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/deprecated.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.deprecated
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.deprecated
+~~~~~~~~~~~~~~~~~~~
 
-    List of apis that become deprecated but was kept for backward compatibility
+List of APIs that become deprecated but was kept for backward compatibility
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 from functools import partial
 
 from pyexcel.core import get_book, get_sheet
@@ -66,7 +67,9 @@ def load(file_name, sheetname=None, **keywords):
         )
     else:
         sheet = get_sheet(
-            file_name=file_name, sheet_name=sheetname, **keywords,
+            file_name=file_name,
+            sheet_name=sheetname,
+            **keywords,
         )
     return sheet
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/docstrings/__init__.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.docstrings
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.docstrings
+~~~~~~~~~~~~~~~~~~~
 
-    Reusible docstrings
+Reusible docstrings
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 # flake8: noqa
 from .core import (
     SAVE_AS,
@@ -21,7 +22,7 @@ from .core import (
     IGET_RECORDS,
     SAVE_BOOK_AS,
     GET_BOOK_DICT,
-    ISAVE_BOOK_AS
+    ISAVE_BOOK_AS,
 )
 from .meta import SAVE_AS_OPTIONS
 from .garbagecollector import FREE_RESOURCES

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/docstrings/core.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.docstrings.core
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.docstrings.core
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Reusible docstrings for pyexcel.core
+Reusable docstrings for pyexcel.core
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 from . import keywords
 
 __GET_ARRAY__ = (

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/docstrings/keywords.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.docstrings.keywords
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.docstrings.keywords
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Reusible docstrings for keywords in signature functions
+Reusable docstrings for keywords in signature functions
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 CSV_PARAMS = """
 **Parameters related to csv file format**
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/docstrings/meta.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.docstrings.meta
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.docstrings.meta
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Reusible docstrings for pyexcel.internal.meta
+Reusable docstrings for pyexcel.internal.meta
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 from .keywords import CSV_PARAMS
 
 SAVE_AS_OPTIONS = (

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/exceptions.py

@@ -1,11 +1,11 @@
 """
-    pyexcel.exceptions
-    ~~~~~~~~~~~~~~~~~~~
+pyexcel.exceptions
+~~~~~~~~~~~~~~~~~~~
 
-    Exceptions appeared in pyexcel
+Exceptions appeared in pyexcel
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
 
 

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/internal/__init__.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.internal
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.internal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Pyexcel internals that subjected to change
+Pyexcel internals that subjected to change
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 from lml.loader import scan_plugins_regex
 from pyexcel.internal.plugins import PARSER, RENDERER  # noqa
 from pyexcel.internal.generators import BookStream, SheetStream  # noqa

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/internal/attributes.py

@@ -1,12 +1,13 @@
 """
-    pyexcel.internal.attributes
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.internal.attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Book and sheet attributes
+Book and sheet attributes
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 from pyexcel import constants
 
 ATTRIBUTE_REGISTRY = {

{pyexcel-0.7.2 → pyexcel-0.7.3}/pyexcel/internal/common.py

@@ -1,16 +1,17 @@
 """
-    pyexcel.internal.common
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+pyexcel.internal.common
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Defintion for the shared objects
+Definition for the shared objects
 
-    :copyright: (c) 2015-2022 by Onni Software Ltd.
-    :license: New BSD License
+:copyright: (c) 2015-2025 by Onni Software Ltd.
+:license: New BSD License
 """
+
 NO_COLUMN_NAMES = "Only sheet with column names is accepted"
 
 
-class SheetIterator():
+class SheetIterator:
     """
     Sheet Iterator
     """