ChatCoolify 0.2.3__tar.gz → 0.2.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. {chatcoolify-0.2.3/src/ChatCoolify.egg-info → chatcoolify-0.2.5}/PKG-INFO +17 -6
  2. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/README.md +16 -5
  3. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/pyproject.toml +1 -1
  4. {chatcoolify-0.2.3 → chatcoolify-0.2.5/src/ChatCoolify.egg-info}/PKG-INFO +17 -6
  5. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/ChatCoolify.egg-info/SOURCES.txt +4 -0
  6. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/__init__.py +3 -2
  7. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/config.py +26 -3
  8. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform.py +6 -5
  9. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_artifact.py +81 -18
  10. chatcoolify-0.2.5/src/chatcoolify/platform_catalog.py +79 -0
  11. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_cli.py +24 -4
  12. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_client.py +58 -10
  13. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_source.py +4 -4
  14. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_web.py +19 -14
  15. chatcoolify-0.2.5/tests/test_platform_config_limits.py +376 -0
  16. chatcoolify-0.2.5/tests/test_platform_home_catalog.py +91 -0
  17. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_public_patch_version.py +3 -3
  18. chatcoolify-0.2.5/tests/test_public_release_docs.py +13 -0
  19. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/LICENSE +0 -0
  20. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/setup.cfg +0 -0
  21. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/ChatCoolify.egg-info/dependency_links.txt +0 -0
  22. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/ChatCoolify.egg-info/entry_points.txt +0 -0
  23. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/ChatCoolify.egg-info/requires.txt +0 -0
  24. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/ChatCoolify.egg-info/top_level.txt +0 -0
  25. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/cli.py +0 -0
  26. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/client.py +0 -0
  27. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_backend.py +0 -0
  28. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/src/chatcoolify/platform_runtime.py +0 -0
  29. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_cli.py +0 -0
  30. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_client.py +0 -0
  31. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_platform.py +0 -0
  32. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_platform_domains.py +0 -0
  33. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_platform_management.py +0 -0
  34. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_platform_public.py +0 -0
  35. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_platform_public_projection.py +0 -0
  36. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_release_contract.py +0 -0
  37. {chatcoolify-0.2.3 → chatcoolify-0.2.5}/tests/test_site_management.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ChatCoolify
3
- Version: 0.2.3
3
+ Version: 0.2.5
4
4
  Summary: AI-safe Python client and CLI for the official Coolify API
5
5
  Author-email: ChatArch <1073853456@qq.com>
6
6
  License-Expression: MIT
@@ -68,7 +68,19 @@ coolify --tree
68
68
 
69
69
  ## 最快开始
70
70
 
71
- 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
71
+ 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。
72
+
73
+ ```bash
74
+ # 按隐藏交互配置平台地址、账号和密码;不把密码写到命令参数。
75
+ chatenv new work -t coolify-platform -i
76
+ chatenv test work -t coolify-platform
77
+ coolify platform --profile work login
78
+ coolify platform --profile work limits
79
+ ```
80
+
81
+ `coolify-platform` 的 ChatEnv 字段是 `CHATCOOLIFY_PLATFORM_URL`、`CHATCOOLIFY_PLATFORM_USERNAME`、敏感的 `CHATCOOLIFY_PLATFORM_PASSWORD`;TokenStore 只缓存会话。默认 ZIP 上限1 GiB,解包大小和条目数默认不限,operator 可通过服务端 ChatEnv 调整,0表示不限。客户端自动读取有效策略;只有旧版服务明确404时兼容旧策略。
82
+
83
+ 以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
72
84
 
73
85
  ```bash
74
86
  coolify --base-url https://<coolify-url> health
@@ -131,9 +143,8 @@ MIT。
131
143
 
132
144
  后端必须独立验证准确的方法、路径/查询、正文与站点 read 权限,并生成明确允许的公开字段。不要把原始项目材料、来源连接、人工私人记录或凭据直接当成公开响应。投影路径只读;私有读取、管理写入和 CSRF 仍执行各自的认证规则。项目可见性是项目级策略,切换前同时核对预览与生产范围,不以一层登录遮罩替代后端权限。
133
145
 
134
- 本工作树的 `0.2.2+access.1` 是基于已发布 `0.2.2` 的私有验证构建,不是 PyPI 正式发版。
135
-
146
+ 正式发布包包含上述签名只读投影能力;是否允许公开读取仍由项目的持久化访问策略决定。
136
147
 
137
- ### Native project access management
148
+ ### 原生项目访问管理
138
149
 
139
- Authenticated project owners can follow `GET /__platform/manage` to the existing console project anchor. Browser settings use the persisted project visibility for both production and preview, with an explicit public confirmation, stale-mode precondition and GET readback after saving. Ordinary reader accounts cannot manage access. This private build does not add or rename CLI commands.
150
+ 已认证的项目所有者可通过 `GET /__platform/manage` 进入原生控制台的准确项目设置。正式站与预览共用持久化的访问模式;公开切换需要明确确认,保存时验证预期的旧模式并再次读取结果。普通阅读账号不能管理访问权限。该能力不新增或改名 CLI 命令。
@@ -29,7 +29,19 @@ coolify --tree
29
29
 
30
30
  ## 最快开始
31
31
 
32
- 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
32
+ 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。
33
+
34
+ ```bash
35
+ # 按隐藏交互配置平台地址、账号和密码;不把密码写到命令参数。
36
+ chatenv new work -t coolify-platform -i
37
+ chatenv test work -t coolify-platform
38
+ coolify platform --profile work login
39
+ coolify platform --profile work limits
40
+ ```
41
+
42
+ `coolify-platform` 的 ChatEnv 字段是 `CHATCOOLIFY_PLATFORM_URL`、`CHATCOOLIFY_PLATFORM_USERNAME`、敏感的 `CHATCOOLIFY_PLATFORM_PASSWORD`;TokenStore 只缓存会话。默认 ZIP 上限1 GiB,解包大小和条目数默认不限,operator 可通过服务端 ChatEnv 调整,0表示不限。客户端自动读取有效策略;只有旧版服务明确404时兼容旧策略。
43
+
44
+ 以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
33
45
 
34
46
  ```bash
