wexample-wex-addon-services-collab 0.0.3__tar.gz

wexample_wex_addon_services_collab-0.0.3/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.1
+Name: wexample-wex-addon-services-collab
+Version: 0.0.3
+Summary: Collaboration services (rocketchat, nextcloud, onlyoffice...) for wex
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Requires-Dist: wexample-wex-addon-app>=1.0.0
+Requires-Dist: wexample-wex-core>=7.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wex_addon_services_collab
+
+Version: 0.0.3
+
+Collaboration services (rocketchat, nextcloud, onlyoffice...) for wex
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- wexample-wex-addon-app: >=1.0.0
+- wexample-wex-core: >=7.0.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_services_collab/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-services-collab
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-services-collab/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-services-collab/discussions
+- **PyPI**: [pypi.org/project/wex_addon_services_collab](https://pypi.org/project/wex_addon_services_collab/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

wexample_wex_addon_services_collab-0.0.3/README.md

@@ -0,0 +1,147 @@
+# wex_addon_services_collab
+
+Version: 0.0.3
+
+Collaboration services (rocketchat, nextcloud, onlyoffice...) for wex
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- wexample-wex-addon-app: >=1.0.0
+- wexample-wex-core: >=7.0.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_services_collab/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-services-collab
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-services-collab/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-services-collab/discussions
+- **PyPI**: [pypi.org/project/wex_addon_services_collab](https://pypi.org/project/wex_addon_services_collab/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

wexample_wex_addon_services_collab-0.0.3/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[project]
+name = "wexample-wex-addon-services-collab"
+version = "0.0.3"
+description = "Collaboration services (rocketchat, nextcloud, onlyoffice...) for wex"
+authors = [
+    { name = "weeger", email = "contact@wexample.com" },
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "wexample-wex-addon-app>=1.0.0",
+    "wexample-wex-core>=7.0.0",
+]
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.license]
+text = "MIT"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-cov",
+]
+
+[tool.setuptools.packages.find]
+include = [
+    "*",
+]
+exclude = [
+    "wexample_wex_addon_services_collab.testing*",
+]
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.build]
+package-dir = "src"
+packages = [
+    { include = "wexample_wex_addon_services_collab", from = "src" },
+]
+
+[tool.pytest.ini_options]
+pythonpath = [
+    "src",
+]
+testpaths = [
+    "tests",
+]
+
+[tool.coverage.run]
+source = [
+    "wexample_wex_addon_services_collab",
+]
+omit = [
+    "*/tests/*",
+    "*/.venv/*",
+    "*/venv/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from wexample_wex_addon_services_collab.services_collab_addon_manager import (
+    ServicesCollabAddonManager,
+)
+
+__all__ = ["ServicesCollabAddonManager"]

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/commands/__init__.py

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/commands/service/__init__.py

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/commands/service/install.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE,
+    description="Configure nextcloud service in app config",
+)
+def nextcloud__service__install(
+    context: ExecutionContext,
+    service: AppService,
+) -> None:
+    from wexample_helpers.helpers.string import string_random_password
+
+    config_file = service.app_workdir.get_config_file()
+    config = config_file.read_config()
+
+    config.set_by_path(f"service.{service.name}.admin.user", "admin")
+    config.set_by_path(
+        f"service.{service.name}.admin.password",
+        string_random_password(),
+    )
+
+    config_file.write_config(config)
+    service.app_workdir.get_runtime_config(rebuild=True)
+
+    context.io.log("Configured nextcloud service defaults")

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/docker/docker-compose.yml

@@ -0,0 +1,16 @@
+services:
+  nextcloud:
+    image: nextcloud:28.0.1
+    container_name: ${APP_PROJECT_NAME}_nextcloud
+    environment:
+      - MARIA_HOST=${SERVICE_MARIA_HOST}
+      - MARIA_DATABASE=${SERVICE_MARIA_NAME}
+      - MARIA_USER=${SERVICE_MARIA_USER}
+      - MARIA_PASSWORD=${SERVICE_MARIA_PASSWORD}
+    volumes:
+      - ${APP_PATH}data:/var/www/html
+      - ${APP_PATH}extra-addons:/mnt/extra-addons
+      - ${APP_PATH}config.php:/var/www/html/config/wex.config.php
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/config.php

