pyogrio 0.8.0__cp39-cp39-manylinux_2_28_aarch64.whl → 0.10.0__cp39-cp39-manylinux_2_28_aarch64.whl

pyogrio/proj_data/proj4-targets.cmake

@@ -7,7 +7,7 @@ if(CMAKE_VERSION VERSION_LESS "2.8.12")
    message(FATAL_ERROR "CMake >= 2.8.12 required")
 endif()
 cmake_policy(PUSH)
-cmake_policy(VERSION 2.8.12...3.27)
+cmake_policy(VERSION 2.8.12...3.28)
 #----------------------------------------------------------------
 # Generated CMake target import file.
 #----------------------------------------------------------------

pyogrio/proj_data/projjson.schema.json

@@ -2,7 +2,7 @@
   "$id": "https://proj.org/schemas/v0.7/projjson.schema.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "description": "Schema for PROJJSON (v0.7)",
-  "$comment": "This file exists both in data/ and in schemas/vXXX/. Keep both in sync. And if changing the value of $id, change PROJJSON_DEFAULT_VERSION accordingly in io.cpp",
+  "$comment": "This document is copyright Even Rouault and PROJ contributors, 2019-2023, and subject to the MIT license. This file exists both in data/ and in schemas/vXXX/. Keep both in sync. And if changing the value of $id, change PROJJSON_DEFAULT_VERSION accordingly in io.cpp",
 
   "oneOf": [
     { "$ref": "#/definitions/crs" },

pyogrio/proj_data/vcpkg.spdx.json

@@ -3,13 +3,13 @@
   "spdxVersion": "SPDX-2.2",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "documentNamespace": "https://spdx.org/spdxdocs/proj-arm64-linux-dynamic-release-9.4.0-edc92951-66a1-436f-8bb7-8e2d8412fdc0",
-  "name": "proj:arm64-linux-dynamic-release@9.4.0 2390d4ac09577aae072602ffa5778fb45348916244670786c8fb79324999d80b",
+  "documentNamespace": "https://spdx.org/spdxdocs/proj-arm64-linux-dynamic-release-9.4.1-fba5f38f-d4a2-4e46-8bba-3f6de9ca2c3a",
+  "name": "proj:arm64-linux-dynamic-release@9.4.1 b410f095d31bb162f9fa8ddd0c046646e92c848ed8fb3f7d76b01e1e8bfec8bc",
   "creationInfo": {
     "creators": [
-      "Tool: vcpkg-unknownhash"
+      "Tool: vcpkg-2999-12-31-unknownhash"
     ],
-    "created": "2024-05-04T14:23:19Z"
+    "created": "2024-09-27T18:53:50Z"
   },
   "relationships": [
     {
@@ -87,8 +87,8 @@
     {
       "name": "proj",
       "SPDXID": "SPDXRef-port",
-      "versionInfo": "9.4.0",
-      "downloadLocation": "git+https://github.com/Microsoft/vcpkg@62e9ace469641b907291184ebc7e76d96f629881",
+      "versionInfo": "9.4.1",
+      "downloadLocation": "git+https://github.com/Microsoft/vcpkg@dafa38417689eb52c17a425ace8e1f3ecfb74045",
       "homepage": "https://proj.org/",
       "licenseConcluded": "MIT",
       "licenseDeclared": "NOASSERTION",
@@ -99,7 +99,7 @@
     {
       "name": "proj:arm64-linux-dynamic-release",
       "SPDXID": "SPDXRef-binary",
-      "versionInfo": "2390d4ac09577aae072602ffa5778fb45348916244670786c8fb79324999d80b",
+      "versionInfo": "b410f095d31bb162f9fa8ddd0c046646e92c848ed8fb3f7d76b01e1e8bfec8bc",
       "downloadLocation": "NONE",
       "licenseConcluded": "MIT",
       "licenseDeclared": "NOASSERTION",
@@ -109,86 +109,86 @@
     {
       "SPDXID": "SPDXRef-resource-1",
       "name": "OSGeo/PROJ",
-      "downloadLocation": "git+https://github.com/OSGeo/PROJ@9.4.0",
+      "downloadLocation": "git+https://github.com/OSGeo/PROJ@9.4.1",
       "licenseConcluded": "NOASSERTION",
       "licenseDeclared": "NOASSERTION",
       "copyrightText": "NOASSERTION",
       "checksums": [
         {
           "algorithm": "SHA512",
-          "checksumValue": "5bc53723a81d9950599d6c47a837de5e9052aa56f943951e3ad0911cbeb71585bac648f37b9b626f32bb5d0b481ce5aef9be0833910e53b4b015b573808b8981"
+          "checksumValue": "4b3ceb9e3b2213b0bb2fc839f4dd70e08ee53323465c7bb473131907e4b66c836623da115c7413dfd8bafd0a992fa173003063e2233ab577139ab8462655b6cc"
         }
       ]
     }
   ],
   "files": [
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/remove_toolset_restriction.patch",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/usage",
       "SPDXID": "SPDXRef-file-0",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "25c1c986673bd539f5ec920684a08b38d0d37d9e24b6793e5b79dbd717bde04e"
+          "checksumValue": "26169363c27e71a44cba9d703b22bbd13c191ab5e2d0612b3dd35c735c971fe6"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/vcpkg.json",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-proj4-targets-cmake.patch",
       "SPDXID": "SPDXRef-file-1",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4"
+          "checksumValue": "d76e1d419d3367dda3381fd11a637f3465bc838d611fa8ceaca20048c1b3cd6e"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/usage",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-win-output-name.patch",
       "SPDXID": "SPDXRef-file-2",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "26169363c27e71a44cba9d703b22bbd13c191ab5e2d0612b3dd35c735c971fe6"
+          "checksumValue": "706e536cfe9a90c1b071ab5b00932fa96bb35c67fcb0f96c0fc4feb7c0b44011"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-win-output-name.patch",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/vcpkg.json",
       "SPDXID": "SPDXRef-file-3",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "706e536cfe9a90c1b071ab5b00932fa96bb35c67fcb0f96c0fc4feb7c0b44011"
+          "checksumValue": "0dbf128c799775bc808b756ed9800d1fd349f7d41b874ad78a204d17988b8737"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/portfile.cmake",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/remove_toolset_restriction.patch",
       "SPDXID": "SPDXRef-file-4",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d"
+          "checksumValue": "25c1c986673bd539f5ec920684a08b38d0d37d9e24b6793e5b79dbd717bde04e"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-proj4-targets-cmake.patch",
+      "fileName": ".//opt/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/portfile.cmake",
       "SPDXID": "SPDXRef-file-5",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "d76e1d419d3367dda3381fd11a637f3465bc838d611fa8ceaca20048c1b3cd6e"
+          "checksumValue": "c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f"
         }
       ],
       "licenseConcluded": "NOASSERTION",

pyogrio/proj_data/vcpkg_abi_info.txt

@@ -1,27 +1,27 @@
 cmake 0
-curl a4bb1e391f21be499648a3a0a32ee4f36324626dbf020b1dab1415568e114f9c
+curl cb695a5d1939ee33bf9626ce32269b0bd325a12e65a585a8e8f220190aa403f1
 features core;net;tiff
 fix-proj4-targets-cmake.patch d76e1d419d3367dda3381fd11a637f3465bc838d611fa8ceaca20048c1b3cd6e
 fix-win-output-name.patch 706e536cfe9a90c1b071ab5b00932fa96bb35c67fcb0f96c0fc4feb7c0b44011
-nlohmann-json 9494e51d107559a7e8b556eab74d802b962f02631e8dc1011a0fdf52d4735149
-portfile.cmake 58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d
-ports.cmake 0500e9e2422fe0084c99bdd0c9de4c7069b76da14c8b58228a7e95ebac43058a
+nlohmann-json 286a8ae48a6c0664d90e39c685703b5145fe035570cd7cb8708e7bb27a480c57
+portfile.cmake c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f
+ports.cmake 3581688c16865b2026d28240d7c6257b848475ffc9fe81b3f3d304973253cf5e
 post_build_checks 2
 remove_toolset_restriction.patch 25c1c986673bd539f5ec920684a08b38d0d37d9e24b6793e5b79dbd717bde04e
-sqlite3 666d04f1a5112d84de49a03ad7dcaf3ab9f8e63999848b489b78c68e5e9203c6
-sqlite3 fc728bd923a34a7b8be9b38b3ed152228a9bc12be18cc566db5e36174ddfed2f
-tiff 8b3b88e683e77b633f425d6bb45e77476c87b3408b705d50af225b521d37d0bd
+sqlite3 38ed2e302afc947869e2e6a9feadf92f4118676f6e9ff3b6813376d69ea02696
+sqlite3 5cf4f782306be81d95dc5d743f1a09f6d3d6397f80864b78f9e22043fac84c44
+tiff 1e5bca825c278accb4a2ec67a556f29e9e54e51ee0eca8f6cb9fa90c59841a99
 triplet arm64-linux-dynamic-release
-triplet_abi a2978ef94e01dd995e28fd3fc9d73a99d96cda95c172e0f1d199230f0e1bcdce-73c4f253fe835be7b4f68430dabc1102ae8e82e9ab34e9b6dbec047dc9b6447d-2ad07b68ec1acd5ddac23c4df04ffe712cc82a8d
+triplet_abi a2978ef94e01dd995e28fd3fc9d73a99d96cda95c172e0f1d199230f0e1bcdce-8f20f723a25e9787363b95fcfd14b63d82b71ac3e295a73c97d09e681decb90c-beb576496a66e76502336c0e436ebdaabe8d0f8f
 usage 26169363c27e71a44cba9d703b22bbd13c191ab5e2d0612b3dd35c735c971fe6
-vcpkg-cmake 61a6b5861674f41494b4ebae1f315674d62a4f6f2002093c13c2750ef3b2221e
-vcpkg-cmake-config 67c57a7501cf304cee2b318a14b5763968eb7ae54bc621edbe4ea197119243b6
-vcpkg.json d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4
+vcpkg-cmake 7cb9711415b0a62be2f6297fb548a28d18a5fe039a9101d49c2b6a6283540d2a
+vcpkg-cmake-config 0df4e1080d226918b032f77e7ee0fa68f7b71a3584576e68015d5289b3e229d0
+vcpkg.json 0dbf128c799775bc808b756ed9800d1fd349f7d41b874ad78a204d17988b8737
 vcpkg_check_features 943b217e0968d64cf2cb9c272608e6a0b497377e792034f819809a79e1502c2b
 vcpkg_copy_pdbs d57e4f196c82dc562a9968c6155073094513c31e2de475694143d3aa47954b1c
 vcpkg_copy_tools 3d45ff761bddbabe8923b52330168dc3abd295fa469d3f2e47cb14dce85332d5
-vcpkg_fixup_pkgconfig 904e67c46ecbb67379911bc1d7222855c0cbfcf1129bf47783858bcf0cc44970
+vcpkg_fixup_pkgconfig 1a15f6c6d8e2b244d83a7514a0412d339127d2217d1df60ad1388b546c85f777
 vcpkg_from_git 96ed81968f76354c00096dd8cd4e63c6a235fa969334a11ab18d11c0c512ff58
 vcpkg_from_github b743742296a114ea1b18ae99672e02f142c4eb2bef7f57d36c038bedbfb0502f
 vcpkg_list f5de3ebcbc40a4db90622ade9aca918e2cf404dc0d91342fcde457d730e6fa29
-vcpkg_replace_string d43c8699ce27e25d47367c970d1c546f6bc36b6df8fb0be0c3986eb5830bd4f1
+vcpkg_replace_string b450deb79207478b37119743e00808ebc42de0628e7b98c14ab24728bd5c78b8

pyogrio/raw.py

@@ -1,8 +1,11 @@
-from io import BytesIO
+"""Low level functions to read and write OGR data sources."""
+
 import warnings
+from io import BytesIO
+from pathlib import Path
 
-from pyogrio._env import GDALEnv
 from pyogrio._compat import HAS_ARROW_API, HAS_ARROW_WRITE_API, HAS_PYARROW
+from pyogrio._env import GDALEnv
 from pyogrio.core import detect_write_driver
 from pyogrio.errors import DataSourceError
 from pyogrio.util import (
@@ -18,8 +21,8 @@ with GDALEnv():
         _get_driver_metadata_item,
         get_gdal_version,
         get_gdal_version_string,
-        ogr_driver_supports_write,
         ogr_driver_supports_vsi,
+        ogr_driver_supports_write,
     )
 
 
@@ -61,7 +64,7 @@ def read(
     Parameters
     ----------
     path_or_buffer : pathlib.Path or str, or bytes buffer
-        A dataset path or URI, or raw buffer.
+        A dataset path or URI, raw buffer, or file-like object with a read method.
     layer : int or str, optional (default: first layer)
         If an integer is provided, it corresponds to the index of the layer
         with the data source.  If a string is provided, it must match the name
@@ -190,7 +193,6 @@ def read(
         https://www.gaia-gis.it/gaia-sins/spatialite-sql-latest.html
 
     """
-
     dataset_kwargs = _preprocess_options_key_value(kwargs) if kwargs else {}
 
     return ogr_read(
@@ -233,8 +235,7 @@ def read_arrow(
     return_fids=False,
     **kwargs,
 ):
-    """
-    Read OGR data source into a pyarrow Table.
+    """Read OGR data source into a pyarrow Table.
 
     See docstring of `read` for parameters.
 
@@ -252,6 +253,7 @@ def read_arrow(
             "geometry_type": "<geometry_type>",
             "geometry_name": "<name of geometry column in arrow table>",
         }
+
     """
     if not HAS_PYARROW:
         raise RuntimeError(
@@ -358,8 +360,7 @@ def open_arrow(
     use_pyarrow=False,
     **kwargs,
 ):
-    """
-    Open OGR data source as a stream of Arrow record batches.
+    """Open OGR data source as a stream of Arrow record batches.
 
     See docstring of `read` for parameters.
 
@@ -388,7 +389,6 @@ def open_arrow(
 
     Examples
     --------
-
     >>> from pyogrio.raw import open_arrow
     >>> import pyarrow as pa
     >>> import shapely
@@ -397,8 +397,9 @@ def open_arrow(
     >>>     meta, stream = source
     >>>     # wrap the arrow stream object in a pyarrow RecordBatchReader
     >>>     reader = pa.RecordBatchReader.from_stream(stream)
+    >>>     geom_col = meta["geometry_name"] or "wkb_geometry"
     >>>     for batch in reader:
-    >>>         geometries = shapely.from_wkb(batch[meta["geometry_name"] or "wkb_geometry"])
+    >>>         geometries = shapely.from_wkb(batch[geom_col])
 
     The returned `stream` object needs to be consumed by a library implementing
     the Arrow PyCapsule Protocol. In the above example, pyarrow is used through
@@ -407,8 +408,9 @@ def open_arrow(
 
     >>> with open_arrow(path, use_pyarrow=True) as source:
     >>>     meta, reader = source
+    >>>     geom_col = meta["geometry_name"] or "wkb_geometry"
     >>>     for batch in reader:
-    >>>         geometries = shapely.from_wkb(batch[meta["geometry_name"] or "wkb_geometry"])
+    >>>         geometries = shapely.from_wkb(batch[geom_col])
 
     Returns
     -------
@@ -425,6 +427,7 @@ def open_arrow(
             "geometry_type": "<geometry_type>",
             "geometry_name": "<name of geometry column in arrow table>",
         }
+
     """
     if not HAS_ARROW_API:
         raise RuntimeError("GDAL>= 3.6 required to read using arrow")
@@ -454,7 +457,7 @@ def open_arrow(
 
 
 def _parse_options_names(xml):
-    """Convert metadata xml to list of names"""
+    """Convert metadata xml to list of names."""
     # Based on Fiona's meta.py
     # (https://github.com/Toblerity/Fiona/blob/91c13ad8424641557a4e5f038f255f9b657b1bc5/fiona/meta.py)
     import xml.etree.ElementTree as ET
@@ -471,29 +474,27 @@ def _parse_options_names(xml):
 
 
 def _validate_metadata(dataset_metadata, layer_metadata, metadata):
-    """ """
+    """Validate the metadata."""
     if metadata is not None:
         if layer_metadata is not None:
             raise ValueError("Cannot pass both metadata and layer_metadata")
         layer_metadata = metadata
 
     # validate metadata types
-    for metadata in [dataset_metadata, layer_metadata]:
-        if metadata is not None:
-            for k, v in metadata.items():
+    for meta in [dataset_metadata, layer_metadata]:
+        if meta is not None:
+            for k, v in meta.items():
                 if not isinstance(k, str):
                     raise ValueError(f"metadata key {k} must be a string")
 
                 if not isinstance(v, str):
                     raise ValueError(f"metadata value {v} must be a string")
+
     return dataset_metadata, layer_metadata
 
 
 def _preprocess_options_kwargs(driver, dataset_options, layer_options, kwargs):
-    """
-    Preprocess kwargs and split in dataset and layer creation options.
-    """
-
+    """Preprocess kwargs and split in dataset and layer creation options."""
     dataset_kwargs = _preprocess_options_key_value(dataset_options or {})
     layer_kwargs = _preprocess_options_key_value(layer_options or {})
     if kwargs:
@@ -516,13 +517,14 @@ def _preprocess_options_kwargs(driver, dataset_options, layer_options, kwargs):
 
 
 def _get_write_path_driver(path, driver, append=False):
-    """Validate and return path and driver
+    """Validate and return path and driver.
 
     Parameters
     ----------
     path : str or io.BytesIO
         path to output file on writeable file system or an io.BytesIO object to
-        allow writing to memory
+        allow writing to memory.  Will raise NotImplementedError if an open file
+        handle is passed.
     driver : str, optional (default: None)
         The OGR format driver used to write the vector file. By default attempts
         to infer driver from path.  Must be provided to write to a file-like
@@ -533,8 +535,8 @@ def _get_write_path_driver(path, driver, append=False):
     Returns
     -------
     (path, driver)
-    """
 
+    """
     if isinstance(path, BytesIO):
         if driver is None:
             raise ValueError("driver must be provided to write to in-memory file")
@@ -554,8 +556,14 @@ def _get_write_path_driver(path, driver, append=False):
         if append:
             raise NotImplementedError("append is not supported for in-memory files")
 
+    elif hasattr(path, "write") and not isinstance(path, Path):
+        raise NotImplementedError(
+            "writing to an open file handle is not yet supported; instead, write to a "
+            "BytesIO instance and then read bytes from that to write to the file handle"
+        )
+
     else:
-        path = vsi_path(str(path))
+        path = vsi_path(path)
 
         if driver is None:
             driver = detect_write_driver(path)
@@ -605,7 +613,8 @@ def write(
     ----------
     path : str or io.BytesIO
         path to output file on writeable file system or an io.BytesIO object to
-        allow writing to memory
+        allow writing to memory.  Will raise NotImplementedError if an open file
+        handle is passed; use BytesIO instead.
         NOTE: support for writing to memory is limited to specific drivers.
     geometry : ndarray of WKB encoded geometries or None
         If None, geometries will not be written to output file
@@ -677,6 +686,10 @@ def write(
         a key-value dictionary.
     gdal_tz_offsets : dict, optional (default: None)
         Used to handle GDAL timezone offsets for each field contained in dict.
+    **kwargs
+        Additional driver-specific dataset creation options passed to OGR. Invalid
+        options will trigger a warning.
+
     """
     # if dtypes is given, remove it from kwargs (dtypes is included in meta returned by
     # read, and it is convenient to pass meta directly into write for round trip tests)
@@ -698,7 +711,8 @@ def write(
         warnings.warn(
             "'crs' was not provided.  The output dataset will not have "
             "projection information defined and may not be usable in other "
-            "systems."
+            "systems.",
+            stacklevel=2,
         )
 
     # preprocess kwargs and split in dataset and layer creation options
@@ -745,8 +759,7 @@ def write_arrow(
     layer_options=None,
     **kwargs,
 ):
-    """
-    Write an Arrow-compatible data source to an OGR file format.
+    """Write an Arrow-compatible data source to an OGR file format.
 
     .. _Arrow PyCapsule Protocol: https://arrow.apache.org/docs/format/CDataInterface/PyCapsuleInterface.html
 
@@ -782,6 +795,8 @@ def write_arrow(
         type of the output file to this value. Use this parameter with caution because
         using a wrong layer geometry type may result in errors when writing the
         file, may be ignored by the driver, or may result in invalid files.
+    crs : str, optional (default: None)
+        WKT-encoded CRS of the geometries to be written.
     encoding : str, optional (default: None)
         Only used for the .dbf file of ESRI Shapefiles. If not specified,
         uses the default locale.
@@ -842,7 +857,8 @@ def write_arrow(
             warnings.warn(
                 "'crs' was not provided.  The output dataset will not have "
                 "projection information defined and may not be usable in other "
-                "systems."
+                "systems.",
+                stacklevel=2,
             )
 
     dataset_metadata, layer_metadata = _validate_metadata(