35
47
  coolify --base-url https://<coolify-url> health
@@ -92,9 +104,8 @@ MIT。
92
104
 
93
105
  后端必须独立验证准确的方法、路径/查询、正文与站点 read 权限,并生成明确允许的公开字段。不要把原始项目材料、来源连接、人工私人记录或凭据直接当成公开响应。投影路径只读;私有读取、管理写入和 CSRF 仍执行各自的认证规则。项目可见性是项目级策略,切换前同时核对预览与生产范围,不以一层登录遮罩替代后端权限。
94
106
 
95
- 本工作树的 `0.2.2+access.1` 是基于已发布 `0.2.2` 的私有验证构建,不是 PyPI 正式发版。
96
-
107
+ 正式发布包包含上述签名只读投影能力;是否允许公开读取仍由项目的持久化访问策略决定。
97
108
 
98
- ### Native project access management
109
+ ### 原生项目访问管理
99
110
 
100
- Authenticated project owners can follow `GET /__platform/manage` to the existing console project anchor. Browser settings use the persisted project visibility for both production and preview, with an explicit public confirmation, stale-mode precondition and GET readback after saving. Ordinary reader accounts cannot manage access. This private build does not add or rename CLI commands.
111
+ 已认证的项目所有者可通过 `GET /__platform/manage` 进入原生控制台的准确项目设置。正式站与预览共用持久化的访问模式;公开切换需要明确确认,保存时验证预期的旧模式并再次读取结果。普通阅读账号不能管理访问权限。该能力不新增或改名 CLI 命令。
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "ChatCoolify"
7
- version = "0.2.3"
7
+ version = "0.2.5"
8
8
  description = "AI-safe Python client and CLI for the official Coolify API"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ChatCoolify
3
- Version: 0.2.3
3
+ Version: 0.2.5
4
4
  Summary: AI-safe Python client and CLI for the official Coolify API
5
5
  Author-email: ChatArch <1073853456@qq.com>
6
6
  License-Expression: MIT
@@ -68,7 +68,19 @@ coolify --tree
68
68
 
69
69
  ## 最快开始
70
70
 
71
- 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
71
+ 已有平台账号可通过 `coolify platform` 完成本地目录上传、原生预览、显式发布及回退;平台按项目授权,普通用户不持有原生 Team token。见[本地项目平台](docs/platform.md)。
72
+
73
+ ```bash
74
+ # 按隐藏交互配置平台地址、账号和密码;不把密码写到命令参数。
75
+ chatenv new work -t coolify-platform -i
76
+ chatenv test work -t coolify-platform
77
+ coolify platform --profile work login
78
+ coolify platform --profile work limits
79
+ ```
80
+
81
+ `coolify-platform` 的 ChatEnv 字段是 `CHATCOOLIFY_PLATFORM_URL`、`CHATCOOLIFY_PLATFORM_USERNAME`、敏感的 `CHATCOOLIFY_PLATFORM_PASSWORD`;TokenStore 只缓存会话。默认 ZIP 上限1 GiB,解包大小和条目数默认不限,operator 可通过服务端 ChatEnv 调整,0表示不限。客户端自动读取有效策略;只有旧版服务明确404时兼容旧策略。
82
+
83
+ 以下保留原生 Coolify 客户端用法,其写操作仍需 `--allow-write`。
72
84
 
