feat: Add sample extension - Rate limiter and a working helloworld sample which uses this extension

.github/workflows/linter.yaml

@@ -50,4 +50,5 @@ jobs:
           VALIDATE_TRIVY: false
           VALIDATE_BIOME_FORMAT: false
           VALIDATE_BIOME_LINT: false
+          VALIDATE_PYTHON_RUFF_FORMAT: false
           VALIDATE_GITHUB_ACTIONS_ZIZMOR: false

samples/python/agents/helloworld_with_ratelimiter/.vscode/launch.json

@@ -0,0 +1,18 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug HelloWorld Agent",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/__main__.py",
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}"
+      },
+      "cwd": "${workspaceFolder}",
+      "args": ["--host", "localhost", "--port", "9999"]
+    }
+  ]
+}

samples/python/agents/helloworld_with_ratelimiter/Containerfile

@@ -0,0 +1,40 @@
+FROM registry.access.redhat.com/ubi8/python-312:1-87
+
+# Set work directory
+WORKDIR /opt/app-root/
+
+# Copy Python Project Files (Container context must be the `python` directory)
+COPY . /opt/app-root
+
+USER root
+
+# Install system build dependencies and UV package manager
+# hadolint ignore=DL3013,DL3042
+RUN dnf -y update && dnf install -y gcc-11.5.0-2.el8 gcc-c++-11.5.0-2.el8 \
+ && pip install --no-cache-dir uv==0.5.15 \
+ && dnf clean all
+
+# Set environment variables for uv:
+# UV_COMPILE_BYTECODE=1: Compiles Python files to .pyc for faster startup
+# UV_LINK_MODE=copy: Ensures files are copied, not symlinked, which can avoid issues
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy
+
+# Install dependencies and project using uv sync.
+# --frozen: Ensures uv respects the uv.lock file
+# --no-dev: Excludes development dependencies
+# --mount=type=cache: Leverages Docker's build cache for uv, speeding up repeated builds
+RUN --mount=type=cache,target=/.cache/uv \
+    uv sync --frozen --no-install-project --no-dev && \
+    uv sync --frozen --no-dev
+
+# Allow non-root user to access everything in app-root
+RUN chgrp -R root /opt/app-root/ && chmod -R g+rwX /opt/app-root/
+
+# Expose default port (change if needed)
+EXPOSE 9999
+
+USER 1001
+
+# Run the agent
+CMD ["uv", "run", ".", "--host", "0.0.0.0"]