tecio-python 0.2.2__tar.gz → 0.2.3__tar.gz

{tecio_python-0.2.2/tecio_python.egg-info → tecio_python-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tecio-python
-Version: 0.2.2
+Version: 0.2.3
 Summary: Python interface for reading and writing Tecplot data files
 Project-URL: Homepage, https://github.com/meersman/tecio
 Project-URL: Documentation, https://meersman.github.io/tecio/
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE

{tecio_python-0.2.2 → tecio_python-0.2.3}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tecio-python"
-version = "0.2.2"
+version = "0.2.3"
 description = "Python interface for reading and writing Tecplot data files"
 
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "numpy",
 ]
@@ -101,9 +101,19 @@ ignore = ["D203", "D213", "SIM105"]
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
+[tool.ty.environment]
+root = ["."]
+python-version = "3.11"
+
 [tool.ty.terminal]
 output-format = "concise"
 
+[[tool.ty.overrides]]
+include = ["tecio/plugins/**"]
+
+[tool.ty.overrides.rules]
+unresolved-import = "ignore"
+
 [tool.pytest.ini_options]
 pythonpath = ["tecio"]
 testpaths = ["tests"]

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/__init__.py

@@ -9,7 +9,7 @@ from importlib import metadata
 try:
     __version__ = metadata.version("tecio")
 except metadata.PackageNotFoundError:
-    __version__ = "0.0.0"
+    __version__ = "0.2.3"
 
 from . import cli, dat, libtecio, plt, szl
 from ._containers import VariableList, ZoneList

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tec2mat.py

@@ -136,9 +136,9 @@ Examples:
         end
 
 See Also:
