Update package names for Pep625 compliance (#358)

**Related Issue(s):**

#337 

**Description:**

- Updated package names in setup.py files to use underscores instead of
periods for PEP 625 compliance
  - 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
- Removed deprecated `version` field from all compose files
- Updated `STAC_FASTAPI_VERSION` environment variables to 4.0.0a1 in all
compose files
- Bumped version from 4.0.0a0 to 4.0.0a1 for the PEP 625 compliant
release
- Updated dependency requirements to use compatible release specifiers
(~=) for more controlled updates while allowing for bug fixes and
security patches
- Removed elasticsearch-dsl dependency as it's now part of the
elasticsearch package since version 8.18.0

**PR Checklist:**

- [x] Code is formatted and linted (run `pre-commit run --all-files`)
- [x] Tests pass (run `make test`)
- [x] Documentation has been updated to reflect changes, if applicable
- [x] Changes are added to the changelog

Author: jonhealy1

CHANGELOG.md

@@ -13,7 +13,22 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Fixed
 
-## [v4.0.0a0] - 2025-04-17
+## [v4.0.0a1] - 2925-04-17
+
+### Changed
+- Updated package names in setup.py files to use underscores instead of periods for PEP 625 compliance [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/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](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/358)
+- Removed deprecated `version` field from all compose files [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/358)
+- Updated `STAC_FASTAPI_VERSION` environment variables to 4.0.0a1 in all compose files [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/358)
+- Bumped version from 4.0.0a0 to 4.0.0a1 for the PEP 625 compliant release [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/358)
+- Updated dependency requirements to use compatible release specifiers (~=) for more controlled updates while allowing for bug fixes and security patches [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/issues/358)
+- Removed elasticsearch-dsl dependency as it's now part of the elasticsearch package since version 8.18.0 [#358](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/issues/358)
+
+## [v4.0.0a0] - 2025-04-16
 
 ### Added
 - Added support for dynamically-generated queryables based on Elasticsearch/OpenSearch mappings, with extensible metadata augmentation [#351](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/351)
@@ -328,7 +343,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Use genexp in execute_search and get_all_collections to return results.
 - Added db_to_stac serializer to item_collection method in core.py.
 
-[Unreleased]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v4.0.0a0...main
+[Unreleased]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v4.0.0a1...main
+[v4.0.0a1]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v4.0.0a0...v4.0.0a1
 [v4.0.0a0]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v3.2.5...v4.0.0a0
 [v3.2.5]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v3.2.4...v3.2.5
 [v3.2.4]: https://github.com/stac-utils/stac-fastapi-elasticsearch/tree/v3.2.3...v3.2.4

Makefile

@@ -107,10 +107,10 @@ install-os: pybase-install
 
 .PHONY: docs-image
 docs-image:
-	docker compose -f docker compose.docs.yml \
+	docker compose -f compose.docs.yml \
 		build
 
 .PHONY: docs
 docs: docs-image
-	docker compose -f docker compose.docs.yml \
+	docker compose -f compose.docs.yml \
 		run docs

README.md

@@ -9,7 +9,7 @@
 </p>
 
 
-  [![PyPI version](https://badge.fury.io/py/stac-fastapi.elasticsearch.svg)](https://badge.fury.io/py/stac-fastapi.elasticsearch)
+  [![PyPI version](https://badge.fury.io/py/stac-fastapi-elasticsearch.svg)](https://badge.fury.io/py/stac-fastapi-elasticsearch) [![PyPI version](https://badge.fury.io/py/stac-fastapi-opensearch.svg)](https://badge.fury.io/py/stac-fastapi-opensearch)
   [![Join the chat at https://gitter.im/stac-fastapi-elasticsearch/community](https://badges.gitter.im/stac-fastapi-elasticsearch/community.svg)](https://gitter.im/stac-fastapi-elasticsearch/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 
@@ -26,7 +26,7 @@
 
 - Our Api core library can be used to create custom backends. See [stac-fastapi-mongo](https://github.com/Healy-Hyperspatial/stac-fastapi-mongo) for a working example.
 - Reach out on our [Gitter](https://app.gitter.im/#/room/#stac-fastapi-elasticsearch_community:gitter.im) channel or feel free to add to our [Discussions](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/discussions) page here on github.
-- There is [Postman](https://documenter.getpostman.com/view/12888943/2s8ZDSdRHA) documentation here for examples on how to run some of the API routes locally - after starting the elasticsearch backend via the docker-compose.yml file.
+- There is [Postman](https://documenter.getpostman.com/view/12888943/2s8ZDSdRHA) documentation here for examples on how to run some of the API routes locally - after starting the elasticsearch backend via the compose.yml file.
 - The `/examples` folder shows an example of running stac-fastapi-elasticsearch from PyPI in docker without needing any code from the repository. There is also a Postman collection here that you can load into Postman for testing the API routes.
 
 - For changes, see the [Changelog](CHANGELOG.md)
@@ -35,14 +35,20 @@
 
 ### To install from PyPI:
 
-```shell
-pip install stac_fastapi.elasticsearch
-```
-or
-```
-pip install stac_fastapi.opensearch
+```bash
+# For versions 4.0.0a1 and newer (PEP 625 compliant naming):
+pip install stac-fastapi-elasticsearch  # Elasticsearch backend
+pip install stac-fastapi-opensearch    # Opensearch backend
+pip install stac-fastapi-core          # Core library
+
+# For versions 4.0.0a0 and older:
+pip install stac-fastapi.elasticsearch  # Elasticsearch backend
+pip install stac-fastapi.opensearch    # Opensearch backend
+pip install stac-fastapi.core          # Core library
 ```
 
+> **Important Note:** Starting with version 4.0.0a1, package names have changed from using periods (e.g., `stac-fastapi.core`) to using hyphens (e.g., `stac-fastapi-core`) to comply with PEP 625. The internal package structure uses underscores, but users should install with hyphens as shown above. Please update your requirements files accordingly.
+
 ### To install and run via pre-built Docker Images
 
 We provide ready-to-use Docker images through GitHub Container Registry ([ElasticSearch](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pkgs/container/stac-fastapi-es) and [OpenSearch](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pkgs/container/stac-fastapi-os) backends). You can easily pull and run these images:
@@ -57,15 +63,15 @@ docker pull ghcr.io/stac-utils/stac-fastapi-os:latest
 
 ## Run Elasticsearch API backend on localhost:8080
 
-You need to ensure [**Docker Compose**](https://docs.docker.com/compose/install/) or [**Podman Compose**](https://podman-desktop.io/docs/compose) installed and running on your machine. In the follwoing command instead of `docker-compose` you can use `podman-compose` as well.
+You need to ensure [**Docker Compose**](https://docs.docker.com/compose/install/) or [**Podman Compose**](https://podman-desktop.io/docs/compose) installed and running on your machine. In the following command instead of `docker compose` you can use `podman-compose` as well.
 
 ```shell
-docker-compose up elasticsearch app-elasticsearch
+docker compose up elasticsearch app-elasticsearch
 ```
 
-By default, docker-compose uses Elasticsearch 8.x and OpenSearch 2.11.1.
+By default, Docker Compose uses Elasticsearch 8.x and OpenSearch 2.11.1.
 If you wish to use a different version, put the following in a 
-file named `.env` in the same directory you run docker-compose from:
+file named `.env` in the same directory you run Docker Compose from:
 
 ```shell
 ELASTICSEARCH_VERSION=7.17.1
@@ -165,7 +171,7 @@ These templates will be used implicitly when creating new Collection and Item in
 This section covers how to create a snapshot repository and then create and restore snapshots with this.
 
 Create a snapshot repository. This puts the files in the `elasticsearch/snapshots` in this git repo clone, as
-the elasticsearch.yml and docker-compose files create a mapping from that directory to 
+the elasticsearch.yml and compose files create a mapping from that directory to 
 `/usr/share/elasticsearch/snapshots` within the Elasticsearch container and grant permissions on using it.
 
 ```shell

docker-compose.docs.yml renamed to compose.docs.yml

@@ -1,5 +1,3 @@
-version: '3'
-
 services:
   docs:
     container_name: stac-fastapi-docs-dev

docker-compose.yml renamed to compose.yml

@@ -9,7 +9,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-elasticsearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Elasticsearch backend
-      - STAC_FASTAPI_VERSION=2.1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8080
       - RELOAD=true
@@ -41,7 +41,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-opensearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Opensearch backend
-      - STAC_FASTAPI_VERSION=3.0.0a2
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8082
       - RELOAD=true

examples/auth/docker-compose.basic_auth.yml renamed to examples/auth/compose.basic_auth.yml

@@ -1,5 +1,3 @@
-version: '3.9'
-
 services:
   app-elasticsearch:
     container_name: stac-fastapi-es
@@ -11,7 +9,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-elasticsearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Elasticsearch backend
-      - STAC_FASTAPI_VERSION=3.0.0a2
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8080
       - RELOAD=true
@@ -44,7 +42,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-opensearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Opensearch backend
-      - STAC_FASTAPI_VERSION=2.1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8082
       - RELOAD=true

examples/auth/docker-compose.oauth2.yml renamed to examples/auth/compose.oauth2.yml

@@ -1,5 +1,3 @@
-version: '3.9'
-
 services:
   app-elasticsearch:
     container_name: stac-fastapi-es
@@ -11,7 +9,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-elasticsearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Elasticsearch backend
-      - STAC_FASTAPI_VERSION=3.0.0a1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8080
       - RELOAD=true
@@ -45,7 +43,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-opensearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Opensearch backend
-      - STAC_FASTAPI_VERSION=2.1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8082
       - RELOAD=true

examples/auth/docker-compose.route_dependencies.yml renamed to examples/auth/compose.route_dependencies.yml

@@ -1,5 +1,3 @@
-version: '3.9'
-
 services:
   app-elasticsearch:
     container_name: stac-fastapi-es
@@ -11,7 +9,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-elasticsearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Elasticsearch backend
-      - STAC_FASTAPI_VERSION=3.0.0a2
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8080
       - RELOAD=true
@@ -44,7 +42,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-opensearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Opensearch backend
-      - STAC_FASTAPI_VERSION=2.1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8082
       - RELOAD=true

examples/pip_docker/docker-compose.yml renamed to examples/pip_docker/compose.yml

@@ -1,5 +1,3 @@
-version: '3'
-
 services:
   app-elasticsearch:
     container_name: stac-fastapi-es

examples/rate_limit/docker-compose.rate_limit.yml renamed to examples/rate_limit/compose.rate_limit.yml

@@ -1,5 +1,3 @@
-version: '3.9'
-
 services:
   app-elasticsearch:
     container_name: stac-fastapi-es
@@ -11,7 +9,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-elasticsearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Elasticsearch backend
-      - STAC_FASTAPI_VERSION=2.1
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8080
       - RELOAD=true
@@ -44,7 +42,7 @@ services:
     environment:
       - STAC_FASTAPI_TITLE=stac-fastapi-opensearch
       - STAC_FASTAPI_DESCRIPTION=A STAC FastAPI with an Opensearch backend
-      - STAC_FASTAPI_VERSION=3.0.0a2
+      - STAC_FASTAPI_VERSION=4.0.0a1
       - APP_HOST=0.0.0.0
       - APP_PORT=8082
       - RELOAD=true