Use zstd with compression 15 by default (#16)

* Use zstd with compression 15 by default, fixes #12

* Update vecorel_cli/cli/options.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Matthias Mohr <matthias@mohr.ws>
Co-authored-by: Matthias Mohr <webmaster@mamo-net.de>
Co-authored-by: Matthias Mohr <m.mohr@moregeo.it>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

CHANGELOG.md

@@ -8,6 +8,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ## [Unreleased]
 
 - Replace flatdict from pypi with a local version to avoid pkg_resource install issues
+- Change default compression to zstd
+- Add option to set compression level, zstd defaults to 15
 
 ## [v0.2.12] - 2025-12-08
 

vecorel_cli/cli/options.py

@@ -31,7 +31,16 @@ def CRS(default_value):
     type=click.Choice(COMPRESSION_METHODS),
     help="GeoParquet only: Compression method",
     show_default=True,
-    default="brotli",
+    default="zstd",
+)
+
+GEOPARQUET_COMPRESSION_LEVEL = click.option(
+    "--compression_level",
+    "-pcl",
+    type=click.IntRange(min=1, max=22),
+    help="GeoParquet only: Compression level",
+    show_default=True,
+    default=None,
 )
 
 GEOPARQUET_VERSION = click.option(

vecorel_cli/conversion/base.py

@@ -298,6 +298,7 @@ def convert(
         input_files=None,
         variant=None,
         compression=None,
+        compression_level: Optional[int] = None,
         geoparquet_version=None,
         original_geometries=False,
         **kwargs,
@@ -425,6 +426,7 @@ def convert(
             gdf,
             properties=columns,
             compression=compression,
+            compression_level=compression_level,
             geoparquet_version=geoparquet_version,
         )
 

vecorel_cli/convert.py

@@ -1,7 +1,13 @@
 import click
 
 from .basecommand import BaseCommand, runnable
-from .cli.options import GEOPARQUET_COMPRESSION, GEOPARQUET_VERSION, PY_PACKAGE, VECOREL_TARGET
+from .cli.options import (
+    GEOPARQUET_COMPRESSION,
+    GEOPARQUET_COMPRESSION_LEVEL,
+    GEOPARQUET_VERSION,
+    PY_PACKAGE,
+    VECOREL_TARGET,
+)
 from .cli.util import parse_converter_input_files
 from .converters import Converters
 from .registry import Registry
@@ -61,6 +67,7 @@ def get_cli_args():
                 default=None,
             ),
             "compression": GEOPARQUET_COMPRESSION,
+            "compression_level": GEOPARQUET_COMPRESSION_LEVEL,
             "geoparquet_version": GEOPARQUET_VERSION,
             "mapping_file": click.option(
                 "--mapping-file",

vecorel_cli/encoding/geoparquet.py

@@ -131,22 +131,22 @@ def get_compression(self) -> Optional[str]:
     # geoparquet_version: bool, optional, default False
     #     If True, writes the data in GeoParquet 1.0.0 format,
     #     otherwise in GeoParquet 1.1.0 format.
-    # compression: str, optional, default "brotli"
-    #     Compression algorithm to use, defaults to "brotli".
-    #     Other options are "snappy", "gzip", "lz4", "zstd", etc.
+    # compression: str, optional, default "zstd"
+    #     Compression algorithm to use, defaults to "zstd".
+    #     Other options are "snappy", "gzip", "lz4", "brotli", etc.
     def write(
         self,
         data: GeoDataFrame,
         properties: Optional[list[str]] = None,
         schema_map: SchemaMapping = {},
         dehydrate: bool = True,
-        compression: Optional[str] = None,
+        compression: Optional[str] = "zstd",
+        compression_level: Optional[int] = None,  # default level for compression
         geoparquet_version: Optional[str] = None,
         **kwargs,  # capture unknown arguments
     ) -> bool:
-        if compression is None:
-            compression = "brotli"
-
+        if compression == "zstd" and compression_level is None:
+            compression_level = 15
         if geoparquet_version not in GEOPARQUET_VERSIONS:
             geoparquet_version = GEOPARQUET_DEFAULT_VERSION
         self.uri.parent.mkdir(parents=True, exist_ok=True)
@@ -240,9 +240,6 @@ def write(
             }
         )
 
-        if compression is None:
-            compression = "brotli"
-
         # Write the data to the Parquet file
         to_parquet(
             data,
@@ -254,6 +251,7 @@ def write(
             schema_version=geoparquet_version,
             row_group_size=self.row_group_size,
             write_covering_bbox=bool(geoparquet_version != "1.0.0"),
+            compression_level=compression_level,
         )
 
         return True