73
85
  ```bash
74
86
  coolify --base-url https://<coolify-url> health
@@ -131,9 +143,8 @@ MIT。
131
143
 
132
144
  后端必须独立验证准确的方法、路径/查询、正文与站点 read 权限,并生成明确允许的公开字段。不要把原始项目材料、来源连接、人工私人记录或凭据直接当成公开响应。投影路径只读;私有读取、管理写入和 CSRF 仍执行各自的认证规则。项目可见性是项目级策略,切换前同时核对预览与生产范围,不以一层登录遮罩替代后端权限。
133
145
 
134
- 本工作树的 `0.2.2+access.1` 是基于已发布 `0.2.2` 的私有验证构建,不是 PyPI 正式发版。
135
-
146
+ 正式发布包包含上述签名只读投影能力;是否允许公开读取仍由项目的持久化访问策略决定。
136
147
 
137
- ### Native project access management
148
+ ### 原生项目访问管理
138
149
 
139
- Authenticated project owners can follow `GET /__platform/manage` to the existing console project anchor. Browser settings use the persisted project visibility for both production and preview, with an explicit public confirmation, stale-mode precondition and GET readback after saving. Ordinary reader accounts cannot manage access. This private build does not add or rename CLI commands.
150
+ 已认证的项目所有者可通过 `GET /__platform/manage` 进入原生控制台的准确项目设置。正式站与预览共用持久化的访问模式;公开切换需要明确确认,保存时验证预期的旧模式并再次读取结果。普通阅读账号不能管理访问权限。该能力不新增或改名 CLI 命令。
@@ -14,6 +14,7 @@ src/chatcoolify/config.py
14
14
  src/chatcoolify/platform.py
15
15
  src/chatcoolify/platform_artifact.py
16
16
  src/chatcoolify/platform_backend.py
17
+ src/chatcoolify/platform_catalog.py
17
18
  src/chatcoolify/platform_cli.py
18
19
  src/chatcoolify/platform_client.py
19
20
  src/chatcoolify/platform_runtime.py
@@ -22,10 +23,13 @@ src/chatcoolify/platform_web.py
22
23
  tests/test_cli.py
23
24
  tests/test_client.py
24
25
  tests/test_platform.py
26
+ tests/test_platform_config_limits.py
25
27
  tests/test_platform_domains.py
28
+ tests/test_platform_home_catalog.py
26
29
  tests/test_platform_management.py
27
30
  tests/test_platform_public.py
28
31
  tests/test_platform_public_projection.py
29
32
  tests/test_public_patch_version.py
33
+ tests/test_public_release_docs.py
30
34
  tests/test_release_contract.py
31
35
  tests/test_site_management.py
@@ -10,11 +10,11 @@ from .client import (
10
10
  PublicApplicationSpec,
11
11
  )
12
12
 
13
- __version__ = "0.2.3"
13
+ __version__ = "0.2.5"
14
14
 
15
15
  from .platform import PlatformService
16
16
  from .platform_client import PlatformClient
17
- from .platform_artifact import PlatformError
17
+ from .platform_artifact import ArtifactLimits, PlatformError
18
18
  from .platform_backend import CoolifyBackend
19
19
 
20
20
  __all__ = [
@@ -28,6 +28,7 @@ __all__ = [
28
28
  "PlatformService",
29
29
  "PlatformClient",
30
30
  "PlatformError",
31
+ "ArtifactLimits",
31
32
  "CoolifyBackend",
32
33
  "__version__",
33
34
  ]
@@ -46,15 +46,32 @@ class CoolifyConfig(BaseEnvConfig):
46
46
 
47
47
 
48
48
  class PlatformConfig(BaseEnvConfig):
49
- """A user's platform endpoint; opaque sessions live in TokenStore."""
49
+ """A user's endpoint and credentials; issued sessions live in TokenStore."""
50
50
  _title = 'ChatCoolify Platform'
51
51
  _aliases = ['coolify-platform']
52
52
  _storage_dir = 'CoolifyPlatform'
53
53
  CHATCOOLIFY_PLATFORM_URL = EnvField('CHATCOOLIFY_PLATFORM_URL',desc='HTTPS origin of the project platform')
54
+ CHATCOOLIFY_PLATFORM_USERNAME = EnvField('CHATCOOLIFY_PLATFORM_USERNAME',desc='Invited platform account username')
55
+ CHATCOOLIFY_PLATFORM_PASSWORD = EnvField('CHATCOOLIFY_PLATFORM_PASSWORD',is_sensitive=True,desc='Platform account password; opaque sessions remain in TokenStore')
54
56
 
55
57
  @classmethod
56
58
  def test(cls):
57
- print('Platform endpoint schema loaded; login sessions use the private TokenStore.')
59
+ from .platform_client import PlatformClient
60
+ url=cls.CHATCOOLIFY_PLATFORM_URL.value
61
+ if not url:
62
+ print('Platform schema loaded; configure URL and account credentials to test sign-in.')
63
+ return
64
+ client=PlatformClient(url)
65
+ username=cls.CHATCOOLIFY_PLATFORM_USERNAME.value
66
+ password=cls.CHATCOOLIFY_PLATFORM_PASSWORD.value
67
+ if not username or not password:
68
+ raise RuntimeError('Configure platform username and password to test sign-in')
69
+ client.login(username,password)
70
+ try:
71
+ client.request('/session')
72
+ finally:
73
+ client.request('/logout',method='POST',payload={})
74
+ print('Platform account authentication passed; temporary test session revoked.')
58
75
 
59
76
 
60
77
  class PlatformServerConfig(BaseEnvConfig):
@@ -74,10 +91,16 @@ class PlatformServerConfig(BaseEnvConfig):
74
91
  CHATCOOLIFY_SOURCE_URL = EnvField('CHATCOOLIFY_SOURCE_URL',desc='Private read-only Git source base URL')
75
92
  CHATCOOLIFY_SOURCE_KEY_UUID = EnvField('CHATCOOLIFY_SOURCE_KEY_UUID',desc='Native key resource for restricted source clone')
76
93
  CHATCOOLIFY_EXTERNAL_TLS = EnvField('CHATCOOLIFY_EXTERNAL_TLS',default='false',desc='Existing external edge terminates HTTPS; native routing remains HTTP')
94
+ CHATCOOLIFY_MAX_UPLOAD_BYTES = EnvField('CHATCOOLIFY_MAX_UPLOAD_BYTES',default='1073741824',desc='Maximum ZIP bytes, default 1 GiB; 0 means unlimited')
95
+ CHATCOOLIFY_MAX_EXPANDED_BYTES = EnvField('CHATCOOLIFY_MAX_EXPANDED_BYTES',default='0',desc='Maximum expanded artifact bytes; 0 means unlimited')
96
+ CHATCOOLIFY_MAX_ARTIFACT_FILES = EnvField('CHATCOOLIFY_MAX_ARTIFACT_FILES',default='0',desc='Maximum archive file/directory entries; 0 means unlimited')
77
97
 
78
98
  @classmethod
79
99
  def test(cls):
80
- print('Platform server schema loaded; credentials stay server-side.')
100
+ from .platform_artifact import ArtifactLimits
101
+ ArtifactLimits.from_values({name:getattr(cls,name).value for name in (
102
+ 'CHATCOOLIFY_MAX_UPLOAD_BYTES','CHATCOOLIFY_MAX_EXPANDED_BYTES','CHATCOOLIFY_MAX_ARTIFACT_FILES')})
103
+ print('Platform server artifact policy valid; credentials stay server-side.')
81
104
 
82
105
 
83
106
  __all__ = ["CoolifyConfig", "PlatformConfig", "PlatformServerConfig"]
@@ -21,7 +21,7 @@ import uuid
21
21
 
22
22
  from chatlogin import ManagedUsers, ManagedError, Role
23
23
 
24
- from .platform_artifact import PlatformError, validate_archive, digest
24
+ from .platform_artifact import ArtifactLimits, PlatformError, validate_archive, digest
25
25
  from .platform_source import GitSources,frontend_files
26
26
 
27
27
 
@@ -52,7 +52,7 @@ def domain_hostname(value):
52
52
 
53
53
  class PlatformService:
54
54
  """Importable service; HTTP/CLI adapters do not own lifecycle decisions."""
55
- def __init__(self, root, backend, *, control_url, internal_url=None, domain_suffix=None, reserved_hostnames=()):
55
+ def __init__(self, root, backend, *, control_url, internal_url=None, domain_suffix=None, reserved_hostnames=(), artifact_limits=None):
56
56
  self.root = Path(root).resolve()
57
57
  self.root.mkdir(parents=True, exist_ok=True, mode=0o700)
58
58
  self.root.chmod(0o700)
@@ -60,6 +60,7 @@ class PlatformService:
60
60
  self.users = ManagedUsers.for_instance('chatcoolify-platform', home=self.root / 'identity', ttl=86400)
61
61
  self.sources = GitSources(self.root / 'repos')
62
62
  self.backend = backend
63
+ self.artifact_limits = artifact_limits if artifact_limits is not None else ArtifactLimits()
63
64
  self.control_url = control_url.rstrip('/')
64
65
  self.internal_url = (internal_url or control_url).rstrip('/')
65
66
  control_host=urlsplit(self.control_url).hostname or ''
@@ -479,11 +480,11 @@ class PlatformService:
479
480
  return {'project_id':project_id,'user_id':user_id,'role':role}
480
481
 
481
482
  def upload(self, actor, project_id, data, *, original_commit=None):
482
- self.check(actor,project_id,'deploy'); validate_archive(data)
483
+ self.check(actor,project_id,'deploy'); validate_archive(data,limits=self.artifact_limits,read_files=False)
483
484
  if original_commit is not None and not re.fullmatch(r'[0-9a-f]{40,64}',original_commit):
484
485
  raise PlatformError(422,'Invalid original source commit')
485
486
  sha = digest(data)
486
- source_files,docker_digest=frontend_files(data)
487
+ source_files,docker_digest=frontend_files(data,limits=self.artifact_limits)
487
488
  with self.lock:
488
489
  with self.connection() as db:
489
490
  row = db.execute('SELECT * FROM releases WHERE project_id=? AND artifact_sha256=? AND dockerfile_sha256=?',(project_id,sha,docker_digest)).fetchone()
@@ -552,7 +553,7 @@ class PlatformService:
552
553
  # with the same website bytes and the current guarded runtime.
553
554
  if plan['desired_url']!=plan['current_url'] or len(urls)>1:
554
555
  archive=self.root/'artifacts'/(release['artifact_sha256']+'.zip')
555
- if not archive.is_file() or frontend_files(archive.read_bytes())[1]!=release['dockerfile_sha256']:
556
+ if not archive.is_file() or frontend_files(archive.read_bytes(),limits=self.artifact_limits)[1]!=release['dockerfile_sha256']:
556
557
  raise PlatformError(409,'Upload the site again with the current runtime before changing domains or using legacy aliases')
557
558
  deployment_id = uuid.uuid4().hex
558
559
  db.execute('INSERT INTO deployments VALUES(?,?,?,?,?,?,?,?,?)',
@@ -3,6 +3,7 @@ from __future__ import annotations
3
3
 
4
4
  import hashlib
5
5
  import io
6
+ from dataclasses import asdict, dataclass
6
7
  from pathlib import Path, PurePosixPath
7
8
  import stat
8
9
  import zipfile
@@ -10,9 +11,9 @@ import zlib
10
11
 
11
12
  from .client import CoolifyError
12
13
 
13
- MAX_UPLOAD = 8 * 1024 * 1024
14
- MAX_EXPANDED = 32 * 1024 * 1024
15
- MAX_FILES = 2000
14
+ MAX_UPLOAD = 1024 * 1024 * 1024
15
+ MAX_EXPANDED = 0
16
+ MAX_FILES = 0
16
17
 
17
18
 
18
19
  class PlatformError(CoolifyError):
@@ -21,6 +22,50 @@ class PlatformError(CoolifyError):
21
22
  super().__init__(detail)
22
23
 
23
24
 
25
+ @dataclass(frozen=True)
26
+ class ArtifactLimits:
27
+ """Artifact policy; zero disables that business-size/count limit."""
28
+ max_upload_bytes: int = MAX_UPLOAD
29
+ max_expanded_bytes: int = MAX_EXPANDED
30
+ max_files: int = MAX_FILES
31
+
32
+ def __post_init__(self):
33
+ for value in asdict(self).values():
34
+ if isinstance(value, bool) or not isinstance(value, int) or value < 0:
35
+ raise PlatformError(422, 'Artifact limits must be nonnegative integers; zero means unlimited')
36
+
37
+ def as_dict(self):
38
+ return asdict(self)
39
+
40
+ @classmethod
41
+ def from_values(cls, values):
42
+ fields = {'max_upload_bytes': 'CHATCOOLIFY_MAX_UPLOAD_BYTES',
43
+ 'max_expanded_bytes': 'CHATCOOLIFY_MAX_EXPANDED_BYTES',
44
+ 'max_files': 'CHATCOOLIFY_MAX_ARTIFACT_FILES'}
45
+ parsed = {}
46
+ for name, key in fields.items():
47
+ raw = values.get(key)
48
+ if raw is None or raw == '':
49
+ continue
50
+ if isinstance(raw, bool) or not isinstance(raw, (str, int)):
51
+ raise PlatformError(422, 'Artifact limits must be nonnegative integers; zero means unlimited')
52
+ try:
53
+ parsed[name] = int(raw)
54
+ except (ValueError, TypeError):
55
+ raise PlatformError(422, 'Artifact limits must be nonnegative integers; zero means unlimited') from None
56
+ return cls(**parsed)
57
+
58
+ @classmethod
59
+ def from_payload(cls, value):
60
+ keys = {'max_upload_bytes', 'max_expanded_bytes', 'max_files'}
61
+ if not isinstance(value, dict) or set(value) != keys:
62
+ raise PlatformError(502, 'Platform returned an invalid artifact policy')
63
+ try:
64
+ return cls(**value)
65
+ except PlatformError:
66
+ raise PlatformError(502, 'Platform returned an invalid artifact policy') from None
67
+
68
+
24
69
  def safe_name(name):
25
70
  path = PurePosixPath(name)
26
71
  if (not name or len(name) > 512 or path.is_absolute() or '\\' in name
@@ -33,16 +78,17 @@ def safe_name(name):
33
78
  return path
34
79
 
35
80
 
36
- def validate_archive(data):
37
- if not isinstance(data, bytes) or len(data) > MAX_UPLOAD:
38
- raise PlatformError(413, 'Artifact exceeds 8 MiB upload limit')
81
+ def validate_archive(data, *, limits=None, read_files=True):
82
+ limits = limits or ArtifactLimits()
83
+ if not isinstance(data, bytes) or (limits.max_upload_bytes and len(data) > limits.max_upload_bytes):
84
+ raise PlatformError(413, 'Artifact exceeds configured upload limit')
39
85
  files = {}
40
86
  entries=set()
41
87
  directories=set()
42
88
  total = 0
43
89
  try:
44
90
  with zipfile.ZipFile(io.BytesIO(data)) as z:
45
- if len(z.infolist()) > MAX_FILES:
91
+ if limits.max_files and len(z.infolist()) > limits.max_files:
46
92
  raise PlatformError(413, 'Too many artifact entries')
47
93
  for entry in z.infolist():
48
94
  name = entry.filename.rstrip('/') if entry.is_dir() else entry.filename
@@ -58,13 +104,21 @@ def validate_archive(data):
58
104
  if name in files:
59
105
  raise PlatformError(422, 'Duplicate artifact path')
60
106
  total += entry.file_size
61
- if total > MAX_EXPANDED:
62
- raise PlatformError(413, 'Expanded artifact exceeds 32 MiB')
107
+ if limits.max_expanded_bytes and total > limits.max_expanded_bytes:
108
+ raise PlatformError(413, 'Expanded artifact exceeds configured limit')
63
109
  with z.open(entry) as stream:
64
- content = stream.read(min(entry.file_size + 1, MAX_EXPANDED + 1))
65
- if len(content) != entry.file_size:
110
+ chunks = [] if read_files else None
111
+ actual_size = 0
112
+ while True:
113
+ chunk = stream.read(1024 * 1024)
114
+ if not chunk:
115
+ break
116
+ actual_size += len(chunk)
117
+ if chunks is not None:
118
+ chunks.append(chunk)
119
+ if actual_size != entry.file_size:
66
120
  raise PlatformError(422, 'Artifact entry size mismatch')
67
- files[name] = content
121
+ files[name] = b''.join(chunks) if chunks is not None else b''
68
122
  for name in entries:
69
123
  if (name in files and name in directories) or any(str(parent) in files for parent in PurePosixPath(name).parents if str(parent)!='.'):
70
124
  raise PlatformError(422,'Artifact file/directory conflict')
@@ -77,7 +131,8 @@ def validate_archive(data):
77
131
  return files
78
132
 
79
133
 
80
- def make_archive(directory):
134
+ def make_archive(directory, *, limits=None):
135
+ limits = limits or ArtifactLimits()
81
136
  root = Path(directory).resolve(strict=True)
82
137
  if not root.is_dir():
83
138
  raise PlatformError(422, 'Frontend directory required')
@@ -91,21 +146,29 @@ def make_archive(directory):
91
146
  raise PlatformError(422, 'Frontend contains a symlink or special file')
92
147
  if path.is_file():
93
148
  paths.append((name, path))
94
- if len(paths) > MAX_FILES:
149
+ if limits.max_files and len(paths) > limits.max_files:
95
150
  raise PlatformError(413, 'Too many frontend files')
96
151
  stream = io.BytesIO()
97
152
  total = 0
98
153
  with zipfile.ZipFile(stream, 'w', compression=zipfile.ZIP_DEFLATED) as z:
99
154
  for name, path in paths:
100
155
  total += path.stat().st_size
101
- if total > MAX_EXPANDED:
102
- raise PlatformError(413, 'Frontend exceeds 32 MiB')
156
+ if limits.max_expanded_bytes and total > limits.max_expanded_bytes:
157
+ raise PlatformError(413, 'Frontend exceeds configured expanded limit')
103
158
  info = zipfile.ZipInfo(name, date_time=(2020, 1, 1, 0, 0, 0))
104
159
  info.compress_type = zipfile.ZIP_DEFLATED
105
160
  info.external_attr = (stat.S_IFREG | 0o644) << 16
106
- z.writestr(info, path.read_bytes())
161
+ info.file_size = path.stat().st_size
162
+ with path.open('rb') as source, z.open(info, 'w') as destination:
163
+ while True:
164
+ chunk = source.read(1024 * 1024)
165
+ if not chunk:
166
+ break
167
+ destination.write(chunk)
168
+ if limits.max_upload_bytes and stream.tell() > limits.max_upload_bytes:
169
+ raise PlatformError(413, 'Artifact exceeds configured upload limit')
107
170
  result = stream.getvalue()
108
- validate_archive(result)
171
+ validate_archive(result, limits=limits, read_files=False)
109
172
  return result
110
173
 
111
174
 
@@ -0,0 +1,79 @@
1
+ """Progressively enhanced, authorization-preserving website catalog presentation."""
2
+ from __future__ import annotations
3
+
4
+ import hashlib
5
+ import html
6
+ from urllib.parse import urlsplit
7
+
8
+
9
+ def render_card(project, addresses, management):
10
+ """Render only the project's already-authorized data, never probe its sites."""
11
+ escape = lambda value: html.escape(str(value or ''), quote=True)
12
+ environments = {row['environment']: row for row in addresses['environments']}
13
+ production = environments.get('production', {}).get('current_url')
14
+ preview = environments.get('preview', {}).get('current_url')
15
+ state = 'published' if production else ('preview' if preview else 'draft')
16
+ state_label = {'published': '已发布', 'preview': '仅预览', 'draft': '尚未发布'}[state]
17
+ role = {'owner': '所有者', 'deployer': '可部署', 'viewer': '可阅读'}.get(project['role'], project['role'])
18
+ visibility = '公开' if project['visibility'] == 'public' else '仅登录'
19
+ name, slug = project['name'], project['slug']
20
+ project_id = escape(project['id'])
21
+ search = ' '.join([name, slug] + [str(row.get(key) or '')
22
+ for row in addresses['environments'] for key in ('current_url', 'desired_url')])
23
+ color = int(hashlib.sha256(project['id'].encode()).hexdigest()[:2], 16) % 4
24
+ icon = escape(name.strip()[:1] or slug[:1]).upper()
25
+ current = production or preview
26
+ address = escape(urlsplit(current).netloc) if current else '发布后显示访问地址'
27
+ actions = []
28
+ if production:
29
+ actions.append(f'<a class="site-open" href="{escape(production)}" target="_blank" rel="noopener noreferrer">打开网站 <span aria-hidden="true">↗</span></a>')
30
+ if preview:
31
+ actions.append(f'<a class="site-preview" href="{escape(preview)}" target="_blank" rel="noopener noreferrer">打开预览 <span aria-hidden="true">↗</span></a>')
32
+ if not current:
33
+ actions.append('<span class="site-unpublished">尚无可访问入口</span>')
34
+ actions.append(f'<a class="site-manage" data-manage="project-{project_id}" href="#project-{project_id}">管理</a>')
35
+ return (f'<article class="site-card" id="project-{project_id}" data-name="{escape(name)}" '
36
+ f'data-search="{escape(search)}" data-state="{state}" data-visibility="{escape(project["visibility"])}">'
37
+ f'<div class="site-top"><div class="site-icon tone-{color}" aria-hidden="true">{icon}</div>'
38
+ f'<div class="site-heading"><div class="site-meta"><span class="site-state state-{state}">{state_label}</span>'
39
+ f'<span class="site-visibility">{visibility}</span></div><h2>{escape(name)}</h2>'
40
+ f'<p class="site-slug">{escape(slug)}</p></div></div>'
41
+ f'<p class="site-address">{address}</p><div class="site-actions">{"".join(actions)}</div>'
42
+ f'<details class="management"><summary>项目管理 <span>{escape(role)}</span></summary>'
43
+ f'<div class="management-body">{management}</div></details></article>')
44
+
45
+
46
+ TOOLBAR = '''<section class="catalog-toolbar" id="catalog-toolbar" aria-label="网站目录工具" hidden>
47
+ <label class="catalog-search">搜索网站<input id="catalog-search" type="search" placeholder="搜索名称、标识或域名" autocomplete="off"></label>
48
+ <label>访问方式<select id="catalog-visibility" aria-label="访问方式"><option value="all">全部访问方式</option><option value="public">公开网站</option><option value="private">仅登录网站</option></select></label>
49
+ <label>发布状态<select id="catalog-state" aria-label="发布状态"><option value="all">全部发布状态</option><option value="published">已发布</option><option value="preview">仅预览</option><option value="draft">尚未发布</option></select></label>
50
+ <div class="view-switch" role="group" aria-label="目录视图"><button type="button" data-view-choice="cards" aria-pressed="true"><span aria-hidden="true">▦</span> 卡片</button><button type="button" data-view-choice="list" aria-pressed="false"><span aria-hidden="true">☷</span> 列表</button></div>
51
+ </section>'''
52
+
53
+ STYLE = '''
54
+ header,main{max-width:1280px}header{padding-top:22px;padding-bottom:22px}header>a{font-size:20px;letter-spacing:-.5px}.account .create-link{font-weight:500;color:#3c5e43}.catalog-heading{display:flex;align-items:flex-end;justify-content:space-between;gap:16px;margin:26px 0 22px}.catalog-heading h1{margin:0 0 6px;letter-spacing:-1px}.catalog-heading .intro{margin:0;max-width:650px}.catalog-eyebrow{font-size:12px;font-weight:700;letter-spacing:2px;color:#73816e;margin:0 0 8px}.catalog-total{flex-shrink:0;font-size:14px;color:#687563;padding-bottom:3px}.catalog-toolbar{display:flex;align-items:end;gap:12px;background:#fff;border:1px solid #dce2d8;border-radius:12px;padding:16px;margin-bottom:18px}.catalog-toolbar[hidden]{display:none}.catalog-toolbar label{font-size:12px;gap:6px}.catalog-search{flex:1;min-width:180px}.catalog-toolbar input,.catalog-toolbar select{width:100%;font-size:14px;height:42px}.view-switch{display:flex;gap:3px;background:#f1f4ee;padding:3px;border:1px solid #e1e7db;border-radius:8px;flex-shrink:0}.view-switch button{border:0;background:transparent;padding:7px 11px;font-size:13px;line-height:22px}.view-switch button[aria-pressed="true"]{background:#fff;color:#244c32;box-shadow:0 1px 4px #253d221a}.catalog-result{font-size:13px;color:#687563;margin:0 0 14px}.catalog-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px;align-items:start}.catalog-grid [hidden],.catalog-no-results[hidden]{display:none!important}.catalog-grid .site-card{padding:22px 22px 0;border-radius:14px;display:flex;flex-direction:column;box-shadow:0 2px 4px #172e1910;transition:border-color .15s,box-shadow .15s}.site-card:hover{border-color:#b8c9b0;box-shadow:0 6px 20px #172e1910}.site-card:target{outline:2px solid #78966c;outline-offset:3px}.site-top{display:flex;gap:14px;align-items:center;min-width:0}.site-icon{width:56px;height:56px;border-radius:14px;display:flex;align-items:center;justify-content:center;flex-shrink:0;font-size:25px;font-weight:600;border:1px solid #31492f0a}.tone-0{background:#e8efdf;color:#476141}.tone-1{background:#e5edef;color:#436374}.tone-2{background:#f2ecde;color:#826b3c}.tone-3{background:#ece8f0;color:#6b547c}.site-heading{min-width:0;flex:1}.site-heading h2{font-size:19px;line-height:1.5;margin:4px 0 0;letter-spacing:-.3px}.site-meta{display:flex;align-items:center;flex-wrap:wrap;gap:9px;font-size:11px;line-height:1.7}.site-state{display:inline-flex;align-items:center;gap:5px;font-weight:500}.site-state:before{content:"";width:5px;height:5px;border-radius:50%;background:currentColor}.state-published{color:#4b7045}.state-preview{color:#8b6b2e}.state-draft{color:#7c8378}.site-visibility{color:#7e8779;border-left:1px solid #dce2d8;padding-left:9px}.site-slug{font-size:12px;color:#7c8776;margin:0;overflow-wrap:anywhere}.site-address{margin:22px 0 18px;font-size:13px;color:#6a7765;overflow-wrap:anywhere;min-height:21px}.site-actions{display:flex;align-items:center;flex-wrap:wrap;gap:14px;min-height:36px;margin:0 0 18px}.site-actions a{font-size:13px;text-decoration:none;font-weight:500}.site-open{color:#2d5235;background:#edf3e8;padding:7px 12px;border-radius:7px}.site-preview{color:#61725b}.site-manage{margin-left:auto;color:#64745e}.site-actions a:hover{text-decoration:underline}.site-unpublished{font-size:13px;color:#8a9185}.site-card .management{margin:0 -22px;padding:0;border-top:1px solid #e6ebe2;border-radius:0 0 14px 14px}.management>summary{padding:12px 22px;font-size:12px;color:#6c7a66}.management>summary span{float:right;font-size:11px;color:#84907d}.management-body{padding:0 22px 22px}.management .address{margin:20px 0}.management .address strong{font-size:13px}.management .visibility-form{margin-top:8px}.site-card:has(.management[open]){grid-column:1/-1}.catalog-grid[data-view="list"]{grid-template-columns:1fr;gap:10px}.catalog-grid[data-view="list"] .site-card{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:0 26px;padding-top:18px}.catalog-grid[data-view="list"] .site-top{grid-row:1/3;align-self:center}.catalog-grid[data-view="list"] .site-icon{width:46px;height:46px;border-radius:11px;font-size:22px}.catalog-grid[data-view="list"] .site-heading h2{font-size:17px}.catalog-grid[data-view="list"] .site-address{grid-column:2;grid-row:1;margin:0 0 7px;text-align:right;max-width:380px}.catalog-grid[data-view="list"] .site-actions{grid-column:2;grid-row:2;justify-content:flex-end;margin:0 0 14px}.catalog-grid[data-view="list"] .management{grid-column:1/-1}.catalog-grid[data-view="list"] .site-manage{margin-left:0}.catalog-no-results,.catalog-empty{padding:48px 24px;text-align:center;border:1px dashed #cbd6c3;border-radius:14px;background:#f9fbf6;margin:0}.catalog-no-results h2,.catalog-empty h2{font-size:18px}.catalog-no-results p,.catalog-empty p{color:#76826e;font-size:14px}.catalog-empty a{color:#385a35}.create{margin-top:30px}main>aside{font-size:12px;color:#6b7864;background:transparent;padding:0;margin-bottom:26px}.site-actions a:focus-visible,summary:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible{outline:2px solid #66835c;outline-offset:3px}
55
+ @media(max-width:1050px){.catalog-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.catalog-toolbar{flex-wrap:wrap}.catalog-search{min-width:260px}.catalog-toolbar .view-switch{margin-left:auto}}
56
+ @media(max-width:680px){header,main{padding:18px}.account{gap:10px}.account .create-link{display:none}.catalog-heading{display:block;margin-top:16px}.catalog-heading h1{font-size:28px}.catalog-total{display:block;margin-top:10px}.catalog-heading .intro{font-size:14px}.catalog-toolbar{gap:10px;padding:12px}.catalog-search{flex-basis:100%;min-width:0}.catalog-toolbar label:not(.catalog-search){flex:1;min-width:0}.catalog-toolbar select{padding-left:7px;font-size:13px}.catalog-toolbar .view-switch{margin-left:0;width:100%}.view-switch button{flex:1}.catalog-grid{grid-template-columns:1fr;gap:14px}.catalog-grid .site-card{padding:20px 20px 0}.site-card .management{margin:0 -20px}.management>summary{padding-left:20px;padding-right:20px}.management-body{padding-left:20px;padding-right:20px}.catalog-grid[data-view="list"] .site-card{display:flex}.catalog-grid[data-view="list"] .site-address{text-align:left;margin:14px 0 10px;max-width:none}.catalog-grid[data-view="list"] .site-actions{justify-content:flex-start;margin-bottom:14px}.catalog-grid[data-view="list"] .site-manage{margin-left:auto}.management .address{grid-template-columns:1fr;gap:6px}.management form label,.management form input,.management form select{width:100%}.management .suffix{flex-basis:100%}.management form button{width:100%}}
57
+ '''
58
+
59
+ SCRIPT = r'''
60
+ (()=>{
61
+ const catalog=document.getElementById('site-catalog');
62
+ if(!catalog)return;
63
+ const cards=Array.from(catalog.querySelectorAll('.site-card'));
64
+ const search=document.getElementById('catalog-search'),visibility=document.getElementById('catalog-visibility'),state=document.getElementById('catalog-state');
65
+ const count=document.getElementById('catalog-count'),empty=document.getElementById('catalog-no-results');
66
+ const choices=Array.from(document.querySelectorAll('[data-view-choice]'));
67
+ const storageKey='chatcoolify.catalog.view';
68
+ function setView(value){const view=value==='list'?'list':'cards';catalog.dataset.view=view;choices.forEach(button=>button.setAttribute('aria-pressed',String(button.dataset.viewChoice===view)));try{localStorage.setItem(storageKey,view)}catch(e){}}
69
+ function filter(){const query=search.value.trim().toLocaleLowerCase();let shown=0;cards.forEach(card=>{const match=(!query||card.dataset.search.toLocaleLowerCase().includes(query))&&(visibility.value==='all'||card.dataset.visibility===visibility.value)&&(state.value==='all'||card.dataset.state===state.value);card.hidden=!match;if(match)shown++});count.textContent='显示 '+shown+' / '+cards.length+' 个网站';empty.hidden=shown>0||cards.length===0;}
70
+ function reveal(id){const card=cards.find(item=>item.id===id);if(!card)return;search.value='';visibility.value='all';state.value='all';filter();const panel=card.querySelector('.management');if(panel)panel.open=true;requestAnimationFrame(()=>card.scrollIntoView({block:'start'}));}
71
+ search.addEventListener('input',filter);visibility.addEventListener('change',filter);state.addEventListener('change',filter);
72
+ choices.forEach(button=>button.addEventListener('click',()=>setView(button.dataset.viewChoice)));
73
+ document.getElementById('catalog-reset').addEventListener('click',()=>{search.value='';visibility.value='all';state.value='all';filter();search.focus()});
74
+ document.querySelectorAll('[data-manage]').forEach(link=>link.addEventListener('click',event=>{event.preventDefault();if(location.hash!=='#'+link.dataset.manage)location.hash=link.dataset.manage;reveal(link.dataset.manage)}));
75
+ window.addEventListener('hashchange',()=>reveal(location.hash.slice(1)));
76
+ try{setView(localStorage.getItem(storageKey))}catch(e){setView('cards')}
77
+ document.getElementById('catalog-toolbar').hidden=false;filter();reveal(location.hash.slice(1));
78
+ })();
79
+ '''
@@ -6,9 +6,11 @@ import sys
6
6
 
7
7
  import click
8
8
  from chatstyle import prompt_sensitive_value
9
+ from chatenv import EnvStore, get_paths
9
10
 
10
11
  from .platform_artifact import PlatformError
11
12
  from .platform_client import PlatformClient, configured_service
13
+ from .config import PlatformConfig
12
14
 
13
15
 
14
16
  def output(value):click.echo(json.dumps(value,ensure_ascii=False,indent=2,default=str))
@@ -43,14 +45,24 @@ def platform(ctx,profile,home):
43
45
 
44
46
 
45
47
  @platform.command()
46
- @click.option('--url',required=True)
47
- @click.option('--username',required=True)
48
+ @click.option('--url',help='Platform origin; defaults to this named ChatEnv profile.')
49
+ @click.option('--username',help='Account username; defaults to this named ChatEnv profile.')
48
50
  @click.option('--password-env',help='Environment variable name containing the password.')
49
51
  @click.pass_context
50
52
  @boundary
51
53
  def login(ctx,url,username,password_env):
52
- """Sign in to an invited account and save a private session."""
53
- api=PlatformClient(url);result=api.login(username,password_value(password_env))
54
+ """Sign in using ChatEnv credentials and cache the issued session."""
55
+ values=EnvStore(get_paths(ctx.obj['platform_home']).envs_dir).load_profile(PlatformConfig,ctx.obj['platform_profile'])
56
+ url=url or values.get('CHATCOOLIFY_PLATFORM_URL')
57
+ username=username or values.get('CHATCOOLIFY_PLATFORM_USERNAME')
58
+ if not url or not username:
59
+ raise click.ClickException('Configure platform URL and username in this ChatEnv profile, or pass --url and --username')
60
+ api=PlatformClient(url)
61
+ same_origin=bool(values.get('CHATCOOLIFY_PLATFORM_URL') and api.url==values['CHATCOOLIFY_PLATFORM_URL'].rstrip('/'))
62
+ same_account=bool(values.get('CHATCOOLIFY_PLATFORM_USERNAME') and username.strip().casefold()==values['CHATCOOLIFY_PLATFORM_USERNAME'].strip().casefold())
63
+ password=(password_value(password_env) if password_env else
64
+ (values.get('CHATCOOLIFY_PLATFORM_PASSWORD') if same_origin and same_account else None) or password_value(None))
65
+ result=api.login(username,password)
54
66
  api.save(ctx.obj['platform_profile'],home=ctx.obj['platform_home'])
55
67
  output({'authenticated':True,'url':api.url,'principal':result['principal']})
56
68
 
@@ -71,6 +83,14 @@ def whoami(ctx):
71
83
  output(client(ctx).request('/session')['principal'])
72
84
 
73
85
 
86
+ @platform.command('limits')
87
+ @click.pass_context
88
+ @boundary
89
+ def artifact_limits(ctx):
90
+ """Show effective server artifact limits; zero means unlimited."""
91
+ output(client(ctx).limits().as_dict())
92
+
93
+
74
94
  @platform.group()
75
95
  def projects():
76
96
  """List and register projects owned by or shared with this account."""