@@ -0,0 +1,7 @@
+<?php
+
+$CONFIG = [
+    'filesystem_check_changes' => 1,
+    'filelocking.enabled' => false,
+    'trashbin_retention_obligation' => 'auto, 1',
+];

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/data/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/docker/docker-compose.yml

@@ -0,0 +1,5 @@
+services:
+  nextcloud:
+    environment:
+      - NEXTCLOUD_ADMIN_USER=admin
+      - NEXTCLOUD_ADMIN_PASSWORD=supersecretpassword

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/env/dev/docker/docker-compose.yml

@@ -0,0 +1,4 @@
+services:
+  nextcloud:
+    environment:
+      - NEXTCLOUD_TRUSTED_DOMAINS=${APP_DOMAIN}

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/env/prod/docker/docker-compose.yml

@@ -0,0 +1,4 @@
+services:
+  nextcloud:
+    environment:
+      - NEXTCLOUD_TRUSTED_DOMAINS=${APP_DOMAINS_STRING}

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/samples/extra-addons/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/nextcloud/service.yml

@@ -0,0 +1,8 @@
+name: nextcloud
+tags:
+  - collab
+dependencies:
+  - maria
+  - proxy
+docker:
+  compose: docker/docker-compose.yml

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/docker/docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  onlyoffice:
+    image: onlyoffice/documentserver:7.4.1
+    container_name: ${APP_PROJECT_NAME}_onlyoffice
+    ports:
+      - "5222:5222"
+    environment:
+      - VIRTUAL_HOST=${APP_DOMAINS_STRING}
+      - VIRTUAL_PORT=80
+    volumes:
+      - ${APP_PATH}logs:/var/log/onlyoffice
+      - ${APP_PATH}data:/var/www/onlyoffice/Data
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/samples/data/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/samples/docker/docker-compose.yml

@@ -0,0 +1,5 @@
+services:
+  onlyoffice:
+    extends:
+      file: ${SERVICE_ONLYOFFICE_COMPOSE}
+      service: onlyoffice

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/samples/env/prod/docker/docker-compose.yml

@@ -0,0 +1,5 @@
+services:
+  onlyoffice:
+    environment:
+      - LETSENCRYPT_HOST=${APP_DOMAINS_STRING}
+      - LETSENCRYPT_EMAIL=${APP_EMAIL}

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/samples/logs/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/onlyoffice/service.yml

@@ -0,0 +1,7 @@
+name: onlyoffice
+tags:
+  - collab
+dependencies:
+  - proxy
+docker:
+  compose: docker/docker-compose.yml

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/rocketchat/docker/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  rocketchat:
+    image: rocket.chat:6.4.1
+    container_name: ${APP_PROJECT_NAME}_rocketchat
+    environment:
+      - ROOT_URL=http://${APP_DOMAIN}
+      - MONGO_URL=mongodb://${APP_PROJECT_NAME}_mongo:27017/rocketchat
+      - MONGO_OPLOG_URL=mongodb://${APP_PROJECT_NAME}_mongo:27017/local
+      - MAIL_URL=smtp://smtp.mailgun.org
+    volumes:
+      - ${APP_PATH}uploads:/app/uploads
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/rocketchat/samples/docker/docker-compose.yml

@@ -0,0 +1,10 @@
+services:
+  rocketchat:
+    extends:
+      file: ${SERVICE_ROCKETCHAT_COMPOSE}
+      service: rocketchat
+    environment:
+      - VIRTUAL_HOST=${APP_DOMAINS_STRING}
+      - LETSENCRYPT_HOST=${APP_DOMAINS_STRING}
+      - LETSENCRYPT_EMAIL=${APP_EMAIL}
+      - ROOT_URL=http://${APP_DOMAIN}

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/rocketchat/samples/hubot/scripts/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/rocketchat/samples/uploads/.gitkeep

