pyogrio 0.9.0__cp39-cp39-win_amd64.whl → 0.10.0__cp39-cp39-win_amd64.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-x64-windows-dynamic-release-9.4.0-daacbcc8-9226-41de-9883-fbe8ff1c19b2",
-  "name": "proj:x64-windows-dynamic-release@9.4.0 516fa62b68e81f38b2aa8da0bb1252756e2fe2ca50e4bcfc768ed71aaf477468",
+  "documentNamespace": "https://spdx.org/spdxdocs/proj-x64-windows-dynamic-release-9.4.1-095f755e-004d-4a27-9645-4fbfcf353ec5",
+  "name": "proj:x64-windows-dynamic-release@9.4.1 3221250292d4cd48d645445f204396e392ced5a9f49a37c6db6c1d43e529dde7",
   "creationInfo": {
     "creators": [
-      "Tool: vcpkg-d6945642ee5c3076addd1a42c331bbf4cfc97457"
+      "Tool: vcpkg-2024-08-01-fd884a0d390d12783076341bd43d77c3a6a15658"
     ],
-    "created": "2024-06-17T19:46:20Z"
+    "created": "2024-09-05T06:36:23Z"
   },
   "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:x64-windows-dynamic-release",
       "SPDXID": "SPDXRef-binary",
-      "versionInfo": "516fa62b68e81f38b2aa8da0bb1252756e2fe2ca50e4bcfc768ed71aaf477468",
+      "versionInfo": "3221250292d4cd48d645445f204396e392ced5a9f49a37c6db6c1d43e529dde7",
       "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": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-proj4-targets-cmake.patch",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-proj4-targets-cmake.patch",
       "SPDXID": "SPDXRef-file-0",
       "checksums": [
         {
@@ -135,7 +135,7 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/fix-win-output-name.patch",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/fix-win-output-name.patch",
       "SPDXID": "SPDXRef-file-1",
       "checksums": [
         {
@@ -147,19 +147,19 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/portfile.cmake",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/portfile.cmake",
       "SPDXID": "SPDXRef-file-2",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d"
+          "checksumValue": "c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f"
         }
       ],
       "licenseConcluded": "NOASSERTION",
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/remove_toolset_restriction.patch",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/remove_toolset_restriction.patch",
       "SPDXID": "SPDXRef-file-3",
       "checksums": [
         {
@@ -171,7 +171,7 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/usage",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/usage",
       "SPDXID": "SPDXRef-file-4",
       "checksums": [
         {
@@ -183,12 +183,12 @@
       "copyrightText": "NOASSERTION"
     },
     {
-      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/62e9ace469641b907291184ebc7e76d96f629881/vcpkg.json",
+      "fileName": "./C:/vcpkg/buildtrees/versioning_/versions/proj/dafa38417689eb52c17a425ace8e1f3ecfb74045/vcpkg.json",
       "SPDXID": "SPDXRef-file-5",
       "checksums": [
         {
           "algorithm": "SHA256",
-          "checksumValue": "d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4"
+          "checksumValue": "0dbf128c799775bc808b756ed9800d1fd349f7d41b874ad78a204d17988b8737"
         }
       ],
       "licenseConcluded": "NOASSERTION",

pyogrio/proj_data/vcpkg_abi_info.txt

@@ -1,28 +1,28 @@
-cmake 3.29.5
-curl 6a9f6535d0371ecc5300df22e045bc77397b1b9fa38595d0b422c548ef9b9a5f
+cmake 3.30.3
+curl fa497fcd4e5d3fd8f58bfa8f9006baaa188e5c93e8b79f9b5126abb4f495f28f
 features core;net;tiff
 fix-proj4-targets-cmake.patch d76e1d419d3367dda3381fd11a637f3465bc838d611fa8ceaca20048c1b3cd6e
 fix-win-output-name.patch 706e536cfe9a90c1b071ab5b00932fa96bb35c67fcb0f96c0fc4feb7c0b44011
-nlohmann-json 95fd97ffd2d90f42a00b57d6237e236f378adb7969ee808866e85439e0e522ca
-portfile.cmake 58b4048cfc81891c1e32e41bc00b52ea7ae2821bd577b46ab63d2c962ef8747d
-ports.cmake 0500e9e2422fe0084c99bdd0c9de4c7069b76da14c8b58228a7e95ebac43058a
+nlohmann-json 1992b817b1214344e17bd46e22e4498057511c321df06607a03b40ba70ad0ec9
+portfile.cmake c1e2909ff16c46a449fbb7e71e14ea3d33103491f21ce5191d899cafded1822f
+ports.cmake 3581688c16865b2026d28240d7c6257b848475ffc9fe81b3f3d304973253cf5e
 post_build_checks 2
-powershell 7.4.2
+powershell 7.4.5
 remove_toolset_restriction.patch 25c1c986673bd539f5ec920684a08b38d0d37d9e24b6793e5b79dbd717bde04e
-sqlite3 0ea00a282f5b99592dd974e790033e3709e3273da3ffc774f8db4fbe4f342f9c
-sqlite3 2753e40c21e926994e46e96f4ddf3cd0dc446c8e5fe4a5d6ba4c865827a6849c
-tiff ffa4985cd425743272cac47070bf68ec92b8919d8deeb849fb8e7bd7ec242df9
+sqlite3 84e61031efc3524e589d914a2c94f365f4f4f144a9d91540a855cd6fda40f8ec
+sqlite3 ffb3c277bdd19d8191a04558135a4e193077986db6a5c6a2fdd2a0baa5dbfddb
+tiff 425dab9735e21a8cdea7696a65aada4e50bd6bb50c496df903d548c2fb92c7cc
 triplet x64-windows-dynamic-release
-triplet_abi 36210185afbd528d6d7303808480ab7d54f062730bbef9fc1603f69b72ca549a-e36df1c7f50ab25f9c182fa927d06c19ae082e0d599f132b3f655784b49e4b33-3361a17d8afbd07b0f5c7f4dac4bd892b23a29d3
+triplet_abi 36210185afbd528d6d7303808480ab7d54f062730bbef9fc1603f69b72ca549a-35332a22d6cb1309b1967c1f42a8f3c0ff58fec1939f84bb1deef16946b27c77-3361a17d8afbd07b0f5c7f4dac4bd892b23a29d3
 usage 26169363c27e71a44cba9d703b22bbd13c191ab5e2d0612b3dd35c735c971fe6
-vcpkg-cmake fa107b73894bb46b2c72b30466a3255d25400d5579640cabf6665ac44176d095
-vcpkg-cmake-config 5a8514250466c9d2b68d50c2037242af99e55bd8fabcd47e0f10562bb3e69683
-vcpkg.json d31d1d3beb5ef0890e4b5db1ee5b72a925a58aa53bfaee688d4b5af1cea2bba4
+vcpkg-cmake 12907141e9d55701694a88fd0cf5a014cb0ac18de8e6298f393fe85d9d6b2082
+vcpkg-cmake-config 353dcf000b6eb17d159df15cc49bf4035aaf38f785d32fb5774689f0dc44f341
+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(