Release v0.1.1 - OGC GeoParquet compliance

This release fixes a critical issue where the package was producing invalid
GeoParquet files that couldn't be read by standard geospatial tools.

Major changes:
- Complete rewrite to produce OGC GeoParquet v1.0.0 compliant files
- Added GeoPandas dependency for proper GeoParquet generation
- Geometry now stored as WKB (binary) instead of WKT (text)
- CRS information properly preserved in geo metadata
- Removed legacy EnhancedGDBConverter entirely
- All output files can now be read by GeoPandas, DuckDB Spatial, QGIS, etc.

Breaking changes:
- Removed use_legacy_converter parameter (all output is now GeoParquet)
- GDBConverter is now an alias for GeoParquetConverter

This ensures full interoperability with the geospatial ecosystem and
follows the official GeoParquet specification.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: mihiarc

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to the ESRI Converter project will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2025-06-22
+
+### Added
+- **OGC GeoParquet Compliance**: Now produces valid GeoParquet files according to the OGC GeoParquet v1.0.0 specification
+- New `GeoParquetConverter` class replacing the old non-compliant converter
+- GeoPandas dependency for proper GeoParquet generation
+- Verification scripts for testing GeoParquet compliance
+
+### Changed
+- Complete rewrite of the converter to produce OGC-compliant GeoParquet files
+- Geometry storage changed from WKT text to WKB binary format
+- CRS information is now properly preserved in geo metadata
+- Updated documentation to reflect GeoParquet compliance
+
+### Removed
+- Legacy `EnhancedGDBConverter` that produced non-standard parquet files
+- `use_legacy_converter` parameter (all output is now GeoParquet compliant)
+
+### Fixed
+- Output files can now be read by standard GeoParquet readers (GeoPandas, DuckDB Spatial, QGIS, etc.)
+- Added required geo metadata to parquet file headers
+- Geometry data now stored in standard `geometry` column
+- Fixed interoperability with the broader geospatial ecosystem
+
 ## [0.1.0] - 2025-01-28
 
 ### Added

CLAUDE.md

@@ -0,0 +1,116 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+ESRI Converter is a modern Python package for converting ESRI Geodatabase (GDB) files to OGC-compliant GeoParquet format. Built for 2025 with performance and developer experience in mind, using GeoPandas, Polars, Rich, PyArrow, Fiona, and Shapely. The package now produces valid GeoParquet files that can be read by all standard geospatial tools.
+
+## Key Commands
+
+### Development Setup
+```bash
+# Create and activate virtual environment
+uv venv
+source .venv/bin/activate
+
+# Install in development mode
+uv pip install -e ".[dev]"    # Development dependencies
+uv pip install -e ".[all]"    # All optional dependencies
+```
+
+### Code Quality
+```bash
+# Format code
+uv run black esri_converter/
+
+# Lint code
+uv run ruff check esri_converter/
+
+# Type check
+uv run mypy esri_converter/
+
+# Run tests (when implemented)
+uv run pytest
+uv run pytest --cov=esri_converter
+```
+
+### Documentation
+```bash
+# Install docs dependencies
+python scripts/docs.py install
+
+# Serve docs locally (http://127.0.0.1:8000)
+python scripts/docs.py serve
+
+# Build documentation
+python scripts/docs.py build
+```
+
+### Publishing
+```bash
+# Full test publish workflow
+python scripts/publish.py full-test
+
+# Full live publish workflow (requires PYPI_LIVE_TOKEN)
+python scripts/publish.py full-live
+```
+
+## Architecture Overview
+
+### Module Structure
+```
+esri_converter/
+├── __init__.py                  # Public API exports
+├── api.py                      # High-level conversion functions
+├── exceptions.py               # Custom exception hierarchy
+├── converters/                 # Core conversion engines
+│   └── geoparquet_converter.py # GeoParquetConverter (OGC-compliant output)
+└── utils/              
+    ├── formats.py              # Format information and recommendations
+    └── validation.py           # Input validation functions
+```
+
+### Core API Functions
+- `convert_gdb_to_parquet()` - Single GDB conversion with detailed metrics
+- `convert_multiple_gdbs()` - Batch conversion with aggregate results
+- `discover_gdb_files()` - Find GDB files in directories
+- `get_gdb_info()` - Non-destructive GDB inspection
+
+### Key Design Patterns
+1. **Streaming Architecture**: Chunk-based processing for large datasets (default: 15,000 records/chunk)
+2. **Rich UI Integration**: Beautiful console output with progress bars, tables, and trees
+3. **Comprehensive Error Handling**: Custom exception hierarchy with context preservation
+4. **Lazy Evaluation**: Uses Polars for memory-efficient operations
+
+### Exception Hierarchy
+```
+ESRIConverterError
+├── UnsupportedFormatError
+├── ValidationError
+├── ConversionError
+│   ├── SchemaError
+│   └── MemoryError
+└── FileAccessError
+```
+
+## Development Notes
+
+1. **Python Version**: Requires Python 3.10+
+2. **Package Manager**: Always use `uv` for Python operations
+3. **Testing**: Currently no unit tests - test scripts exist but formal test suite needs implementation
+4. **Type Safety**: Project uses strict mypy configuration
+5. **Code Style**: Ruff for linting and formatting with 100-character line length
+6. **Main Converter**: `GeoParquetConverter` (aliased as `GDBConverter` for compatibility)
+7. **Default Output**: Creates "geoparquet_output" directory if not specified
+
+## Important Considerations
+
+- The CLI is commented out in v0.1.0 - focus is on Python API
+- GDAL warnings are suppressed for cleaner output
+- Schema normalization handles inconsistent field types across chunks
+- Memory-efficient processing adapts based on dataset characteristics
+- Rich console output provides detailed progress and performance metrics
+- **GeoParquet Compliance**: All output files are OGC GeoParquet v1.0.0 compliant
+- **GeoPandas Dependency**: Required for proper GeoParquet output with WKB geometry storage
+- **Geometry Storage**: Uses WKB (Well-Known Binary) format for optimal performance