-    * :mod:`tecio.cli.teconvert`: Convert between Tecplot file formats (``.szplt``,
+    * :mod:`tecio.cli.teconvert` - Convert between Tecplot file formats (``.szplt``,
       ``.plt``, ``.dat``) without leaving the Tecplot ecosystem.
-    * :mod:`tecio.cli.tecdump`: Inspect the full contents and metadata of a file before
+    * :mod:`tecio.cli.tecdump` - Inspect the full contents and metadata of a file before
       converting it.
 
 Note:

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecdump.py

@@ -70,7 +70,7 @@ Examples:
 See Also:
     * :mod:`tecio.cli.tecstats` - Compute per-zone min, max, and mean statistics without
       printing raw values.
-    * :mod:`tecio.cli.tecfix`: Rewrite a file with invalid variable
+    * :mod:`tecio.cli.tecfix` - Rewrite a file with invalid variable
       arrays set to passive once bad values have been identified.
 """
 

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecfix.py

@@ -66,9 +66,9 @@ Examples:
         tecfix(["flow.szplt", "--output", "clean.szplt"])
 
 See Also:
-    * :mod:`tecio.cli.tecdump`: Inspect file contents and metadata to
+    * :mod:`tecio.cli.tecdump` - Inspect file contents and metadata to
       identify zones or variables that may require fixing.
-    * :mod:`tecio.cli.tecstats`: Compute per-zone min, max, and mean
+    * :mod:`tecio.cli.tecstats` - Compute per-zone min, max, and mean
       statistics without printing raw values.
 
 Note:

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecmerge.py

@@ -83,10 +83,10 @@ Examples:
         tecmerge(["part1.szplt", "part2.szplt", "--output", "combined.szplt"])
 
 See Also:
-    * :mod:`tecio.cli.tecextract`: Extract a zone/variable subset from a single file —
+    * :mod:`tecio.cli.tecextract` - Extract a zone/variable subset from a single file —
       the inverse of merging.
-    * :mod:`tecio.cli.tecsplit`: Split a file into separate grid and solution files.
-    * :mod:`tecio.cli.tecslice`: Extract planar slices from volumetric zone data.
+    * :mod:`tecio.cli.tecsplit` - Split a file into separate grid and solution files.
+    * :mod:`tecio.cli.tecslice` - Extract planar slices from volumetric zone data.
 
 """
 
@@ -155,6 +155,7 @@ def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
         ),
     )
     parser.add_argument(
+        "-f",
         "--force",
         action="store_true",
         default=False,

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/teconvert.py

@@ -71,7 +71,7 @@ Examples:
         teconvert(["-dat", "-o", "flow.dat", "flow.szplt"])
 
 See Also:
-    :mod:`tecio.cli.tecextract`: Extract a zone/variable subset while simultaneously
+    :mod:`tecio.cli.tecextract` - Extract a zone/variable subset while simultaneously
     converting format via the output file extension.
 """
 
@@ -132,7 +132,7 @@ def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
             "  Explicit output path\n"
             "    $ teconvert -plt -o /tmp/out.plt flow.dat\n"
             "  Overwrite existing\n"
-            "  teconvert --force -dat flow.szplt\n"
+            "    $ teconvert --force -dat flow.szplt\n"
         ),
         formatter_class=lambda prog: argparse.RawDescriptionHelpFormatter(
             prog, width=70, max_help_position=24

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecscale.py

@@ -80,7 +80,7 @@ Examples:
         tecscale(["-variable", "Pressure", "-scale", "1e-3", "flow.szplt"])
 
 See Also:
-    :mod:`tecio.cli.teconvert`: Convert between Tecplot file formats without applying
+    :mod:`tecio.cli.teconvert` - Convert between Tecplot file formats without applying
     any variable transformation.
 
 """

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecslice.py

@@ -114,10 +114,10 @@ Examples:
         tecslice(["-i", "::2", "-o", "thinned.szplt", "flow.szplt"])
 
 See Also:
-    * :mod:`tecio.cli.tecextract`: Extract a subset of zones or variables by index
+    * :mod:`tecio.cli.tecextract` - Extract a subset of zones or variables by index
       rather than by positional slice.
-    * :mod:`tecio.cli.tecsplit`: Split a file into separate grid and solution files.
-    * :mod:`tecio.cli.tecmerge`: Merge zones from multiple files into a single output.
+    * :mod:`tecio.cli.tecsplit` - Split a file into separate grid and solution files.
+    * :mod:`tecio.cli.tecmerge` - Merge zones from multiple files into a single output.
 """
 
 from __future__ import annotations
@@ -277,7 +277,7 @@ def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
         description=(
             # -|--------------------|---------------------------------------------|
             "Slice a Tecplot file along IJK indices (ordered zones) and/or\n"
-            "solution time (all zone types).\n"
+            "solution time (all zone types).\n\n"
             "Slice notation: start:end:skip (any component may be omitted)."
         ),
         epilog=(
@@ -329,9 +329,9 @@ def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
     ijk = parser.add_argument_group(
         "IJK slicing",
         (
-            "Colon-notation slices for structured axes.  "
-            "Indices are 1-based and inclusive.  "
-            "Applied only to ordered (structured) zones."
+            # -|--------------------|---------------------------------------------|
+            "Colon-notation slices for structured axes. Indices are 1-based and\n"
+            "inclusive. Applied only to ordered (structured) zones."
         ),
     )
     for axis in ("i", "j", "k"):
@@ -351,8 +351,9 @@ def _parse_args(argv: Sequence[str] | None = None) -> argparse.Namespace:
     tslice = parser.add_argument_group(
         "solution-time slicing",
         (
-            "Applied per strand to all zone types.  "
-            "Strand-0 zones are always written unchanged."
+            # -|--------------------|---------------------------------------------|
+            "Applied per strand to all zone types. Strand-0 zones are always\n"
+            "written unchanged."
         ),
     )
     tslice.add_argument(

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/cli/tecstats.py

@@ -85,9 +85,9 @@ Examples:
         tecstats(["-zone", "2", "-variable", "3", "flow.szplt"])
 
 See Also:
-    * :mod:`tecio.cli.tecdump`: Inspect the full contents and metadata of a file,
+    * :mod:`tecio.cli.tecdump` - Inspect the full contents and metadata of a file,
       including auxiliary data and raw variable arrays.
-    * :mod:`tecio.cli.tecfix`: Rewrite a file with invalid variable arrays set to
+    * :mod:`tecio.cli.tecfix` - Rewrite a file with invalid variable arrays set to
        passive once bad values have been identified via statistics.
 
 """

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/dat/_read.py

@@ -706,20 +706,23 @@ class ReadAuxData:
 class ReadVariable:
     """Variable metadata and data for one zone parsed from an ASCII DAT file.
 
-    Interface matches :class:`szl.ReadVariable`.
-
-    Example:
-        >>> var = ReadVariable(name, data, value_location, ...)
+    Args:
+        zone_index: 1-based index of the zone this variable belongs to.
+        var_index:  1-based dataset variable index.
     """
 
     def __init__(
         self,
+        zone_index: int,
+        var_index: int,
         name: str,
         data: npt.NDArray | None,
         value_location: ValueLocation = ValueLocation.NODAL,
         is_passive: bool = False,
         shared_zone: int | None = None,
     ) -> None:
+        self.zone_index: int = zone_index
+        self.var_index: int = var_index
         self._name: str = name
         self._data: npt.NDArray | None = data
         self._value_location: ValueLocation = value_location
@@ -844,6 +847,7 @@ class ReadZone:
     """Zone data parsed from a Tecplot ASCII DAT file.
 
     Attributes:
+        zone_index: 1-based dataset zone index.
         datapacking: :class:`~tecio.libtecio.DataPacking` member reflecting the
             ``DATAPACKING`` keyword found in the zone header (``BLOCK`` or
             ``POINT``). The data arrays are identical either way; this attribute
@@ -853,11 +857,12 @@ class ReadZone:
             automatically resolves to the source zone's array.
 
     Example:
-        >>> zone = ReadZone(title, zone_type, I, J, K, ...)
+        >>> zone = ReadZone(zone_index, title, zone_type, I, J, K, ...)
     """
 
     def __init__(
         self,
+        zone_index: int,
         title: str,
         zone_type: ZoneType,
         I: int,  # noqa: E741
@@ -871,6 +876,7 @@ class ReadZone:
         datapacking: DataPacking = DataPacking.BLOCK,
         shared_connectivity: int | None = None,
     ) -> None:
+        self.zone_index: int = zone_index
         self.title: str = title
         self.zone_type: ZoneType = zone_type
         self.I: int = I
@@ -1459,8 +1465,13 @@ class Read:
                     self._zones[src_zone_1based - 1].variable[var_idx].values
                 )
 
+        # This zone's own 1-based index
+        zone_index = len(self._zones) + 1
+
         read_vars = [
             ReadVariable(
+                zone_index=zone_index,
+                var_index=idx + 1,
                 name=name,
                 data=_shaped(
                     var_arrays[idx],
@@ -1475,6 +1486,7 @@ class Read:
 
         self._zones.append(
             ReadZone(
+                zone_index=zone_index,
                 title=zone_title,
                 zone_type=zone_type,
                 I=I,

{tecio_python-0.2.2 → tecio_python-0.2.3}/tecio/plt/_read.py

@@ -552,7 +552,7 @@ class ReadVariable:
 
         # Byte-swap if needed so the result is always native-endian
         if data.dtype.byteorder not in ("=", "|", np.dtype(dt).str[0]):
-            data = data.byteswap().newbyteorder()
+            data = data.byteswap().view(data.dtype.newbyteorder())
 
         # Reshape for full reads of ordered zones, using the owning zone's dimensions
         # and value location (they describe the on-disk layout including cell-centered