Update README and makefile to improve local testing experience (#89)

Author: cgraham-rs

integration/Makefile

@@ -52,12 +52,12 @@ PYTEST_ARGS ?= "-s"
 	up-%
 
 
-# All versions starting with 2025.03.0 (first Connect version fully supporting extensions, version matching) and newer
+# All versions starting with the first Connect version that fully supports extensions and version matching
 # Note connect-preview is the same version in the `preview` target. It is included here as part of the full list of all 
 # possible versions to test against in CI or when using the `all` target.
 CONNECT_VERSIONS := \
 	connect-preview \
-	2025.03.0
+	2025.04.0
 
 
 # Compute the latest official release version (excludes connect-preview)
@@ -245,6 +245,26 @@ print-versions:
 	@printf "%s\n" $(strip $(CONNECT_VERSIONS))
 
 
+# Package an extension into a tar.gz file. This only works for simple extensions.
+# Usage: make package-extension EXTENSION_NAME=<extension-name>
+package-extension:
+	@if [ -z "$(EXTENSION_NAME)" ]; then \
+			echo "Error: EXTENSION_NAME is required."; \
+			echo "Usage: make package-extension EXTENSION_NAME=<extension-name>"; \
+			exit 1; \
+	fi
+	@if [ ! -d "../extensions/$(EXTENSION_NAME)" ]; then \
+			echo "Error: Extension directory 'extensions/$(EXTENSION_NAME)' does not exist."; \
+			echo "Available extensions:"; \
+			ls -1 ../extensions/; \
+			exit 1; \
+	fi
+	@mkdir -p ./integration/bundles
+	@echo "Packaging extension: $(EXTENSION_NAME)"
+	@tar -czf ./bundles/$(EXTENSION_NAME).tar.gz ../extensions/$(EXTENSION_NAME)
+	@echo "✅ Package created: ./bundles/$(EXTENSION_NAME).tar.gz"
+
+
 # Show help message.
 help:
 	@echo "Makefile Targets:"
@@ -257,6 +277,7 @@ help:
 	@echo "  down             Tear down Docker resources for all Connect versions."
 	@echo "  clean            Clean up the project directory."
 	@echo "  print-versions   Show the available Connect versions."
+	@echo "  package-extension Package an extension into a tar.gz file."
 	@echo "  help             Show this help message."
 	@echo
 	@echo "Required Parameters:"

integration/README.md

@@ -5,19 +5,22 @@ This directory contains integration tests for Connect Extensions.
 It is primarily designed to be run in CI, but can also be run locally.
 
 ## Prerequisites
-- [UV package manager](https://docs.astral.sh/uv/getting-started/installation/)
-- Python
+
+- [UV package manager](https://docs.astral.sh/uv/getting-started/installation/) with the same version from `[tool.uv]` in `integrations/pyproject.toml`
+- Python with the same version in `integrations/pyproject.toml`
 
 ## Quick Start
+
 For local testing:
-- Install `uv` with a version matching that in `pyproject.toml`
-- Copy a valid Connect license file to `integration/license.lic`
-- Copy the packaged extension (*.tar.gz) to `integration/bundles`
-- Run: `make <connect-version> EXTENSION_NAME=<extension-name>`
-		- `<connect-version>` matches a valid version from CONNECT_VERSIONS in the Makefile 
-		- `<extension-name>` matches the base name of your .tar.gz file (without the .tar.gz extension)
+- All instructions are run from the root directory
+- Copy a valid Connect license file to `integration/license.lic` making sure the license enables all of the features your content requires, for example API Publishing
+- Copy the packaged extension (\*.tar.gz) to `integration/bundles` or create one using `make -C ./integration package-extension EXTENSION_NAME=my-extension`
+- Run integration tests against a specific Connect version: `make -C ./integration <connect-version> EXTENSION_NAME=<extension-name>` 
+  - `<connect-version>` matches a valid version from CONNECT_VERSIONS in the Makefile 
+	- `<extension-name>` matches the base name of your .tar.gz file (without the .tar.gz extension)
 
 Example:
-- `make 2025.03.0 EXTENSION_NAME=publisher-command-center`
 
-For detailed commands and examples, run: `make help`
+- `make -C ./integration 2025.04.0 EXTENSION_NAME=my-extension`
+
+For detailed commands and examples, run: `make -C ./integration help`