README.md

@@ -4,8 +4,9 @@ Modern tools for converting ESRI proprietary formats to open source formats. Bui
 
 ## 🚀 Features
 
+- **OGC GeoParquet Compliant**: Produces valid GeoParquet files readable by all standard tools
 - **Large-Scale Processing**: Handle multi-GB GDB files with streaming and chunking
-- **Modern Stack**: Built with Polars, Rich, and PyArrow for maximum performance
+- **Modern Stack**: Built with GeoPandas, Polars, Rich, and PyArrow for maximum performance
 - **Beautiful UI**: Rich progress bars, tables, and visual feedback
 - **Memory Efficient**: Process datasets larger than available RAM
 - **Robust Error Handling**: Comprehensive validation and error recovery
@@ -28,7 +29,7 @@ pip install esri-converter[duckdb,dev]
 ## 🔧 Requirements
 
 - Python 3.10+
-- Modern dependencies: Polars, Rich, Fiona, PyArrow, Shapely
+- Modern dependencies: GeoPandas, Polars, Rich, Fiona, PyArrow, Shapely
 
 ## 🎯 Quick Start
 
@@ -37,10 +38,15 @@ pip install esri-converter[duckdb,dev]
 ```python
 from esri_converter.api import convert_gdb_to_parquet
 
-# Convert a single GDB file
+# Convert a single GDB file to OGC-compliant GeoParquet
 result = convert_gdb_to_parquet("data.gdb")
 print(f"Converted {result['total_records']:,} records")
 print(f"Output size: {result['output_size_mb']:.1f} MB")
+
+# The output files are valid GeoParquet files that can be read by:
+# - GeoPandas: gpd.read_parquet("output.parquet")
+# - DuckDB Spatial: SELECT * FROM 'output.parquet'
+# - QGIS, ArcGIS Pro, and other GIS tools
 ```
 
 ### Advanced Usage
