v4.1.0

v4.1.0

Added

• Added logging to bulk insertion methods to provide detailed feedback on errors encountered during operations. #364
• Introduced the RAISE_ON_BULK_ERROR environment variable to control whether bulk insertion methods raise exceptions on errors (true) or log warnings and continue processing (false). #364
• Added code coverage reporting to the test suite using pytest-cov. #87

Changed

• Updated dynamic mapping for items to map long values to double versus float. #326
• Extended Datetime Search to search on start_datetime and end_datetime as well as datetime fields. #182
• Changed item update operation to use Elasticsearch index API instead of delete and create for better efficiency and atomicity. #75
• Bulk insertion via BulkTransactionsClient now strictly validates all STAC Items using the Pydantic model before insertion. Any invalid item will immediately raise a ValidationError, ensuring consistent validation with single-item inserts and preventing invalid STAC Items from being stored. This validation is enforced regardless of the RAISE_ON_BULK_ERROR setting. #368

Fixed

• Refactored create_item and update_item methods to share unified logic, ensuring consistent conflict detection, validation, and database operations. #368

New Contributors

• @johnmichaelmurner made their first contribution in #326

Full Changelog: v4.0.0...v4.1.0

v4.0.0

What's Changed

Added

• Support for dynamically-generated queryables based on Elasticsearch/OpenSearch mappings, with extensible metadata augmentation #351
• Included default queryables configuration for seamless integration. #351
• Added support for high-performance direct response mode for both Elasticsearch and Opensearch backends, controlled by the ENABLE_DIRECT_RESPONSE environment variable. When enabled (ENABLE_DIRECT_RESPONSE=true), endpoints return Starlette Response objects directly, bypassing FastAPI's jsonable_encoder and Pydantic serialization for significantly improved performance on large search responses. Note: In this mode, all FastAPI dependencies (including authentication, custom status codes, and validation) are disabled for all routes. Default is false for safety. A warning is logged at startup if enabled. See issue #347 and PR #359.
• Added robust tests for the ENABLE_DIRECT_RESPONSE environment variable, covering both Elasticsearch and OpenSearch backends. Tests gracefully handle missing backends by attempting to import both configs and skipping if neither is available. #359

Changed

• Refactored database logic to reduce duplication #351
• Replaced fastapi-slim with fastapi dependency #351
• Changed minimum Python version to 3.9 #354
• Updated stac-fastapi api, types, and extensions libraries to 5.1.1 from 3.0.0 and made various associated changes #354
• Changed makefile commands from 'docker-compose' to 'docker compose' #354
• Updated package names in setup.py files to use underscores instead of periods for PEP 625 compliance #358
  • Changed stac_fastapi.opensearch to stac_fastapi_opensearch
  • Changed stac_fastapi.elasticsearch to stac_fastapi_elasticsearch
  • Changed stac_fastapi.core to stac_fastapi_core
  • Updated all related dependencies to use the new naming convention
• Renamed docker-compose.yml to compose.yml to align with Docker Compose V2 conventions #358
• Removed deprecated version field from all compose files #358
• Updated STAC_FASTAPI_VERSION environment variables to 4.0.0 in all compose files #362
• Bumped version from 4.0.0a2 to 4.0.0 for the PEP 625 compliant release #362
• Updated dependency requirements to use compatible release specifiers (~=) for more controlled updates while allowing for bug fixes and security patches #358
• Removed elasticsearch-dsl dependency as it's now part of the elasticsearch package since version 8.18.0 #358
• Updated test suite to use httpx.ASGITransport(app=...) for FastAPI app testing (removes deprecation warning). #359
• Updated stac-fastapi parent libraries to 5.2.0. #359
• Migrated Elasticsearch index template creation from legacy put_template to composable put_index_template API in database_logic.py. This resolves deprecation warnings and ensures compatibility with Elasticsearch 7.x and 8.x. #359
• Updated all Pydantic models to use ConfigDict instead of class-based Config for Pydantic v2 compatibility. This resolves deprecation warnings and prepares for Pydantic v3. #359
• Migrated all Pydantic @root_validator validators to @model_validator for Pydantic v2 compatibility. #359
• Migrated startup event handling from deprecated @app.on_event("startup") to FastAPI's recommended lifespan context manager. This removes deprecation warnings and ensures compatibility with future FastAPI versions. #361
• Refactored all boolean environment variable parsing in both Elasticsearch and OpenSearch backends to use the shared get_bool_env utility. This ensures robust and consistent handling of environment variables such as ES_USE_SSL, ES_HTTP_COMPRESS, and ES_VERIFY_CERTS across both backends. #359

Fixed

• Improved performance of mk_actions and filter-links methods #351
• Fixed inheritance relating to BaseDatabaseSettings and ApiBaseSettings #355
• Fixed delete_item and delete_collection methods return types #355
• Fixed inheritance relating to DatabaseLogic and BaseDatabaseLogic, and ApiBaseSettings #355

New Contributors

• @Zaczero made their first contribution in #351

Full Changelog: v3.2.5...v4.0.0

v4.0.0a2

What's Changed

• Enable direct response, stac-fastapi 5.2.0, deprecation warnings by @jonhealy1 in #359

Full Changelog: v4.0.0a1...v4.0.0a2

v4.0.0a1

What's Changed

• Update package names for Pep625 compliance by @jonhealy1 in #358

Full Changelog: v4.0.0a0...v4.0.0a1

v4.0.0a0

What's Changed

• Zero-config dynamically-generated queryables, Performance fixes by @Zaczero in #351
• Update stac-fastapi parent libraries to 5.1.1 by @jonhealy1 in #354
• Inherit from Base Database Logic by @jonhealy1 in #355

New Contributors

• @Zaczero made their first contribution in #351

Full Changelog: v3.2.5...v4.0.0a0

v3.2.5

What's Changed

• Option to configure multiple Elasticsearch/OpenSearch hosts and enable http_compress by @StijnCaerts in #349
• update to v3.2.5 by @jonhealy1 in #350

Full Changelog: v3.2.4...v3.2.5

v3.2.4

What's Changed

• Support Py3.13 by @mo-dkrz in #338
• Update version to v3.2.4 by @jonhealy1 in #339

Full Changelog: v3.2.3...v3.2.4

v3.2.3

What's Changed

• Adding note on the use of the default * use in route authentication dependecies by @rhysrevans3 in #325
• Fix IsNull operator by @jamesfisher-geo in #330
• Allow capitals in item index aliases by @rhysrevans3 in #329
• update for v3.2.3 by @jonhealy1 in #333

Full Changelog: v3.2.2...v3.2.3

v3.2.2

What's Changed

• Update for pep625 - pypi deprecation warnings by @jonhealy1 in #317
• fix: use base64 encoded JSON string of sort keys as pagination token by @StijnCaerts in #323
• Release v3.2.2 by @jonhealy1 in #324

Full Changelog: v3.2.1...v3.2.2

v3.2.1

What's Changed

• Aggregation Bugfix and Documentation Update by @jamesfisher-geo in #314
• add build push docker image image in the publish ci by @mo-dkrz in #311
• Pin httpx to <= 0.27.2 to fix tests by @jonhealy1 in #316

New Contributors

• @mo-dkrz made their first contribution in #311

Full Changelog: v3.2.0...v3.2.1