feat(python): Improve Python GeoParquet docs, add tests, fix some bugs (#1210)

For #1175

Closes #981

Author: kylebarron

python/docs/api/core/functions.md

@@ -7,24 +7,19 @@ Interoperability with other Python geospatial libraries (Shapely, GeoPandas) and
       filters:
         - "!^_"
       members:
-        - read_pyogrio
-        - from_geopandas
-        - from_shapely
         - from_wkb
         - from_wkt
-        - to_geopandas
-        - to_shapely
         - to_wkb
         - to_wkt
 
-## Table functions
+<!-- ## Table functions
 
 ::: geoarrow.rust.core
     options:
       filters:
         - "!^_"
       members:
-        - geometry_col
+        - geometry_col -->
 
 ## CRS Access
 

python/docs/api/core/index.md

@@ -1,7 +1,5 @@
 # `geoarrow.rust.core`
 
-Root for `geoarrow.rust.core` API docs.
-
 All functionality described within this directory are part of the `geoarrow.rust.core` submodule. To use, install the `geoarrow-rust-core` PyPI package:
 
 ```

python/docs/api/io/csv.md renamed to python/docs/api/io/csv.md.bak

@@ -2,9 +2,4 @@
 
 GDAL natively supports reading data from any vector driver as GeoArrow data, and natively supports writing data to any vector driver from GeoArrow data.
 
-For reading and writing you have two options:
-
-- You can use [`pyogrio`'s Arrow integration](https://pyogrio.readthedocs.io/en/latest/api.html#arrow-integration) directly
-- You can use the [`geoarrow.rust.core.read_pyogrio`][] wrapper.
-
-    This calls `pyogrio` under the hood (and requires that `pyogrio` is installed). The wrapper lives in `geoarrow.rust.core` because it has no dependency on any Rust IO code.
+For reading and writing, use [`pyogrio`'s Arrow integration](https://pyogrio.readthedocs.io/en/latest/api.html#arrow-integration) directly, which supports WKB-encoded GeoArrow data.

python/docs/api/io/flatgeobuf.md renamed to python/docs/api/io/flatgeobuf.md.bak

@@ -2,11 +2,9 @@
 
 Read and write [GeoParquet](https://geoparquet.org/) files.
 
-::: geoarrow.rust.io.read_parquet
-::: geoarrow.rust.io.read_parquet_async
-::: geoarrow.rust.io.write_parquet
 ::: geoarrow.rust.io.GeoParquetDataset
 ::: geoarrow.rust.io.GeoParquetFile
 ::: geoarrow.rust.io.GeoParquetWriter
 ::: geoarrow.rust.io.enums.GeoParquetEncoding
 ::: geoarrow.rust.io.types.GeoParquetEncodingT
+::: geoarrow.rust.io.PathInput

python/docs/api/io/gdal.md

@@ -0,0 +1,7 @@
+# `geoarrow.rust.io`
+
+All functionality described within this directory are part of the `geoarrow.rust.io` submodule. To use, install the `geoarrow-rust-io` PyPI package:
+
+```
+pip install geoarrow-rust-io
+```