@@ -84,7 +90,7 @@ print(f"Successfully converted {results['gdbs_converted']}/{results['total_gdbs'
 
 #### `convert_gdb_to_parquet()`
 
-Convert a File Geodatabase to GeoParquet format.
+Convert a File Geodatabase to OGC GeoParquet format.
 
 **Parameters:**
 - `gdb_path` (str | Path): Path to the .gdb file
@@ -213,16 +219,16 @@ print(f"Estimated output size: {sizes['parquet']:.1f} MB")
 
 ```
 esri_converter/
-├── __init__.py           # Main package exports
-├── api.py               # Clean API functions
-├── exceptions.py        # Custom exceptions
+├── __init__.py                  # Main package exports
+├── api.py                      # Clean API functions
+├── exceptions.py               # Custom exceptions
 ├── converters/
 │   ├── __init__.py
-│   └── gdb_converter.py # Core conversion logic
+│   └── geoparquet_converter.py # OGC GeoParquet converter
 └── utils/
     ├── __init__.py
-    ├── formats.py       # Format information
-    └── validation.py    # Input validation
+    ├── formats.py              # Format information
+    └── validation.py           # Input validation
 ```
 
 ### Key Components
@@ -232,6 +238,36 @@ esri_converter/
 3. **Utilities** (`utils/`): Validation, format info, and helper functions
 4. **Exception Handling** (`exceptions.py`): Comprehensive error types
 
+## 🗺️ GeoParquet Compliance
+
+ESRI Converter produces **OGC GeoParquet v1.0.0** compliant files that are compatible with the entire geospatial ecosystem.
+
+### What is GeoParquet?
+
+GeoParquet is an open standard that adds geospatial capabilities to Apache Parquet files. Our output files:
+
+- ✅ Can be read by GeoPandas, DuckDB Spatial, QGIS, and other GIS tools
+- ✅ Include proper geo metadata according to the specification
+- ✅ Store geometries as WKB (Well-Known Binary) for optimal performance
+- ✅ Preserve CRS (Coordinate Reference System) information
+- ✅ Support all geometry types (Point, LineString, Polygon, etc.)
+
+### Verifying GeoParquet Output
+
+```python
+import geopandas as gpd
+
+# Read the converted GeoParquet file
+gdf = gpd.read_parquet("output/my_layer.parquet")
+
+# The file contains:
+# - Geometry column with proper spatial data
+# - CRS information preserved from source
+# - All attributes from the original GDB
+print(f"CRS: {gdf.crs}")
+print(f"Bounds: {gdf.total_bounds}")
+```
+
 ## 🔧 Technical Details
 
 ### Performance Optimizations

esri_converter/__init__.py

@@ -12,12 +12,12 @@
 - Robust error handling and type safety
 
 Example:
-    >>> from esri_converter import GDBConverter
-    >>> converter = GDBConverter()
-    >>> converter.convert_gdb("data.gdb", output_format="geoparquet")
+    >>> from esri_converter import convert_gdb_to_parquet
+    >>> result = convert_gdb_to_parquet("data.gdb")
+    >>> print(f"Converted {result['total_records']} records")
 """
 
-from importlib.metadata import version, PackageNotFoundError
+from importlib.metadata import PackageNotFoundError, version
 
 try:
     __version__ = version("esri-converter")
@@ -26,29 +26,26 @@
     __version__ = "unknown"
 
 # Core API functions
-from .api import (
-    convert_gdb_to_parquet,
-    convert_multiple_gdbs,
-    discover_gdb_files,
-    get_gdb_info
-)
+from .api import convert_gdb_to_parquet, convert_multiple_gdbs, discover_gdb_files, get_gdb_info
 
 # Core converter classes
-from .converters.gdb_converter import EnhancedGDBConverter
-from .converters.gdb_converter import EnhancedGDBConverter as GDBConverter  # Alias for backward compatibility
-
-# Utility functions
-from .utils.formats import list_supported_formats, get_format_info
-from .utils.validation import validate_gdb_file, validate_output_path
+from .converters.geoparquet_converter import GeoParquetConverter
+from .converters.geoparquet_converter import (
+    GeoParquetConverter as GDBConverter,  # Alias for backward compatibility
+)
 
 # Core exceptions
 from .exceptions import (
+    ConversionError,
     ESRIConverterError,
     UnsupportedFormatError,
     ValidationError,
-    ConversionError,
 )
 
+# Utility functions
+from .utils.formats import get_format_info, list_supported_formats
+from .utils.validation import validate_gdb_file, validate_output_path
+
 __all__ = [
     "__version__",
     # Core API functions
@@ -58,7 +55,7 @@
     "get_gdb_info",
     # Converters
     "GDBConverter",
-    "EnhancedGDBConverter",
+    "GeoParquetConverter",
     # Utilities
     "list_supported_formats",
     "get_format_info",
@@ -75,4 +72,4 @@
 __author__ = "Your Name"
 __email__ = "your.email@example.com"
 __license__ = "MIT"
-__description__ = "Modern tools for converting ESRI proprietary formats to open source formats" 
+__description__ = "Modern tools for converting ESRI proprietary formats to open source formats"