pyogrio 0.9.0__cp39-cp39-macosx_12_0_arm64.whl → 0.10.0__cp39-cp39-macosx_12_0_arm64.whl

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-osx-dynamic-release-9.4.0-ec398e5d-1049-4f2d-9822-3a705d082dc0",
-  "name": "proj:arm64-osx-dynamic-release@9.4.0 da6388a3ef86d20dc670914122fe4a63d2fe8c66fdbffae2d8ceb037931218a5",
+  "documentNamespace": "https://spdx.org/spdxdocs/proj-arm64-osx-dynamic-release-9.4.1-047a3640-b96f-4c86-a313-8637bf707d53",
+  "name": "proj:arm64-osx-dynamic-release@9.4.1 5a1a7dbeacb3aebc73b4e1bf072017a71cdf2af83ef1752e80eaa7edbe646441",
   "creationInfo": {
     "creators": [
-      "Tool: vcpkg-d6945642ee5c3076addd1a42c331bbf4cfc97457"
+      "Tool: vcpkg-2024-08-01-fd884a0d390d12783076341bd43d77c3a6a15658"
     ],
-    "created": "2024-06-10T17:01:57Z"
+    "created": "2024-09-28T18:34:28Z"
   },
   "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-osx-dynamic-release",
       "SPDXID": "SPDXRef-binary",
-      "versionInfo": "da6388a3ef86d20dc670914122fe4a63d2fe8c66fdbffae2d8ceb037931218a5",
+      "versionInfo": "5a1a7dbeacb3aebc73b4e1bf072017a71cdf2af83ef1752e80eaa7edbe646441",
       "downloadLocation": "NONE",
       "licenseConcluded": "MIT",
       "licenseDeclared": "NOASSERTION",
@@ -109,21 +109,21 @@
     {
       "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": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/usage",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/usage",
       "SPDXID": "SPDXRef-file-0",
       "checksums": [
         {
@@ -135,31 +135,31 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/portfile.cmake",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/portfile.cmake",
       "SPDXID": "SPDXRef-file-1",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d"
+          "checksumValue": "c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/vcpkg.json",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/vcpkg.json",
       "SPDXID": "SPDXRef-file-2",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4"
+          "checksumValue": "0dbf128c799775bc808b756ed9800d1fd349f7d41b874ad78a204d17988b8737"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/remove_toolset_restriction.patch",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/remove_toolset_restriction.patch",
       "SPDXID": "SPDXRef-file-3",
       "checksums": [
         {
@@ -171,7 +171,7 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-proj4-targets-cmake.patch",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-proj4-targets-cmake.patch",
       "SPDXID": "SPDXRef-file-4",
       "checksums": [
         {
@@ -183,7 +183,7 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-win-output-name.patch",
+      "fileName": ".//usr/local/share/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-win-output-name.patch",
       "SPDXID": "SPDXRef-file-5",
       "checksums": [
         {

pyogrio/proj_data/vcpkg_abi_info.txt

@@ -1,27 +1,27 @@
-cmake 3.29.3
-curl 2add7a3b448fe6b0bf867a8354c0f1fa79e6049a11d1053f698a66a965f77ff4
+cmake 3.30.3
+curl b05d6dda7ca5aee75b6212c53fa145da50c7a3d88850f9566e5368bc4a6e4964
 features core;net;tiff
 fix-proj4-targets-cmake.patch d76e1d419d3367dda3381fd11a637f3465bc838d611fa8ceaca20048c1b3cd6e
 fix-win-output-name.patch 706e536cfe9a90c1b071ab5b00932fa96bb35c67fcb0f96c0fc4feb7c0b44011
-nlohmann-json 16ccf1d0a002391d731f28e3c61b302ef43ad42cc0fab50d09da068056512578
-portfile.cmake 58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d
-ports.cmake 0500e9e2422fe0084c99bdd0c9de4c7069b76da14c8b58228a7e95ebac43058a
+nlohmann-json 691504cb5513bab1e734af87684f69c71ffa2145c169c2717bfa907e53ec0038
+portfile.cmake c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f
+ports.cmake 3581688c16865b2026d28240d7c6257b848475ffc9fe81b3f3d304973253cf5e
 post_build_checks 2
 remove_toolset_restriction.patch 25c1c986673bd539f5ec920684a08b38d0d37d9e24b6793e5b79dbd717bde04e
-sqlite3 2f9ad09fd24b6b39217bc2fe3e4a7c7dacb02c8beaaac7d314b1335e579bb0d5
-sqlite3 664423578924aaba4beb2e4b03b82cbbc78e485f20ceef23ff0b19c5bf16a7ae
-tiff 555062d07bdd54cfcc1d09a94185719b6c434e092290b72378006f266192752b
+sqlite3 7088305e8e220bd88e68b7b65aa8a89b317a74364a2f5b3d16897d279f408b2c
+sqlite3 b63bfad8731cd4015fe628d6930a7d981e8bd2dc5e22338787e32d3c8aeefcf0
+tiff 6bee7e85690e39fd12d59b13d904e5c2ccc33f22668daa83bcaa8d1ec9bb3ae9
 triplet arm64-osx-dynamic-release
-triplet_abi bfb2f1a725a6c7d4c5a71c9867dbce26242b53ad1005a453f934440a490c77ba-a654e5c1a635cb784f3168426c422995eefe31912588726942497566a5bca495-5f75c9acc02e05029cedb7eca90c49644cc3a77a
+triplet_abi bfb2f1a725a6c7d4c5a71c9867dbce26242b53ad1005a453f934440a490c77ba-4cdbc0a68d47eedc16d246a07a21fabfbbe19abb89f00890c58902e2cf872d6f-5f75c9acc02e05029cedb7eca90c49644cc3a77a
 usage 26169363c27e71a44cba9d703b22bbd13c191ab5e2d0612b3dd35c735c971fe6
-vcpkg-cmake 0a26d48713a5847cab34bf40b6f6e0534b98af1b9ee4fc1c0397d96f3bf33f9c
-vcpkg-cmake-config 934e27de6b7820c88fbb9c24cf9de8cd035862096fa9214a969638a5f1236364
-vcpkg.json d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4
+vcpkg-cmake c8f1bf76f78dee8ca0d9884a6918cf0ec11c1abe045fd9bca2f9ae44af917e05
+vcpkg-cmake-config dc22b69eeb823c856b78701093a239737a86039d6e913df4a326bd163f23f9f3
+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(