Add default Python starter kit and release CI packaging

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"

.github/workflows/release.yml

@@ -336,12 +336,16 @@ jobs:
  name: release-artifacts
  path: dist/
 
+ - name: Package Starter Kits
+ run: |
+ make starter-kits
+
  - name: Create GitHub Release
  env:
  GH_TOKEN: ${{ github.token }}
  run: |
  TAG="${{ github.ref_name }}"
- gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt \
+ gh release create "$TAG" dist/*.whl dist/*.tar.gz dist/checksums.txt dist/starter-kit-python-*.zip \
  --title "$TAG" \
  --prerelease \
  --generate-notes \

Makefile

@@ -125,6 +125,10 @@ bump-version:
 	uv run python scripts/bump_version.py $(VERSION)
 	$(MAKE) lint
 
+# Package all starter kits under starter-kits/ into dist/
+starter-kits:
+	@uv run python scripts/package_starter_kits.py
+
 # Help target
 help:
 	@echo "Fastly Compute Python SDK"
@@ -163,4 +167,4 @@ help:
 	@echo ""
 	@echo "Available examples: $(EXAMPLES)"
 
-.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version
+.PHONY: all serve test test-update-snapshots list-examples build-all clean lint lint-fix format format-check help bump-version starter-kits

pyproject.toml

@@ -74,6 +74,7 @@ convention = "google"
 [tool.ruff.lint.per-file-ignores]
 "fastly_compute/tests/*" = ["D"]
 "examples/*" = ["D"]
+"starter-kits/*" = ["D"]
 ".github/*" = ["D"]
 # What can one say about __main__?
 "__main__.py" = ["D100"]

scripts/package_starter_kits.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+"""Script to package all starter kits under starter-kits/ into dist/."""
+
+import zipfile
+from pathlib import Path
+
+
+def package_starter_kits():
+ """Discover and package starter kits as zips in dist/ directory"""
+ # Base directory of the repository (parent of scripts/)
+ repo_root = Path(__file__).resolve().parent.parent
+ starter_kits_dir = repo_root / "starter-kits"
+ dist_dir = repo_root / "dist"
+
+ # Ensure dist/ directory exists
+ dist_dir.mkdir(parents=True, exist_ok=True)
+
+ if not starter_kits_dir.is_dir():
+ print(f"Error: starter-kits directory not found at {starter_kits_dir}")
+ return
+
+ # Iterate over all subdirectories of starter-kits/
+ for kit_dir in starter_kits_dir.iterdir():
+ if kit_dir.is_dir():
+ kit_name = kit_dir.name
+ zip_path = dist_dir / f"starter-kit-python-{kit_name}.zip"
+ print(
+ f"Packaging starter kit '{kit_name}' to {zip_path.relative_to(repo_root)}..."
+ )
+
+ # Create/overwrite the zip archive
+ with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zipf:
+ # Walk the files inside the starter kit directory
+ for file_path in kit_dir.rglob("*"):
+ if file_path.is_file():
+ # Calculate the relative path for the zip archive
+ arcname = file_path.relative_to(kit_dir)
+ zipf.write(file_path, arcname)
+
+
+if __name__ == "__main__":
+ package_starter_kits()

starter-kits/default/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Fastly Compute
+bin/
+pkg/

starter-kits/default/README.md

@@ -0,0 +1,18 @@
+# Fastly Compute Python Starter Kit
+
+A basic starter kit for running Python applications on Fastly's Compute platform using the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) interface and the [Bottle](https://bottlepy.org/) web framework.
+
+## Requirements
+
+* [Fastly CLI](https://github.com/fastly/cli)
+* [Python >= 3.12](https://www.python.org/)
+* [uv](https://docs.astral.sh/uv/)
+
+## Development
+
+To build and deploy this application:
+
+```bash
+fastly compute build
+fastly compute deploy
+```

starter-kits/default/fastly.toml

@@ -0,0 +1,8 @@
+# This file describes a Fastly Compute package. To learn more visit:
+# https://www.fastly.com/documentation/reference/compute/fastly-toml
+
+authors = []
+description = "A basic starter kit that demonstrates routing and simple responses in Python."
+language = "python"
+manifest_version = 3
+name = "fastly-compute-python-app"

starter-kits/default/main.py

@@ -0,0 +1,18 @@
+import platform
+
+from bottle import Bottle
+
+from fastly_compute.wsgi import WsgiHttpIncoming
+
+app = Bottle()
+
+
+@app.route("/")
+def index():
+ version = platform.python_version()
+ return f"Welcome to Python {version} on Fastly Compute!"
+
+
+# Create the HTTP handler using WSGI; this adapts the fastly compute
+# platform to the WSGI standard for use with a variety of frameworks.
+HttpIncoming = WsgiHttpIncoming(app)

starter-kits/default/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "fastly-compute-python-app"
+version = "0.1.0"
+description = "A basic starter kit for Python on Fastly Compute"
+requires-python = ">=3.12"
+dependencies = [
+ "bottle>=0.12.25",
+ "fastly-compute>=0.1.2",
+]
+
+[tool.fastly-compute]
+entry = "main"