numbers-parser 4.12.1__tar.gz → 4.13.1__tar.gz

{numbers_parser-4.12.1 → numbers_parser-4.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: numbers-parser
-Version: 4.12.1
+Version: 4.13.1
 Summary: Read and write Apple Numbers spreadsheets
 Home-page: https://github.com/masaccio/numbers-parser
 License: MIT
@@ -78,11 +78,11 @@ sudo apt-get -y install libsnappy-dev
 ```
 
 On Windows, you will need to either arrange for snappy to be found for VSC++ or you can install python
-binary libraries compiled by [Christoph Gohlke](https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-snappy). You must select the correct python
-version for your installation. For example for python 3.11:
+[pre-compiled binary libraries](https://github.com/cgohlke/win_arm64-wheels/) which are only available
+for Windows on Arm. There appear to be no x86 pre-compiled packages for Windows.
 
 ```text
-pip install python_snappy-0.6.1-cp311-cp311-win_amd64.whl
+pip install python_snappy-0.6.1-cp312-cp312-win_arm64.whl
 ```
 
 ## Quick Start
@@ -337,8 +337,15 @@ see the [full API docs](https://masaccio.github.io/numbers-parser/).
 ## Command-line scripts
 
 When installed from [PyPI](https://pypi.org/project/numbers-parser/),
-a command-like script `cat-numbers` is installed in Python’s scripts
-folder. This script dumps Numbers spreadsheets into Excel-compatible CSV
+a number of command-line scripts are installed:
+
+- `cat-numbers`: converts Numbers documents into CSV
+- `csv2numbers`: converts CSV files to Numbers documents
+- `unpack-numbers`: converts Numbers documents into JSON files for debug purposes
+
+### cat-numbers
+
+This script dumps Numbers spreadsheets into Excel-compatible CSV
 format, iterating through all the spreadsheets passed on the
 command-line.
 
@@ -375,6 +382,102 @@ and `datetime.strftime`. Numbers in English locales displays 12-hour
 times with ‘am’ and ‘pm’, but `datetime.strftime` on macOS at least
 cannot return lower-case versions of AM/PM.
 
+### csv2numbers
+
+This script converts Excel-compatible CSV files into Numbers documents. Output files
+can optionally be provided, but is none are provided, the output is created by replacing
+the input’s files suffix with .numbers. For example:
+
+```text
+csv2numbers file1.csv file2.csv -o file1.numbers file2.numbers
+```
+
+Columns of data can have a number of transformations applied to them. The primary use-
+case intended for `csv2numbers` is converting banking exports to well-formatted
+spreadsheets.
+
+```text
+usage: csv2numbers [-h] [-V] [--whitespace] [--reverse] [--no-header]
+                   [--day-first] [--date COLUMNS] [--rename COLUMNS-MAP]
+                   [--transform COLUMNS-MAP] [--delete COLUMNS]
+                   [-o [FILENAME ...]]
+                   [csvfile ...]
+
+positional arguments:
+  csvfile               CSV file to convert
+
+options:
+  -h, --help            show this help message and exit
+  -V, --version
+  --whitespace          strip whitespace from beginning and end of strings
+                        and collapse other whitespace into single space
+                        (default: false)
+  --reverse             reverse the order of the data rows (default:
+                        false)
+  --no-header           CSV file has no header row (default: false)
+  --day-first           dates are represented day first in the CSV file
+                        (default: false)
+  --date COLUMNS        comma-separated list of column names/indexes to
+                        parse as dates
+  --rename COLUMNS-MAP  comma-separated list of column names/indexes to
+                        renamed as 'OLD:NEW'
+  --transform COLUMNS-MAP
+                        comma-separated list of column names/indexes to
+                        transform as 'NEW:FUNC=OLD'
+  --delete COLUMNS      comma-separated list of column names/indexes to
+                        delete
+  -o [FILENAME ...], --output [FILENAME ...]
+                        output filename (default: use source file with
+                        .numbers)
+```
+
+The following options affecting the output of the entire file. The default for each is always false.
+
+- `--whitespace`: strip whitespace from beginning and end of strings and collapse other whitespace into single space
+- `--reverse`: reverse the order of the data rows
+- `--no-header`: CSV file has no header row
+- ``--day-first`: dates are represented day first in the CSV file
+
+`csv2numbers` can also perform column manipulation. Columns can be identified using their name if the CSV file has a header or using a column index. Columns are zero-indexed and names and indices can be used together on the same command-line. When multiple columns are required, you can specify them using comma-separated values. The format for these arguments, like for the CSV file itself, the Excel dialect.
+
+#### Deleting columns
+
+Delete columns using `--delete`. The names or indices of the columns to delete are specified as comma-separated values:
+
+```text
+csv2numbers file1.csv --delete=Account,3
+```
+
+#### Renaming columns
+
+Rename columns using `--rename`. The current column name and new column name are separated by a `:` and each renaming is specified as comma-separated values:
+
+```text
+csv2numbers file1.csv --rename=2:Account,"Paid In":Amount
+```
+
+#### Date columns
+
+The `--date` option identifies a comma-separated list of columns that should be parsed as dates. Use `--day-first` where the day and month is ambiguous anf the day comes first rather than the month.
+
+#### Transforming columns
+
+Columns can be merged and new columns created using simple functions. The –transform option takes a comma-seperated list of transformations of the form NEW:FUNC=OLD. Supported functions are:
+
+| Function   | Arguments                   | Description                                                                                                                                                                                                                                                                                                                                           |
+|------------|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| MERGE      | dest=MERGE:source           | The dest column is writen with values from one or more columns<br/>indicated by source. For multiple columns, which are separated<br/>by ;, the first empty value is chosen.                                                                                                                                                                          |
+| NEG        | dest=NEG:source             | The dest column contains absolute values of any column that is<br/>negative. This is useful for isolating debits from account<br/>exports.                                                                                                                                                                                                            |
+| POS        | dest=NEG:source             | The dest column contains values of any column that is<br/>positive. This is useful for isolating credits from account<br/>exports.                                                                                                                                                                                                                    |
+| LOOKUP     | dest=LOOKUP:source;filename | A lookup map is read from filename which must be an Apple<br/>Numbers file containing a single table of two columns. The table<br/>is used to match agsinst source, searching the first column<br/>for matches and writing the corresponding value from the second<br/>column to dest. Values are chosen based on the longest<br/>matching substring. |
+
+Examples:
+
+```text
+csv2numbers --transform="Paid In"=POS:Amount,Withdrawn=NEG:Amount file1.csv
+csv2numbers --transform='Category=LOOKUP:Transaction;mapping.numbers' file1.csv
+```
+
 ## Limitations
 
 Current known limitations of `numbers-parser` which may be implemented in the future are:

{numbers_parser-4.12.1 → numbers_parser-4.13.1}/README.md

@@ -46,11 +46,11 @@ sudo apt-get -y install libsnappy-dev
 ```
 
 On Windows, you will need to either arrange for snappy to be found for VSC++ or you can install python
-binary libraries compiled by [Christoph Gohlke](https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-snappy). You must select the correct python
-version for your installation. For example for python 3.11:
+[pre-compiled binary libraries](https://github.com/cgohlke/win_arm64-wheels/) which are only available
+for Windows on Arm. There appear to be no x86 pre-compiled packages for Windows.
 
 ```text
-pip install python_snappy-0.6.1-cp311-cp311-win_amd64.whl
+pip install python_snappy-0.6.1-cp312-cp312-win_arm64.whl
 ```
 
 ## Quick Start
@@ -305,8 +305,15 @@ see the [full API docs](https://masaccio.github.io/numbers-parser/).
 ## Command-line scripts
 
 When installed from [PyPI](https://pypi.org/project/numbers-parser/),
-a command-like script `cat-numbers` is installed in Python’s scripts
-folder. This script dumps Numbers spreadsheets into Excel-compatible CSV
+a number of command-line scripts are installed:
+
+- `cat-numbers`: converts Numbers documents into CSV
+- `csv2numbers`: converts CSV files to Numbers documents
+- `unpack-numbers`: converts Numbers documents into JSON files for debug purposes
+
+### cat-numbers
+
+This script dumps Numbers spreadsheets into Excel-compatible CSV
 format, iterating through all the spreadsheets passed on the
 command-line.
 
@@ -343,6 +350,102 @@ and `datetime.strftime`. Numbers in English locales displays 12-hour
 times with ‘am’ and ‘pm’, but `datetime.strftime` on macOS at least
 cannot return lower-case versions of AM/PM.
 
+### csv2numbers
+
+This script converts Excel-compatible CSV files into Numbers documents. Output files
+can optionally be provided, but is none are provided, the output is created by replacing
+the input’s files suffix with .numbers. For example:
+
+```text
+csv2numbers file1.csv file2.csv -o file1.numbers file2.numbers
+```
+
+Columns of data can have a number of transformations applied to them. The primary use-
+case intended for `csv2numbers` is converting banking exports to well-formatted
+spreadsheets.
+
+```text
+usage: csv2numbers [-h] [-V] [--whitespace] [--reverse] [--no-header]
+                   [--day-first] [--date COLUMNS] [--rename COLUMNS-MAP]
+                   [--transform COLUMNS-MAP] [--delete COLUMNS]
+                   [-o [FILENAME ...]]
+                   [csvfile ...]
+
+positional arguments:
+  csvfile               CSV file to convert
+
+options:
+  -h, --help            show this help message and exit
+  -V, --version
+  --whitespace          strip whitespace from beginning and end of strings
+                        and collapse other whitespace into single space
+                        (default: false)
+  --reverse             reverse the order of the data rows (default:
+                        false)
+  --no-header           CSV file has no header row (default: false)
+  --day-first           dates are represented day first in the CSV file
+                        (default: false)
+  --date COLUMNS        comma-separated list of column names/indexes to
+                        parse as dates
+  --rename COLUMNS-MAP  comma-separated list of column names/indexes to
+                        renamed as 'OLD:NEW'
+  --transform COLUMNS-MAP
+                        comma-separated list of column names/indexes to
+                        transform as 'NEW:FUNC=OLD'
+  --delete COLUMNS      comma-separated list of column names/indexes to
+                        delete
+  -o [FILENAME ...], --output [FILENAME ...]
+                        output filename (default: use source file with
+                        .numbers)
+```
+
+The following options affecting the output of the entire file. The default for each is always false.
+
+- `--whitespace`: strip whitespace from beginning and end of strings and collapse other whitespace into single space
+- `--reverse`: reverse the order of the data rows
+- `--no-header`: CSV file has no header row
+- ``--day-first`: dates are represented day first in the CSV file
+
+`csv2numbers` can also perform column manipulation. Columns can be identified using their name if the CSV file has a header or using a column index. Columns are zero-indexed and names and indices can be used together on the same command-line. When multiple columns are required, you can specify them using comma-separated values. The format for these arguments, like for the CSV file itself, the Excel dialect.
+
+#### Deleting columns
+
+Delete columns using `--delete`. The names or indices of the columns to delete are specified as comma-separated values:
+
+```text
+csv2numbers file1.csv --delete=Account,3
+```
+
+#### Renaming columns
+
+Rename columns using `--rename`. The current column name and new column name are separated by a `:` and each renaming is specified as comma-separated values:
+
+```text
+csv2numbers file1.csv --rename=2:Account,"Paid In":Amount
+```
+
+#### Date columns
+
+The `--date` option identifies a comma-separated list of columns that should be parsed as dates. Use `--day-first` where the day and month is ambiguous anf the day comes first rather than the month.
+
+#### Transforming columns
+
+Columns can be merged and new columns created using simple functions. The –transform option takes a comma-seperated list of transformations of the form NEW:FUNC=OLD. Supported functions are:
+
+| Function   | Arguments                   | Description                                                                                                                                                                                                                                                                                                                                           |
+|------------|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| MERGE      | dest=MERGE:source           | The dest column is writen with values from one or more columns<br/>indicated by source. For multiple columns, which are separated<br/>by ;, the first empty value is chosen.                                                                                                                                                                          |
+| NEG        | dest=NEG:source             | The dest column contains absolute values of any column that is<br/>negative. This is useful for isolating debits from account<br/>exports.                                                                                                                                                                                                            |
+| POS        | dest=NEG:source             | The dest column contains values of any column that is<br/>positive. This is useful for isolating credits from account<br/>exports.                                                                                                                                                                                                                    |
+| LOOKUP     | dest=LOOKUP:source;filename | A lookup map is read from filename which must be an Apple<br/>Numbers file containing a single table of two columns. The table<br/>is used to match agsinst source, searching the first column<br/>for matches and writing the corresponding value from the second<br/>column to dest. Values are chosen based on the longest<br/>matching substring. |
+
+Examples:
+
+```text
+csv2numbers --transform="Paid In"=POS:Amount,Withdrawn=NEG:Amount file1.csv
+csv2numbers --transform='Category=LOOKUP:Transaction;mapping.numbers' file1.csv
+```
+
 ## Limitations
 
 Current known limitations of `numbers-parser` which may be implemented in the future are:

{numbers_parser-4.12.1 → numbers_parser-4.13.1}/pyproject.toml

@@ -12,11 +12,12 @@ name = "numbers-parser"
 packages = [{include = "numbers_parser", from = "src"}]
 readme = "README.md"
 repository = "https://github.com/masaccio/numbers-parser"
-version = "4.12.1"
+version = "4.13.1"
 
 [tool.poetry.scripts]
 cat-numbers = "numbers_parser._cat_numbers:main"
 unpack-numbers = "numbers_parser._unpack_numbers:main"
+csv2numbers = "numbers_parser._csv2numbers:main"
 
 [tool.poetry.dependencies]
 compact-json = "^1.1.3"

numbers_parser-4.13.1/src/numbers_parser/_csv2numbers.py

@@ -0,0 +1,416 @@
+"""Command-line utility to convert CSV files to Apple Numbers spreadsheets."""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import re
+from dataclasses import dataclass
+from datetime import datetime, timezone
+from pathlib import Path
+from sys import exit, stderr
+from typing import NamedTuple, Tuple  # noqa: F401
+
+from dateutil.parser import parse
+
+from numbers_parser import Document, NumbersError, _get_version
+
+
+class ColumnTransform(NamedTuple):
+    """Class for holding a column transformation rule."""
+
+    source: list[str]
+    dest: str
+    func: callable
+
+
+@dataclass
+class Converter:
+    input_filename: str = None
+    output_filename: str = None
+    date_columns: list = None
+    day_first: bool = False
+    no_header: bool = False
+    reverse: bool = False
+    whitespace: bool = None
+
+    def __post_init__(self: Converter) -> None:
+        """Parse CSV file with Pandas and return a dataframe."""
+        self._read_csv()
+        self._transform_data()
+
+    def _read_csv(self) -> None:
+        """Read a CSV file into the data array."""
+        try:
+            dialect = csv.excel
+            dialect.strict = True
+            lineno = 1
+            with open(self.input_filename) as csvfile:
+                csvreader = csv.reader(csvfile, dialect=dialect)
+                if self.no_header:
+                    self.header = None
+                else:
+                    self.header = next(csvreader)
+                    lineno += 1
+                self.data = []
+                for row in csvreader:
+                    self.data += [row]
+                    lineno += 1
+        except FileNotFoundError as e:
+            msg = f"{self.input_filename}: file not found"
+            raise RuntimeError(msg) from e
+        except csv.Error as e:
+            msg = f"{self.input_filename}@{lineno}: {e.args[0]}"
+            raise RuntimeError(msg) from e
+
+    def _parse_date(self, x) -> datetime:
+        """Parse a date string and return a datetime."""
+        return parse(x, dayfirst=self.day_first).replace(tzinfo=timezone.utc)
+
+    def _transform_data(self):
+        """Apply type transformations to the data based in current configuration."""
+        # Convert data rows to dicts. csv.DictReader is not enough as we support CSV
+        # files with no header.
+        if self.no_header:
+            self.header = [x for x in range(len(self.data[0]))]
+        self.data = [{k: v for k, v in dict(zip(self.header, row)).items()} for row in self.data]
+
+        if self.reverse:
+            self.data = list(reversed(self.data))
+        if self.date_columns is not None:
+            is_date_column = {x: True if x in self.date_columns else False for x in self.header}
+        for row in self.data:
+            for k, v in row.items():
+                if self.whitespace:
+                    row[k] = re.sub(r"\s+", " ", v.strip())
+                if self.date_columns is not None and is_date_column[k]:
+                    row[k] = self._parse_date(v)
+                else:
+                    # Attempt to coerce value into float
+                    try:
+                        row[k] = float(v.replace(",", ""))
+                    except ValueError:
+                        pass
+
+    def rename_columns(self: Converter, mapper: dict) -> None:
+        """Rename columns using column map."""
+        if mapper is None:
+            return
+        self.no_header = False
+        self.header = [mapper[x] if x in mapper else x for x in self.header]
+
+    def delete_columns(self: Converter, columns: list) -> None:
+        """Delete columns from the data."""
+        if columns is None:
+            return
+
+        missing_columns = list(set(columns) - set(self.header))
+        if len(missing_columns) > 0:
+            msg = "'" + "', '".join([str(x) for x in missing_columns]) + "'"
+            msg += ": cannot delete: column(s) do not exist in CSV"
+            raise RuntimeError(msg) from None
+
+        for col in columns:
+            del self.header[self.header.index(col)]
+        for row in self.data:
+            for col in columns:
+                del row[col]
+
+    def transform_columns(self: Converter, columns: list[ColumnTransform]) -> None:
+        """Perform column transformationstransformations."""
+        if columns is None:
+            return
+        for transform in columns:
+            transform.transform(self.header, self.data)
+            if transform.dest not in self.header:
+                self.header.append(transform.dest)
+
+    def save(self: Converter) -> None:
+        """Write dataframe transctions to a Numbers file."""
+        doc = Document(num_rows=2, num_cols=2)
+        table = doc.sheets[0].tables[0]
+
+        if self.no_header:
+            data = []
+        else:
+            data = [self.header]
+        data += [row.values() for row in self.data]
+
+        for row_num, row in enumerate(data):
+            for col_num, value in enumerate(row):
+                table.write(row_num, col_num, value)
+                if isinstance(value, datetime):
+                    table.set_cell_formatting(
+                        row_num, col_num, "datetime", date_time_format="d MMM yyyy"
+                    )
+
+        doc.save(self.output_filename)
+
+
+class Transformer:
+    """Base class for column transformations."""
+
+    def __init__(self: Transformer, source: str, dest: str) -> None:
+        self.dest = int(dest) if dest.isnumeric() else dest
+        self.sources = [int(x) if x.isnumeric() else x for x in source.split(";")]
+
+    def transform_row(self: Transformer, row: list[str]) -> list[str]:
+        """Abstract base method for transforming rows using df.apply()."""
+        raise NotImplementedError
+
+    def transform(self: Transformer, header: list[str], data: list[list[str]]) -> list[list[str]]:
+        """Column transform to merge columns."""
+        if not all(x in header for x in self.sources):
+            missing = list(set(self.sources) - set(header))
+            msg = "'" + "', '".join([str(x) for x in missing]) + "'"
+            msg += ": transform failed: column(s) do not exist in CSV"
+            raise RuntimeError(msg)
+        for row in data:
+            self.transform_row(row)
+
+
+class MergeTransformer(Transformer):
+    """Transformer for column MERGE operations."""
+
+    def transform_row(self: MergeTransformer, row: list[str]) -> list[str]:
+        """Merge data in a single row."""
+        value = ""
+        for col in self.sources:
+            if row[col] and not value:
+                value = row[col]
+        row[self.dest] = value
+
+
+class NegTransformer(Transformer):
+    """Transformer for column NEG operations."""
+
+    def transform_row(self: NegTransformer, row: list[str]) -> list[str]:
+        """Select negative values for a row."""
+        value = ""
+        for col in self.sources:
+            if row[col] and not value and float(row[col]) < 0:
+                value = abs(float(row[col]))
+        row[self.dest] = value
+
+
+class PosTransformer(Transformer):
+    """Transformer for column POS operations."""
+
+    def transform_row(self: PosTransformer, row: list[str]) -> list[str]:
+        """Select positive values for a row."""
+        value = ""
+        for col in self.sources:
+            if row[col] and not value and float(row[col]) > 0:
+                value = float(row[col])
+        row[self.dest] = value
+
+
+class LookupTransformer(Transformer):
+    """Transformer for column LOOKUP operations."""
+
+    def __init__(self: Transformer, source: str, dest: str) -> None:
+        super().__init__(source, dest)
+
+        if len(self.sources) != 2:
+            msg = f"'{self.sources}' LOOKUP must have exactly 2 arguments"
+            raise RuntimeError(msg) from None
+
+        (source, map_filname) = self.sources
+        self.sources = [source]
+
+        if not Path(map_filname).exists():
+            msg = f"{map_filname}: no such file or directory"
+            raise RuntimeError(msg) from None
+
+        try:
+            doc = Document(map_filname)
+            table = doc.sheets[0].tables[0]
+            self.lookup_map = {
+                table.cell(row_num, 0).value: table.cell(row_num, 1).value
+                for row_num in range(table.num_rows)
+            }
+        except NumbersError as e:
+            msg = f"{map_filname}: {e!r}"
+            raise RuntimeError(msg) from e
+
+    def transform_row(self: LookupTransformer, row: list[str]) -> list[str]:
+        """Column transform to map values based on a lookup table."""
+        matches = [
+            {"value": v, "len": len(k)}
+            for k, v in self.lookup_map.items()
+            if k.lower() in row[self.sources[0]].lower()
+        ]
+        if len(matches) > 0:
+            row[self.dest] = max(matches, key=lambda x: x["len"])["value"]
+        else:
+            row[self.dest] = ""
+
+
+TRANSFORMERS = {
+    "merge": MergeTransformer,
+    "neg": NegTransformer,
+    "pos": PosTransformer,
+    "lookup": LookupTransformer,
+}
+
+
+def parse_columns(arg: str) -> list:
+    """Parse a list of column names in Excel-compatible CSV format."""
+    try:
+        return [int(x) if x.isnumeric() else x for x in next(csv.reader([arg], strict=True))]
+    except csv.Error as e:
+        msg = f"'{arg}': can't parse argument"
+        raise argparse.ArgumentTypeError(msg) from e
+
+
+def parse_column_renames(arg: str) -> dict:
+    """Parse a list of column renames in Excel-compatible CSV format."""
+    mapper = {}
+    try:
+        for mapping in next(csv.reader([arg], strict=True)):
+            if mapping.count(":") != 1:
+                msg = f"'{mapping}': column rename maps must be formatted 'OLD:NEW'"
+                raise argparse.ArgumentTypeError(msg)
+            (old, new) = mapping.split(":")
+            old = int(old) if old.isnumeric() else old
+            mapper[old] = new
+    except csv.Error as e:
+        msg = f"'{arg}': malformed CSV string"
+        raise argparse.ArgumentTypeError(msg) from e
+    else:
+        return mapper
+
+
+def parse_column_transforms(arg: str) -> list[ColumnTransform]:
+    """Parse a list of column renames in Excel-compatible CSV format."""
+    transforms = []
+    try:
+        for transform in next(csv.reader([arg], strict=True)):
+            m = re.match(r"(.+)=(\w+):(.+)", transform)
+            if not m:
+                msg = f"'{transform}': invalid transformation format"
+                raise argparse.ArgumentTypeError(msg)
+            dest = m.group(1)
+            func = m.group(2).lower()
+            source = m.group(3)
+            if func not in TRANSFORMERS:
+                msg = f"'{m.group(2)}': invalid transformation"
+                raise argparse.ArgumentTypeError(msg)
+            transforms.append(TRANSFORMERS[func.lower()](source, dest))
+    except csv.Error as e:
+        msg = f"'{arg}': malformed CSV string"
+        raise argparse.ArgumentTypeError(msg) from e
+    else:
+        return transforms
+
+
+def command_line_parser() -> argparse.ArgumentParser:
+    """Create a command-line argument parser and return parsed arguments."""
+    parser = argparse.ArgumentParser()
+    parser.add_argument("-V", "--version", action="store_true")
+    parser.add_argument(
+        "--whitespace",
+        required=False,
+        action="store_true",
+        help="strip whitespace from beginning and end of strings and "
+        "collapse other whitespace into single space (default: false)",
+    )
+    parser.add_argument(
+        "--reverse",
+        required=False,
+        action="store_true",
+        help="reverse the order of the data rows (default: false)",
+    )
+    parser.add_argument(
+        "--no-header",
+        required=False,
+        action="store_true",
+        help="CSV file has no header row (default: false)",
+    )
+    parser.add_argument(
+        "--day-first",
+        required=False,
+        action="store_true",
+        help="dates are represented day first in the CSV file (default: false)",
+    )
+    parser.add_argument(
+        "--date",
+        metavar="COLUMNS",
+        type=parse_columns,
+        help="comma-separated list of column names/indexes to parse as dates",
+    )
+    parser.add_argument(
+        "--rename",
+        metavar="COLUMNS-MAP",
+        type=parse_column_renames,
+        help="comma-separated list of column names/indexes to renamed as 'OLD:NEW'",
+    )
+    parser.add_argument(
+        "--transform",
+        metavar="COLUMNS-MAP",
+        type=parse_column_transforms,
+        help="comma-separated list of column names/indexes to transform as 'NEW:FUNC=OLD'",
+    )
+    parser.add_argument(
+        "--delete",
+        metavar="COLUMNS",
+        type=parse_columns,
+        help="comma-separated list of column names/indexes to delete",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        nargs="*",
+        metavar="FILENAME",
+        help="output filename (default: use source file with .numbers)",
+    )
+    parser.add_argument("csvfile", nargs="*", help="CSV file to convert")
+    return parser
+
+
+def main() -> None:
+    """Convert the document and exit."""
+    parser = command_line_parser()
+    args = parser.parse_args()
+
+    if args.version:
+        print(_get_version())
+        exit(0)
+    elif len(args.csvfile) == 0:
+        print("At least one CSV file is required", file=stderr)
+        parser.print_help(stderr)
+        exit(1)
+
+    if args.output is None:
+        output_filenames = [Path(x).with_suffix(".numbers") for x in args.csvfile]
+    else:
+        output_filenames = args.output
+
+    if len(args.csvfile) != len(output_filenames):
+        print("The numbers of input and output file names do not match", file=stderr)
+        exit(1)
+
+    try:
+        for input_filename, output_filename in zip(args.csvfile, output_filenames):
+            converter = Converter(
+                day_first=args.day_first,
+                no_header=args.no_header,
+                whitespace=args.whitespace,
+                reverse=args.reverse,
+                date_columns=args.date,
+                input_filename=input_filename,
+                output_filename=output_filename,
+            )
+
+            converter.transform_columns(args.transform)
+            converter.rename_columns(args.rename)
+            converter.delete_columns(args.delete)
+            converter.save()
+    except RuntimeError as e:
+        print(e, file=stderr)
+        exit(1)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    # execute only if run as a script
+    main()

{numbers_parser-4.12.1 → numbers_parser-4.13.1}/src/numbers_parser/cell.py

@@ -1329,6 +1329,8 @@ class Cell(CellStorageFlags, Cacheable):
         is_currency: bool = False,
     ) -> None:
         self._is_currency = is_currency
