feat: addn suport to sms tools and testing

Author: syntaxsdev

Makefile

@@ -20,7 +20,7 @@ patch_templates:
 	rm -rf $$VENV
 
 tests:
-	uv run pytest -rs -m e2e
+	uv run pytest -rs -v -s -m e2e
 
 clean-tests:
 	@source .venv/bin/activate && \

appwrite_lab/_orchestrator.py

@@ -145,7 +145,7 @@ def _deploy_compose_service(
 
         Args:
             project: The name of the project to deploy the service to.
-            template_path: The path to the template to use for the service.
+            template_paths: The path to the template to use for the service.
             env_vars: The environment variables to set.
             env_file: The path to the environment file to use for the service.
             extra_args: Extra arguments to pass to the compose command.
@@ -157,7 +157,6 @@ def _deploy_compose_service(
         for path in template_paths:
             file_overlays.extend(["-f", str(path)])
 
-        new_env = {**os.environ, **env_vars}
         cmd = [
             *self.compose,
             *file_overlays,
@@ -168,7 +167,7 @@ def _deploy_compose_service(
             "up",
             "-d",
         ]
-        return self._run_cmd_safely(cmd, envs=new_env)
+        return self._run_cmd_safely(cmd, envs=env_vars)
 
     def deploy_appwrite_lab(
         self,
@@ -267,6 +266,8 @@ def deploy_appwrite_lab(
             version=version,
             url=url,
             **_kwargs,
+            sms_shim_url="https://localhost:4443",
+            mailpit_url="http://localhost:8025",
         )
 
         lab.generate_missing_config()

appwrite_lab/_state.py

@@ -1,6 +1,5 @@
 import json
 import os
-from pathlib import Path
 
 from .utils import get_state_path
 

appwrite_lab/models.py

@@ -51,6 +51,8 @@ class Lab(_BaseClass):
         default_factory=lambda: {"default": Project(None, None, None)}
     )
     _file: str = field(default="")
+    sms_shim_url: str = field(default="")
+    mailpit_url: str = field(default="")
 
     def generate_missing_config(self):
         """Generate missing data config with random values."""

appwrite_lab/templates/environment/dotenv

@@ -55,8 +55,8 @@ _APP_SMTP_PORT=1025
 _APP_SMTP_SECURE=
 _APP_SMTP_USERNAME=
 _APP_SMTP_PASSWORD=
-_APP_SMS_PROVIDER=
-_APP_SMS_FROM=
+_APP_SMS_PROVIDER=sms://twilio:shim@twilio
+_APP_SMS_FROM=+15555555555
 _APP_STORAGE_LIMIT=30000000
 _APP_STORAGE_PREVIEW_LIMIT=20000000
 _APP_STORAGE_ANTIVIRUS=disabled

appwrite_lab/templates/extras/twilio-shim/docker_compose.yml

@@ -3,8 +3,7 @@ x-sms-env: &sms_env
   _APP_SMS_FROM:     ${_APP_SMS_FROM:-+15555555555}
 
 networks:
-  appwrite_net:
-    external: true
+  appwrite:
     name: appwrite
 
 volumes:
@@ -29,7 +28,7 @@ services:
       - fake_twilio_certs:/certs
     ports: ["4443:443"]  # dev-only host access
     networks:
-      appwrite_net:
+      appwrite:
         aliases: [api.twilio.com]
     restart: unless-stopped
     healthcheck:
@@ -47,7 +46,7 @@ services:
     volumes:
       - fake_twilio_certs:/usr/local/share/ca-certificates:ro
       - php_extra_conf:/opt/php-extra-conf.d:ro
-    networks: [appwrite_net]
+    networks: [appwrite]
 
   appwrite-worker-messaging:
     depends_on:
@@ -59,4 +58,4 @@ services:
     volumes:
       - fake_twilio_certs:/usr/local/share/ca-certificates:ro
       - php_extra_conf:/opt/php-extra-conf.d:ro
-    networks: [appwrite_net]
+    networks: [appwrite]

appwrite_lab/tools/sms.py

@@ -0,0 +1,17 @@
+from appwrite_lab.models import Lab
+from httpx import AsyncClient
+
+
+class SMS:
+    def __init__(self, lab: Lab):
+        self.url = lab.sms_shim_url
+
+    async def get_messages(self):
+        async with AsyncClient(verify=False) as client:
+            response = await client.get(f"{self.url}/inbox")
+            return response.json().get("messages")
+
+    async def clear_messages(self):
+        async with AsyncClient(verify=False) as client:
+            response = await client.post(f"{self.url}/clear")
+            return response.json().get("ok")

pyproject.toml

@@ -8,7 +8,14 @@ version = "0.1.2"
 description = "Zero-click Appwrite test environments."
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = ["playwright", "typer>=0.16.0", "python-dotenv>=1.1.0", "pytest>=8.4.1"]
+dependencies = [
+    "playwright",
+    "typer>=0.16.0",
+    "python-dotenv>=1.1.0",
+    "pytest>=8.4.1",
+    "httpx>=0.28.1",
+    "pytest-asyncio>=1.1.0",
+]
 license = "MIT"
 
 [tool.setuptools]
@@ -23,6 +30,5 @@ appwrite-lab = "appwrite_lab.cli.entry:app"
 awlab = "appwrite_lab.cli.entry:app"
 
 [tool.pytest.ini_options]
-markers = [
-    "e2e: mark test as e2e",
-]
+markers = ["e2e: mark test as e2e"]
+asyncio_mode = "auto"

tests/conftest.py

@@ -2,9 +2,20 @@
 from pathlib import Path
 from appwrite_lab.models import Lab
 from appwrite_lab.test_suite import lab_svc, appwrite_file, lab_config, lab
+from appwrite_lab.tools.sms import SMS
 
 
 @pytest.fixture(scope="session")
 def appwrite_file_path():
     return Path(__file__).parent / "data" / "appwrite.json"
-    
+
+
+@pytest.fixture(scope="session")
+def sms(lab: Lab):
+    return SMS(lab)
+
+
+@pytest.fixture(autouse=True)
+async def clear_sms(sms: SMS):
+    yield
+    await sms.clear_messages()

tests/test_labs.py

@@ -2,19 +2,21 @@
 from appwrite_lab.labs import Labs
 from appwrite_lab.automations.models import Expiration
 import pytest
-
+import uuid
 
 @pytest.mark.e2e
 def test_labs_new(lab: Lab):
     assert lab.name == "test-lab"
     assert lab.version == "1.7.4"
-    assert lab.url.endswith("8080")
+    assert lab.url.endswith("80")
     assert lab.projects.get("default") is not None
 
 
 @pytest.mark.e2e
 def test_labs_create_api_key(lab: Lab, lab_svc: Labs):
     default = lab.projects.get("default")
+    if default.api_key:
+        pytest.skip("API key already exists")
     res = lab_svc.create_api_key(
         project_name=default.project_name,
         key_name="default-api-key",
@@ -37,8 +39,9 @@ def test_labs_synced_project(lab: Lab, lab_svc: Labs):
 
 @pytest.mark.e2e
 def test_labs_create_project(lab: Lab, lab_svc: Labs):
-    project_name = "test-project"
-    project_id = "test-project-id"
+    nonce = str(uuid.uuid4())[:8]
+    project_name = f"test-project-{nonce}"
+    project_id = f"test-project-id-{nonce}"
     res = lab_svc.create_project(
         project_name=project_name,
         project_id=project_id,