@@ -0,0 +1 @@
+

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/rocketchat/service.yml

@@ -0,0 +1,8 @@
+name: rocketchat
+tags:
+  - collab
+dependencies:
+  - mongo
+  - proxy
+docker:
+  compose: docker/docker-compose.yml

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/synapse/app_service.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from wexample_wex_addon_app.service.app_service import AppService as BaseAppService
+
+
+class AppService(BaseAppService):
+    def get_workdir_contribution(self) -> dict:
+        from wexample_filestate.const.disk import DiskItemType
+
+        # Synapse container runs as uid 991 (synapse user)
+        return {
+            "children": [
+                {
+                    "name": "synapse",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        {
+                            "name": "data",
+                            "type": DiskItemType.DIRECTORY,
+                            "should_exist": True,
+                            "mode": {
+                                "owner": "991:991",
+                                "permissions": "755",
+                                "recursive": True,
+                            },
+                        }
+                    ],
+                }
+            ]
+        }

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/synapse/commands/service/install.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE, description="Configure synapse service in app config"
+)
+def synapse__service__install(
+    context: ExecutionContext,
+    service: AppService,
+) -> None:
+    app_name = service.app_workdir.get_config().search("global.name").get_str()
+    config_file = service.app_workdir.get_config_file()
+    config = config_file.read_config()
+
+    config.set_by_path(f"service.{service.name}.host", f"{app_name}_{service.name}")
+    config.set_by_path(f"service.{service.name}.port", 8008)
+
+    config_file.write_config(config)
+    service.app_workdir.get_runtime_config(rebuild=True)
+
+    context.io.log(f"Configured synapse service for app '{app_name}'")

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/synapse/commands/service/ready.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_app.response.boolean_response import BooleanResponse
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(type=COMMAND_TYPE_SERVICE, description="Check if synapse homeserver is ready")
+def synapse__service__ready(
+    context: ExecutionContext,
+    service: AppService,
+) -> BooleanResponse:
+    import subprocess
+
+    from wexample_app.response.boolean_response import BooleanResponse
+
+    runtime = service.app_workdir.get_runtime_config()
+    app_project_name = runtime.search("app.project_name").get_str()
+    container_name = f"{app_project_name}_{service.name}"
+
+    result = subprocess.run(
+        [
+            "docker",
+            "exec",
+            container_name,
+            "curl",
+            "-sf",
+            "http://localhost:8008/health",
+        ],
+        capture_output=True,
+    )
+
+    return BooleanResponse(kernel=context.kernel, content=result.returncode == 0)

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/synapse/docker/docker-compose.yml

@@ -0,0 +1,27 @@
+services:
+  synapse:
+    container_name: ${APP_PROJECT_NAME}_synapse
+    image: matrixdotorg/synapse:latest
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default
+    networks:
+      - wex_net
+
+  element:
+    container_name: ${APP_PROJECT_NAME}_element
+    image: vectorim/element-web:latest
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default
+    networks:
+      - wex_net
+
+  synapse_admin:
+    container_name: ${APP_PROJECT_NAME}_synapse_admin
+    image: awesometechnologies/synapse-admin:latest
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default
+    networks:
+      - wex_net

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services/synapse/service.yml

@@ -0,0 +1,5 @@
+name: synapse
+tags:
+  - collab
+docker:
+  compose: docker/docker-compose.yml

wexample_wex_addon_services_collab-0.0.3/src/wexample_wex_addon_services_collab/services_collab_addon_manager.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from typing import Any
+
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_core.common.abstract_addon_manager import AbstractAddonManager
+
+
+@base_class
+class ServicesCollabAddonManager(AbstractAddonManager):
+    @classmethod
+    def get_package_module(cls) -> Any:
+        import wexample_wex_addon_services_collab
+
+        return wexample_wex_addon_services_collab