ChatCoolify 0.2.0__tar.gz → 0.2.2__tar.gz

{chatcoolify-0.2.0/src/ChatCoolify.egg-info → chatcoolify-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ChatCoolify
-Version: 0.2.0
+Version: 0.2.2
 Summary: AI-safe Python client and CLI for the official Coolify API
 Author-email: ChatArch <1073853456@qq.com>
 License-Expression: MIT
@@ -19,8 +19,12 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: chatenv<0.3.0,>=0.2.9
+Requires-Dist: chatenv<0.3.0,>=0.2.10
+Requires-Dist: chatstyle<0.3.0,>=0.2.0
+Requires-Dist: chatlogin<0.3.0,>=0.2.1
 Requires-Dist: click<9.0,>=8.1
+Provides-Extra: comments
+Requires-Dist: ChatComment<0.3.0,>=0.2.2; extra == "comments"
 Provides-Extra: dev
 Requires-Dist: build<2.0,>=1.2; extra == "dev"
 Requires-Dist: pytest<10.0,>=8.0; extra == "dev"
@@ -64,6 +68,8 @@ coolify --tree
 
 ## 最快开始
 
+已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退；平台按项目授权，普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法，其写操作仍需 `--allow-write`。
+
 ```bash
 coolify --base-url https://<coolify-url> health
 ```
@@ -89,6 +95,8 @@ coolify website-plan \
 
 省略 `--domain` 时，计划会请求 Coolify 从已配置的泛域名池自动分配唯一 tenant URL；需要自定义域名时才显式传入 `--domain`。查看完整的 [真实 Git 到 HTTPS 演示](https://arch.gh.wzhecnu.cn/ChatCoolify/self-service-demo/)。
 
+以上为直接原生 API 的低层命令。面向普通协作者的 `coolify platform` 使用项目名分配可读的正式／预览子域名，owner 可在“我的网站”管理页或通过 `domains set` 自定义受管前缀，并用 `domains apply` 应用到已发布网站。新项目默认公开阅读，管理登录与访客留言分离；登录、项目列表、目录上传与明确发布流程见[本地项目平台](https://arch.gh.wzhecnu.cn/ChatCoolify/platform/)。
+
 该命令只输出官方 API payload。真正创建资源需要同时具备 `write` Token 和显式写门：
 
 ```bash
@@ -105,7 +113,7 @@ coolify --allow-write website-create ...
 ## 开发
 
 ```bash
-python -m pip install -e '.[dev,docs]'
+python -m pip install -e '.[dev,docs,comments]'
 python -m pytest -q
 python -m mkdocs build --strict
 python -m build

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/README.md

@@ -29,6 +29,8 @@ coolify --tree
 
 ## 最快开始
 
+已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退；平台按项目授权，普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法，其写操作仍需 `--allow-write`。
+
 ```bash
 coolify --base-url https://<coolify-url> health
 ```
@@ -54,6 +56,8 @@ coolify website-plan \
 
 省略 `--domain` 时，计划会请求 Coolify 从已配置的泛域名池自动分配唯一 tenant URL；需要自定义域名时才显式传入 `--domain`。查看完整的 [真实 Git 到 HTTPS 演示](https://arch.gh.wzhecnu.cn/ChatCoolify/self-service-demo/)。
 
+以上为直接原生 API 的低层命令。面向普通协作者的 `coolify platform` 使用项目名分配可读的正式／预览子域名，owner 可在“我的网站”管理页或通过 `domains set` 自定义受管前缀，并用 `domains apply` 应用到已发布网站。新项目默认公开阅读，管理登录与访客留言分离；登录、项目列表、目录上传与明确发布流程见[本地项目平台](https://arch.gh.wzhecnu.cn/ChatCoolify/platform/)。
+
 该命令只输出官方 API payload。真正创建资源需要同时具备 `write` Token 和显式写门：
 
 ```bash
@@ -70,7 +74,7 @@ coolify --allow-write website-create ...
 ## 开发
 
 ```bash
-python -m pip install -e '.[dev,docs]'
+python -m pip install -e '.[dev,docs,comments]'
 python -m pytest -q
 python -m mkdocs build --strict
 python -m build

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ChatCoolify"
-version = "0.2.0"
+version = "0.2.2"
 description = "AI-safe Python client and CLI for the official Coolify API"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -21,7 +21,9 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
-    "chatenv>=0.2.9,<0.3.0",
+    "chatenv>=0.2.10,<0.3.0",
+    "chatstyle>=0.2.0,<0.3.0",
+    "chatlogin>=0.2.1,<0.3.0",
     "click>=8.1,<9.0",
 ]
 
@@ -38,6 +40,7 @@ coolify = "chatcoolify.cli:main"
 chatcoolify = "chatcoolify.config"
 
 [project.optional-dependencies]
+comments = ["ChatComment>=0.2.2,<0.3.0"]
 dev = [
     "build>=1.2,<2.0",
     "pytest>=8.0,<10.0",

{chatcoolify-0.2.0 → chatcoolify-0.2.2/src/ChatCoolify.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ChatCoolify
-Version: 0.2.0
+Version: 0.2.2
 Summary: AI-safe Python client and CLI for the official Coolify API
 Author-email: ChatArch <1073853456@qq.com>
 License-Expression: MIT
@@ -19,8 +19,12 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: chatenv<0.3.0,>=0.2.9
+Requires-Dist: chatenv<0.3.0,>=0.2.10
+Requires-Dist: chatstyle<0.3.0,>=0.2.0
+Requires-Dist: chatlogin<0.3.0,>=0.2.1
 Requires-Dist: click<9.0,>=8.1
+Provides-Extra: comments
+Requires-Dist: ChatComment<0.3.0,>=0.2.2; extra == "comments"
 Provides-Extra: dev
 Requires-Dist: build<2.0,>=1.2; extra == "dev"
 Requires-Dist: pytest<10.0,>=8.0; extra == "dev"
@@ -64,6 +68,8 @@ coolify --tree
 
 ## 最快开始
 
+已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退；平台按项目授权，普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法，其写操作仍需 `--allow-write`。
+
 ```bash
 coolify --base-url https://<coolify-url> health
 ```
@@ -89,6 +95,8 @@ coolify website-plan \
 
 省略 `--domain` 时，计划会请求 Coolify 从已配置的泛域名池自动分配唯一 tenant URL；需要自定义域名时才显式传入 `--domain`。查看完整的 [真实 Git 到 HTTPS 演示](https://arch.gh.wzhecnu.cn/ChatCoolify/self-service-demo/)。
 
+以上为直接原生 API 的低层命令。面向普通协作者的 `coolify platform` 使用项目名分配可读的正式／预览子域名，owner 可在“我的网站”管理页或通过 `domains set` 自定义受管前缀，并用 `domains apply` 应用到已发布网站。新项目默认公开阅读，管理登录与访客留言分离；登录、项目列表、目录上传与明确发布流程见[本地项目平台](https://arch.gh.wzhecnu.cn/ChatCoolify/platform/)。
+
 该命令只输出官方 API payload。真正创建资源需要同时具备 `write` Token 和显式写门：
 
 ```bash
@@ -105,7 +113,7 @@ coolify --allow-write website-create ...
 ## 开发
 
 ```bash
-python -m pip install -e '.[dev,docs]'
+python -m pip install -e '.[dev,docs,comments]'
 python -m pytest -q
 python -m mkdocs build --strict
 python -m build

chatcoolify-0.2.2/src/ChatCoolify.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChatCoolify.egg-info/PKG-INFO
+src/ChatCoolify.egg-info/SOURCES.txt
+src/ChatCoolify.egg-info/dependency_links.txt
+src/ChatCoolify.egg-info/entry_points.txt
+src/ChatCoolify.egg-info/requires.txt
+src/ChatCoolify.egg-info/top_level.txt
+src/chatcoolify/__init__.py
+src/chatcoolify/cli.py
+src/chatcoolify/client.py
+src/chatcoolify/config.py
+src/chatcoolify/platform.py
+src/chatcoolify/platform_artifact.py
+src/chatcoolify/platform_backend.py
+src/chatcoolify/platform_cli.py
+src/chatcoolify/platform_client.py
+src/chatcoolify/platform_runtime.py
+src/chatcoolify/platform_source.py
+src/chatcoolify/platform_web.py
+tests/test_cli.py
+tests/test_client.py
+tests/test_platform.py
+tests/test_platform_domains.py
+tests/test_platform_management.py
+tests/test_platform_public.py
+tests/test_release_contract.py

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/src/ChatCoolify.egg-info/requires.txt

@@ -1,6 +1,11 @@
-chatenv<0.3.0,>=0.2.9
+chatenv<0.3.0,>=0.2.10
+chatstyle<0.3.0,>=0.2.0
+chatlogin<0.3.0,>=0.2.1
 click<9.0,>=8.1
 
+[comments]
+ChatComment<0.3.0,>=0.2.2
+
 [dev]
 build<2.0,>=1.2
 pytest<10.0,>=8.0

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/src/chatcoolify/__init__.py

@@ -10,7 +10,12 @@ from .client import (
     PublicApplicationSpec,
 )
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
+
+from .platform import PlatformService
+from .platform_client import PlatformClient
+from .platform_artifact import PlatformError
+from .platform_backend import CoolifyBackend
 
 __all__ = [
     "DEFAULT_BASE_URL",
@@ -20,5 +25,9 @@ __all__ = [
     "CoolifyError",
     "CoolifyPermissionError",
     "PublicApplicationSpec",
+    "PlatformService",
+    "PlatformClient",
+    "PlatformError",
+    "CoolifyBackend",
     "__version__",
 ]

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/src/chatcoolify/cli.py

@@ -6,6 +6,7 @@ import json
 from typing import Any
 
 import click
+from chatstyle import add_tree_option
 
 from . import __version__
 from .client import DEFAULT_BASE_URL, CoolifyClient, CoolifyError, PublicApplicationSpec
@@ -26,35 +27,9 @@ def _handle_error(error: CoolifyError) -> None:
     raise click.ClickException(str(error)) from error
 
 
-def _render_tree(command: click.Group, *, brief: bool) -> str:
-    """Render the registered CLI surface instead of maintaining docs by hand."""
-
-    options = ["--help", "--version", "--tree", "--tree-brief", "--base-url", "--allow-write"]
-    lines = [command.name or "coolify"]
-    for option in options:
-        lines.append(f"|- {option}")
-    commands = sorted(command.commands.values(), key=lambda item: item.name)
-    for index, subcommand in enumerate(commands):
-        connector = "`-" if index == len(commands) - 1 else "|-"
-        suffix = "" if brief else f"  # {subcommand.help or subcommand.short_help or ''}".rstrip()
-        lines.append(f"{connector} {subcommand.name}{suffix}")
-    return "\n".join(lines)
-
-
-def _tree_callback(brief: bool):
-    def callback(ctx: click.Context, _param: click.Parameter, value: bool) -> None:
-        if not value or ctx.resilient_parsing:
-            return
-        click.echo(_render_tree(ctx.command, brief=brief))
-        ctx.exit()
-
-    return callback
-
-
 @click.group(name="coolify", context_settings=CONTEXT_SETTINGS)
 @click.version_option(__version__, prog_name="coolify")
-@click.option("--tree", is_flag=True, is_eager=True, expose_value=False, callback=_tree_callback(False), help="Print the registered command tree.")
-@click.option("--tree-brief", is_flag=True, is_eager=True, expose_value=False, callback=_tree_callback(True), help="Print the registered command tree without descriptions.")
+@add_tree_option()
 @click.option(
     "--base-url",
     envvar="COOLIFY_BASE_URL",
@@ -311,5 +286,9 @@ def deploy(ctx: click.Context, application_uuid: str, force: bool) -> None:
         _handle_error(error)
 
 
+from .platform_cli import platform
+main.add_command(platform)
+
+
 if __name__ == "__main__":  # pragma: no cover
     main()

{chatcoolify-0.2.0 → chatcoolify-0.2.2}/src/chatcoolify/client.py

@@ -371,7 +371,10 @@ def _error_message(error: HTTPError, token: str | None) -> str:
         raw = error.read().decode("utf-8", errors="replace")
         parsed = json.loads(raw)
         if isinstance(parsed, Mapping) and isinstance(parsed.get("message"), str):
-            return _redact_sensitive_text(parsed["message"], token)[:500]
+            fields = parsed.get('errors', {})
+            safe_fields = [key for key in fields if isinstance(key,str) and re.fullmatch(r'[A-Za-z0-9_.]{1,80}',key)] if isinstance(fields,Mapping) else []
+            suffix = ' (fields: ' + ', '.join(safe_fields[:20]) + ')' if safe_fields else ''
+            return _redact_sensitive_text(parsed["message"], token)[:500] + suffix
     except (OSError, UnicodeDecodeError, json.JSONDecodeError):
         pass
     return _redact_sensitive_text(str(error.reason or "request failed"), token)

chatcoolify-0.2.2/src/chatcoolify/config.py

@@ -0,0 +1,83 @@
+"""ChatEnv schema for ChatCoolify credentials and API endpoint."""
+
+from __future__ import annotations
+
+import os
+
+from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
+
+
+class CoolifyConfig(BaseEnvConfig):
+    """Typed configuration for the existing Coolify control plane."""
+
+    _title = "Coolify Configuration"
+    _aliases = ["coolify", "chatcoolify"]
+    _storage_dir = "Coolify"
+
+    COOLIFY_BASE_URL = EnvField(
+        "COOLIFY_BASE_URL",
+        default="https://coolify.example.com",
+        desc="Public HTTPS URL of the Coolify control plane",
+    )
+    COOLIFY_API_TOKEN = EnvField(
+        "COOLIFY_API_TOKEN",
+        desc="Team-scoped Coolify API token; use the minimum required permissions and expiration",
+        is_sensitive=True,
+    )
+
+    @classmethod
+    def test(cls) -> None:
+        """Validate a configured endpoint, while keeping unconfigured schemas offline."""
+
+        from .client import DEFAULT_BASE_URL, CoolifyClient, CoolifyError
+
+        profile_values = EnvStore(get_paths().envs_dir).load_active(cls)
+        base_url = os.getenv("COOLIFY_BASE_URL") or profile_values.get("COOLIFY_BASE_URL") or DEFAULT_BASE_URL
+        if base_url == DEFAULT_BASE_URL:
+            print("ChatCoolify schema loaded; configure COOLIFY_BASE_URL to run a health check.")
+            return
+        try:
+            result = CoolifyClient(base_url).health()
+        except CoolifyError as error:
+            raise RuntimeError(f"Coolify health check failed: {error}") from error
+        if not result.get("ok"):
+            raise RuntimeError("Coolify health check did not report OK")
+        print(f"Coolify health check passed for {base_url}.")
+
+
+class PlatformConfig(BaseEnvConfig):
+    """A user's platform endpoint; opaque sessions live in TokenStore."""
+    _title = 'ChatCoolify Platform'
+    _aliases = ['coolify-platform']
+    _storage_dir = 'CoolifyPlatform'
+    CHATCOOLIFY_PLATFORM_URL = EnvField('CHATCOOLIFY_PLATFORM_URL',desc='HTTPS origin of the project platform')
+
+    @classmethod
+    def test(cls):
+        print('Platform endpoint schema loaded; login sessions use the private TokenStore.')
+
+
+class PlatformServerConfig(BaseEnvConfig):
+    """Operator-only configuration, never returned by the public platform API."""
+    _title = 'ChatCoolify Platform Server'
+    _aliases = ['coolify-platform-server']
+    _storage_dir = 'CoolifyPlatformServer'
+    COOLIFY_BASE_URL = EnvField('COOLIFY_BASE_URL',desc='Existing native control origin')
+    COOLIFY_API_TOKEN = EnvField('COOLIFY_API_TOKEN',is_sensitive=True,desc='Server-only native Team service token')
+    CHATCOOLIFY_PLATFORM_DATA = EnvField('CHATCOOLIFY_PLATFORM_DATA',default='/data',desc='Persistent platform root')
+    CHATCOOLIFY_CONTROL_URL = EnvField('CHATCOOLIFY_CONTROL_URL',desc='Public platform HTTPS origin')
+    CHATCOOLIFY_DOMAIN_SUFFIX = EnvField('CHATCOOLIFY_DOMAIN_SUFFIX',desc='Operator-managed wildcard DNS suffix; defaults to the parent of platform.<suffix>')
+    CHATCOOLIFY_RESERVED_HOSTS = EnvField('CHATCOOLIFY_RESERVED_HOSTS',desc='Comma-separated additional operator-reserved public hostnames outside native Team inventory')
+    CHATCOOLIFY_INTERNAL_URL = EnvField('CHATCOOLIFY_INTERNAL_URL',desc='Private platform origin for frontend authorization')
+    CHATCOOLIFY_SERVER_UUID = EnvField('CHATCOOLIFY_SERVER_UUID',desc='Operator-approved native server')
+    CHATCOOLIFY_TEAM_ID = EnvField('CHATCOOLIFY_TEAM_ID',desc='Native service Team ID')
+    CHATCOOLIFY_SOURCE_URL = EnvField('CHATCOOLIFY_SOURCE_URL',desc='Private read-only Git source base URL')
+    CHATCOOLIFY_SOURCE_KEY_UUID = EnvField('CHATCOOLIFY_SOURCE_KEY_UUID',desc='Native key resource for restricted source clone')
+    CHATCOOLIFY_EXTERNAL_TLS = EnvField('CHATCOOLIFY_EXTERNAL_TLS',default='false',desc='Existing external edge terminates HTTPS; native routing remains HTTP')
+
+    @classmethod
+    def test(cls):
+        print('Platform server schema loaded; credentials stay server-side.')
+
+
+__all__ = ["CoolifyConfig", "PlatformConfig", "PlatformServerConfig"]