py-soildb v0.3.0

[brownag]

This pull request introduces several documentation and implementation improvements to the soildb package, primarily focused on enhancing the SDAResponse class's documentation and error handling for data conversion methods. The changes improves dealing with empty or malformed data.

Documentation enhancements

• Expanded the SDAResponse documentation to include new attributes and methods for data validation, error recovery, and fallback logic, such as data_quality_score, has_warnings, is_valid, validation_result, and validation-related methods.
• Added detailed docstrings for new methods like find_fallback_columns, get_validation_summary, handle_missing_fields, recover_partial_data, and several validation routines, clarifying their usage and return values. [1] [2]
• Updated the description of to_dict to indicate it now includes error recovery during conversion.

Data conversion and error handling improvements

• Updated to_dataframe for both pandas and polars backends to correctly handle cases where the data is empty, ensuring that empty DataFrames are created with the correct columns/schema. [1] [2]
• Refactored to_soilprofilecollection to move the empty DataFrame handling after required column validation, and clarified that depth validation is skipped if there are no rows, improving error messaging and robustness. [1] [2]

Version update

• Bumped the package version from 0.3.0.dev0 to 0.3.0 in pyproject.toml, marking a new release.