+        if is_currency:
+            self._type = CellType.CURRENCY
         if format_type == FormattingType.CURRENCY:
             self._currency_format_id = format_id
         elif format_type == FormattingType.TICKBOX:

{numbers_parser-4.12.1 → numbers_parser-4.13.1}/src/numbers_parser/model.py

@@ -329,6 +329,10 @@ class _NumbersModel(Cacheable):
         if enabled is not None:
             table_info.super.caption_hidden = not enabled
         else:
+            caption_info_id = table_info.super.caption.identifier
+            caption_archive = self.objects[caption_info_id]
+            if caption_archive.DESCRIPTOR.name == "StandinCaptionArchive":
+                return False
             return not table_info.super.caption_hidden
 
     def find_style_id(self, style_substr: str):
@@ -482,6 +486,8 @@ class _NumbersModel(Cacheable):
         if caption is not None:
             clear_field_container(self.objects[caption_storage_id].text)
             self.objects[caption_storage_id].text.append(caption)
+        elif len(self.objects[caption_storage_id].text) == 0:
+            return "Caption"
         else:
             return self.objects[caption_storage_id].text[0]
 
@@ -1481,6 +1487,7 @@ class _NumbersModel(Cacheable):
             table_info_id, location="Document", component_id=self.calc_engine_id()
         )
         self.create_caption_archive(table_model_id)
+        self.caption_enabled(table_model_id, False)
 
         self.add_formula_owner(
             table_info_id,