ChatLogin 0.2.0__tar.gz → 0.2.1__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 (123) hide show
  1. {chatlogin-0.2.0 → chatlogin-0.2.1}/CHANGELOG.md +6 -0
  2. {chatlogin-0.2.0/src/ChatLogin.egg-info → chatlogin-0.2.1}/PKG-INFO +4 -2
  3. {chatlogin-0.2.0 → chatlogin-0.2.1}/README.en.md +3 -1
  4. {chatlogin-0.2.0 → chatlogin-0.2.1}/README.md +3 -1
  5. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/capability-map.en.md +2 -0
  6. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/capability-map.md +1 -0
  7. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/index.en.md +2 -0
  8. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/index.md +2 -0
  9. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/integration.en.md +2 -0
  10. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/integration.md +2 -0
  11. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/interface-tree.en.md +2 -0
  12. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/interface-tree.md +2 -0
  13. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/managed-users.en.md +2 -0
  14. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/managed-users.md +2 -0
  15. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/quickstart.en.md +2 -0
  16. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/quickstart.md +2 -0
  17. chatlogin-0.2.1/docs/service-onboarding.en.md +84 -0
  18. chatlogin-0.2.1/docs/service-onboarding.md +99 -0
  19. chatlogin-0.2.1/examples/managed_service.py +59 -0
  20. {chatlogin-0.2.0 → chatlogin-0.2.1}/mkdocs.yml +2 -0
  21. {chatlogin-0.2.0 → chatlogin-0.2.1/src/ChatLogin.egg-info}/PKG-INFO +4 -2
  22. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/SOURCES.txt +8 -0
  23. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/__init__.py +1 -1
  24. chatlogin-0.2.1/src/chatlogin/account_ui.py +59 -0
  25. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/managed.html +1 -5
  26. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/fastapi.py +39 -1
  27. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed_demo.py +7 -10
  28. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed_web.py +32 -2
  29. chatlogin-0.2.1/src/chatlogin/web/assets/account-menu.css +16 -0
  30. chatlogin-0.2.1/src/chatlogin/web/templates/chatlogin/account-menu.html +10 -0
  31. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/profile.html +2 -1
  32. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/users.html +2 -1
  33. chatlogin-0.2.1/tests/code-tests/test_onboarding_acceptance.py +67 -0
  34. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_packaging_imports.py +2 -2
  35. chatlogin-0.2.1/tests/code-tests/test_service_onboarding.py +149 -0
  36. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_version.py +1 -1
  37. {chatlogin-0.2.0 → chatlogin-0.2.1}/DEVELOP.md +0 -0
  38. {chatlogin-0.2.0 → chatlogin-0.2.1}/LICENSE +0 -0
  39. {chatlogin-0.2.0 → chatlogin-0.2.1}/MANIFEST.in +0 -0
  40. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/chatvoice-managed.en.md +0 -0
  41. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/chatvoice-managed.md +0 -0
  42. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/cli-tree.en.md +0 -0
  43. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/cli-tree.md +0 -0
  44. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/demo.en.md +0 -0
  45. {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/demo.md +0 -0
  46. {chatlogin-0.2.0 → chatlogin-0.2.1}/examples/demo_fastapi.py +0 -0
  47. {chatlogin-0.2.0 → chatlogin-0.2.1}/examples/quickstart_fastapi.py +0 -0
  48. {chatlogin-0.2.0 → chatlogin-0.2.1}/pyproject.toml +0 -0
  49. {chatlogin-0.2.0 → chatlogin-0.2.1}/setup.cfg +0 -0
  50. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/dependency_links.txt +0 -0
  51. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/entry_points.txt +0 -0
  52. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/requires.txt +0 -0
  53. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/top_level.txt +0 -0
  54. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/__init__.py +0 -0
  55. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/chatvoice.py +0 -0
  56. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/chatvoice_managed.py +0 -0
  57. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/cli.py +0 -0
  58. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/config.py +0 -0
  59. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/credentials.py +0 -0
  60. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo.py +0 -0
  61. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/__init__.py +0 -0
  62. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo-login.css +0 -0
  63. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo-login.js +0 -0
  64. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo.css +0 -0
  65. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo.js +0 -0
  66. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/headless.html +0 -0
  67. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/home.html +0 -0
  68. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/templates.html +0 -0
  69. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/workspace.html +0 -0
  70. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/identity.py +0 -0
  71. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed.py +0 -0
  72. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/paths.py +0 -0
  73. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/private_sqlite.py +0 -0
  74. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/security.py +0 -0
  75. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/sessions.py +0 -0
  76. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/sqlite.py +0 -0
  77. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/ui.py +0 -0
  78. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/user_ui.py +0 -0
  79. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/__init__.py +0 -0
  80. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/login.css +0 -0
  81. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/login.js +0 -0
  82. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/users.css +0 -0
  83. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/users.js +0 -0
  84. {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/login.html +0 -0
  85. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/cli-tests/README.md +0 -0
  86. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/README.md +0 -0
  87. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_async_credentials.py +0 -0
  88. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_chatvoice_backend.py +0 -0
  89. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_chatvoice_managed_backend.py +0 -0
  90. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_core.py +0 -0
  91. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_core_guards.py +0 -0
  92. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_multiuser.py +0 -0
  93. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_release_contract.py +0 -0
  94. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_site.py +0 -0
  95. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_ux.py +0 -0
  96. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_http_guards.py +0 -0
  97. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_live_login_service.py +0 -0
  98. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_concurrency.py +0 -0
  99. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_demo.py +0 -0
  100. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_form_safety.py +0 -0
  101. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_integration.py +0 -0
  102. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_journal_race.py +0 -0
  103. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_plugin.py +0 -0
  104. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_read_snapshot.py +0 -0
  105. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_sessions.py +0 -0
  106. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_ui.py +0 -0
  107. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_users.py +0 -0
  108. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_web.py +0 -0
  109. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_origin_mount.py +0 -0
  110. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_packaging_demo.py +0 -0
  111. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_scaffold_contract.py +0 -0
  112. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_session_purge.py +0 -0
  113. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_sqlite_security.py +0 -0
  114. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_storage_platform.py +0 -0
  115. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_ui_contract.py +0 -0
  116. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_web.py +0 -0
  117. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/conftest.py +0 -0
  118. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/mock-cli-tests/README.md +0 -0
  119. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_cli.py +0 -0
  120. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_docs_deployment.py +0 -0
  121. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_managed_cli.py +0 -0
  122. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_managed_docs.py +0 -0
  123. {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_paths_cli.py +0 -0
@@ -1,5 +1,11 @@
1
1
  # 更新日志
2
2
 
3
+ ## 0.2.1 — 2026-10-14
4
+
5
+ - 新增 Host 校验、no-store 的 `GET {prefix}/api`,按真实路由和可信 ASGI mount 发现操作、页面和能力;headless 不声明页面。
6
+ - 新增可组合 `AccountMenuUI` 齿轮/链接片段、scoped CSS 和角色感知导航;默认用户管理、本人资料和 managed demo 宿主页复用。
7
+ - 新增无默认生产账号的新服务 factory 示例与中英文接入说明;保持既有请求、CSRF、Origin、角色和 URL 契约。
8
+
3
9
  ## 0.2.0 — 2026-10-11
4
10
 
5
11
  - 新增应用显式采用的 managed users 接入面:首个 owner 的环境变量 bootstrap、`ManagedUsers` / `create_managed_auth` 指引、owner/admin/user 角色矩阵,以及默认登录、用户管理和本人资料路由说明。
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ChatLogin
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: Reusable authentication, sessions, and login templates for Python-backed websites.
5
5
  Author-email: ChatArch <1073853456@qq.com>
6
6
  License-Expression: MIT
@@ -105,7 +105,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
105
105
 
106
106
  核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
107
107
 
108
- ## 托管用户(0.2.0)
108
+ ## 托管用户(0.2.1)
109
+
110
+ 新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
109
111
 
110
112
  需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
111
113
 
@@ -59,7 +59,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
59
59
 
60
60
  The core package does not require adopting the packaged page. An existing static HTML/vanilla-JS site can mount only JSON routes and retain its current entry page and user database; a standard-library HTTP host can use `LoginUI` for rendering without installing FastAPI.
61
61
 
62
- ## Managed Users (0.2.0)
62
+ ## Managed Users (0.2.1)
63
+
64
+ New services can discover registered routes through `GET {prefix}/api` and embed the `AccountMenuUI` gear/links fragment. See [New Service Onboarding](docs/service-onboarding.en.md) for a complete factory, `/admin` prefix, headless and host-template options. This is not cross-service SSO.
63
65
 
64
66
  For an application-owned owner/admin/user directory, login, profile, and user management, new consumers explicitly adopt `ChatLogin>=0.2.0,<0.3.0` with `ManagedUsers` and `create_managed_auth`. An operator creates the first owner with `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY`; KEY is an environment-variable name, never a password in argv. Bootstrap works only for an empty instance and has no migration, `--force`, or default production credential. See [Managed Users](docs/managed-users.en.md).
65
67
 
@@ -59,7 +59,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
59
59
 
60
60
  核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
61
61
 
62
- ## 托管用户(0.2.0)
62
+ ## 托管用户(0.2.1)
63
+
64
+ 新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
63
65
 
64
66
  需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
65
67
 
@@ -1,5 +1,7 @@
1
1
  # Capability Map
2
2
 
3
+ ChatLogin 0.2.1 adds truthful `GET {prefix}/api` discovery and `AccountMenuUI` role-aware host navigation; headless does not advertise pages. See [New Service Onboarding](service-onboarding.en.md).
4
+
3
5
  ## Implemented Capabilities
4
6
 
5
7
  | Capability | Status | Boundary |
@@ -6,6 +6,7 @@
6
6
  | --- | --- | --- |
7
7
  | 包内演示站 | 已实现(`demo` extra) | `chatlogin serve`、四类真实后端体验、模板游乐场与可复制接入示例;不连接生产数据 |
8
8
  | 托管用户预设 | `0.2.0` | `ManagedUsers`、每实例 owner/admin/user、默认登录/管理/本人资料 UI/API;需显式采用,不迁移旧账户库 |
9
+ | 新服务发现与导航 | `0.2.1` | `GET {prefix}/api` 列出真实操作与能力;`AccountMenuUI` 复用角色入口,headless 不虚报页面;见[新服务接入](service-onboarding.md) |
9
10
  | ChatVoice legacy 托管 facade | `0.2.0` | 保留原 `accounts` / `auth_sessions` 的 additive 初始化、一次性 owner 采用、metadata-aware 账号匹配和 managed users CRUD;需消费方显式采用 |
10
11
  | 身份与授权 | 已实现 | `Principal`、`Role`、401/403、`require_role`、`require_owner`;admin 不自动绕过 owner |
11
12
  | 认证后端 | 已实现 | `PasswordBackend` 支持一个或多个显式账号;`CallbackBackend` 接入宿主用户库;`AsyncCallbackBackend` await 异步上游校验 |
@@ -1,5 +1,7 @@
1
1
  # ChatLogin Documentation
2
2
 
3
+ **0.2.1 new-service path:** [Complete factory, account discovery, and gear/links navigation](service-onboarding.en.md).
4
+
3
5
  ChatLogin makes the backend security contract for website login reusable in Python while leaving presentation under host control. Use the packaged page, override templates/CSS, or keep an existing HTML/vanilla-JS frontend and use the headless JSON API.
4
6
 
5
7
  Site entry: <https://arch.gh.wzhecnu.cn/ChatLogin/en/>
@@ -1,5 +1,7 @@
1
1
  # ChatLogin 文档
2
2
 
3
+ **0.2.1 新服务接入:**[查看完整 factory、账号发现和齿轮/链接菜单](service-onboarding.md)。
4
+
3
5
  ChatLogin 把网站登录中的**后端安全契约**做成可复用 Python 能力,同时把前端外观留给宿主网站:可以用包内默认登录页,也可以只覆盖模板/CSS,还可以完全保留宿主原生 HTML/JS,以 headless 方式调用 JSON 接口。
4
6
 
5
7
  站点入口:<https://arch.gh.wzhecnu.cn/ChatLogin/>
@@ -1,5 +1,7 @@
1
1
  # Integration and Security Boundaries
2
2
 
3
+ For the 0.2.1 read-only `GET {prefix}/api`, role-aware navigation, and composable menu, see [New Service Onboarding](service-onboarding.en.md). Discovery is not a session endpoint; retain the existing `GET /session` and CSRF/Origin contract.
4
+
3
5
  Start with the [complete quick integration](quickstart.md). To explore the components first, install `ChatLogin[demo]` and run `chatlogin serve`; see [Demo](demo.md).
4
6
 
5
7
  ## Choose an Integration Level
@@ -1,5 +1,7 @@
1
1
  # 接入与安全边界
2
2
 
3
+ 0.2.1 的只读发现入口 `GET {prefix}/api`、角色感知导航和可组合菜单见[新服务接入](service-onboarding.md)。发现不是当前会话 API,仍使用现有 `GET /session` 与 CSRF/Origin 契约。
4
+
3
5
  先按 [完整快速接入](quickstart.md) 跑通一个应用;只想体验组件时安装 `ChatLogin[demo]` 并运行 `chatlogin serve`,参见 [演示站](demo.md)。
4
6
 
5
7
  ## 选择接入层级
@@ -67,6 +67,8 @@ This is an explicit application-account preset; it does not migrate fixed-accoun
67
67
 
68
68
  ## Embeddable Managed-user Plugin
69
69
 
70
+ 0.2.1: `FastAPIAuth` and `ManagedAuth` expose `api_discovery(request)`, `navigation_from_request(request)`, and `render_account_menu(request, ui=None)`; optional `chatlogin.account_ui.AccountMenuUI(mode="gear" | "links", template_dirs=None, template_name=..., renderer=None)` renders the fragment. Discover HTTP operations through `GET {prefix}/api`; see [New Service Onboarding](service-onboarding.en.md).
71
+
70
72
  `create_managed_auth(..., pages=True)` mounts default pages and APIs; `pages=False` mounts APIs only and preserves the host frontend. See [plugin integration](managed-users.md#plugin).
71
73
 
72
74
  ## Built-in Optional ChatVoice Backend
@@ -67,6 +67,8 @@ chatlogin.managed_web
67
67
 
68
68
  ## 可内嵌托管用户插件
69
69
 
70
+ 0.2.1:`FastAPIAuth` 与 `ManagedAuth` 增加 `api_discovery(request)`、`navigation_from_request(request)`、`render_account_menu(request, ui=None)`;可选 UI 类 `chatlogin.account_ui.AccountMenuUI(mode="gear" | "links", template_dirs=None, template_name=..., renderer=None)`。HTTP 操作见 `GET {prefix}/api` 和[新服务接入](service-onboarding.md)。
71
+
70
72
  `create_managed_auth(..., pages=True)` 挂载默认页面与接口;`pages=False` 只挂载接口,保留宿主前端。详见[插件集成](managed-users.md#plugin)。
71
73
 
72
74
  ## 内建可选 ChatVoice 后端
@@ -1,5 +1,7 @@
1
1
  # Managed Users
2
2
 
3
+ For a complete new-service factory, account menu and read-only route discovery, see [New Service Onboarding](service-onboarding.en.md). The 0.2.0 managed-user behavior remains compatible.
4
+
3
5
  This page describes the managed-users preset provided by `0.2.0`. New adopters should explicitly require `ChatLogin>=0.2.0,<0.3.0`. Existing fixed-account, callback, and ChatVoice-compatible integrations do not need to change. A legacy ChatVoice consumer's `<0.2` dependency remains unaffected unless it deliberately adopts managed users or the ChatVoice legacy-schema managed facade.
4
6
 
5
7
  ## Choose the Right Entry Point
@@ -1,5 +1,7 @@
1
1
  # 托管用户
2
2
 
3
+ 完整新服务 factory、菜单和只读路由发现见[新服务接入](service-onboarding.md);本页的 0.2.0 托管能力与行为保持兼容。
4
+
3
5
  本页说明 `0.2.0` 提供的托管用户预设。新接入方应显式声明 `ChatLogin>=0.2.0,<0.3.0`;已使用固定账号、回调或 ChatVoice 兼容后端的应用不必改变。ChatVoice 既有消费者的 `<0.2` 依赖保持不受影响,只有主动采用托管用户或 ChatVoice legacy schema 托管 facade 时才升级和接入。
4
6
 
5
7
  ## 先选择合适的入口
@@ -1,5 +1,7 @@
1
1
  # Integrate Your Own Project
2
2
 
3
+ For discovery and host-page navigation, start with [New Service Onboarding](service-onboarding.en.md): a complete factory, `/admin` prefix, gear/links menu, and headless options.
4
+
3
5
  <div class="grid cards" markdown>
4
6
 
5
7
  - **New FastAPI host**: copy the complete application below and perform a real login.
@@ -1,5 +1,7 @@
1
1
  # 快速接入自己的项目
2
2
 
3
+ 新服务需要统一账号发现与宿主页入口时,优先阅读[新服务接入](service-onboarding.md):完整 factory、`/admin` 前缀、齿轮/链接菜单及 headless 接法。
4
+
3
5
  <div class="grid cards" markdown>
4
6
 
5
7
  - **新建 FastAPI 网站**:复制下方完整应用,先完成一次真实登录。
@@ -0,0 +1,84 @@
1
+ # New-service onboarding: one account HTTP contract
2
+
3
+ ChatLogin 0.2.1 mounts an account plugin **inside each service**. One `create_managed_auth` provides login, sessions, profile and user management. Choose a gear menu, ordinary links or a host frontend without copying authentication. This is not shared-cookie SSO, a central identity service or generic CRUD for arbitrary external account providers.
4
+
5
+ ## An end-to-end new service
6
+
7
+ ```bash
8
+ python -m pip install "ChatLogin[web]==0.2.1" uvicorn
9
+ chatlogin users bootstrap operator --instance my-service --password-env MY_SERVICE_BOOTSTRAP_PASSWORD
10
+ ```
11
+
12
+ Provide the bootstrap variable through a protected process environment first. The CLI receives its name, never a password value. No production account is created automatically. Save the [complete factory](https://github.com/ChatArch/ChatLogin/blob/main/examples/managed_service.py) as `auth_app.py`, then create `app.py`:
13
+
14
+ ```python
15
+ import os
16
+ from auth_app import create_app
17
+ from chatlogin.account_ui import AccountMenuUI
18
+
19
+ app = create_app(
20
+ instance="my-service",
21
+ origin=os.environ["MY_SERVICE_ORIGIN"],
22
+ prefix="/auth", # /admin is another deployment prefix, not a permission grant
23
+ menu_ui=AccountMenuUI(mode="gear", language="en"),
24
+ allow_insecure_loopback=os.environ.get("MY_SERVICE_ALLOW_LOOPBACK") == "1",
25
+ )
26
+ ```
27
+
28
+ Production uses the actual fixed HTTPS browser origin; the host owns TLS and reverse proxying:
29
+
30
+ ```bash
31
+ MY_SERVICE_ORIGIN=https://service.example.com python -m uvicorn app:app --host 127.0.0.1 --port 8765
32
+ ```
33
+
34
+ For explicit local development only:
35
+
36
+ ```bash
37
+ MY_SERVICE_ORIGIN=http://127.0.0.1:8765 MY_SERVICE_ALLOW_LOOPBACK=1 python -m uvicorn app:app --host 127.0.0.1 --port 8765
38
+ ```
39
+
40
+ Open the homepage → Account settings → Login. Owners/admins can open management; members have their own profile. `/private` uses `auth.current_user`; `/operator` requires explicit admin/owner roles. Business-resource ownership still belongs to the host: roles do not bypass `require_owner` or ACLs.
41
+
42
+ The factory closes a store it creates during ASGI shutdown. An injected service is caller-owned and must be closed by the caller, so one host cannot destroy another host's shared in-process service. Synthetic in-memory users are only explicit test fixtures, not production defaults or an automatic migration.
43
+
44
+ ## A discoverable API root
45
+
46
+ `GET /auth/api` returns `version` (installed package), `schema_version=1` (discovery format), actual `{method, path}` `operations`, available `pages` and `login`/`managed_users`/`profile` `capabilities`. With `/admin`, the root is `/admin/api`. URLs include trusted ASGI mount metadata, not forwarded-prefix headers.
47
+
48
+ Host checking and `no-store` apply. Discovery reveals no account directory, Cookie, CSRF, credentials or state paths. It advertises provided capabilities, not actor permissions. Fixed/callback backends do not claim managed-user administration; headless mode advertises no pages. This operation directory is not a complete request/response schema or an OAuth endpoint.
49
+
50
+ | Method and relative path | JSON / result | Authorization |
51
+ | --- | --- | --- |
52
+ | `GET /api` | Discovery | Trusted Host, anonymous allowed |
53
+ | `GET /session` | authenticated, user, csrf_token | Trusted Host; anonymous gets 200 |
54
+ | `POST /login` | username, password, optional next | Same-origin; existing session needs CSRF |
55
+ | `POST /logout` | Revoke session | Current session, Origin, CSRF |
56
+ | `GET /api/users?offset=0&limit=100` | Safe metadata list, limit≤100 | Owner/admin within policy scope |
57
+ | `POST /api/users` | username, password, optional display_name/role; 201 | Owner/admin; only owner grants admin |
58
+ | `GET /api/users/{user_id}` | Safe metadata | Object-scoped owner/admin |
59
+ | `PATCH /api/users/{user_id}` | Allowed display_name/role/enabled combination | Object policy, Origin, CSRF |
60
+ | `DELETE /api/users/{user_id}` | deleted | Object policy, Origin, CSRF; never delete owner |
61
+ | `POST /api/users/{user_id}/password` | new_password | Object policy, Origin, CSRF |
62
+ | `GET /api/profile` | Own profile | Current user |
63
+ | `PATCH /api/profile` | display_name | Self, Origin, CSRF |
64
+ | `POST /api/profile/password` | current_password, new_password | Self, Origin, CSRF; invalidate old sessions |
65
+ | `POST /api/owner/transfer` | target_user_id, current_password, confirm_username | Owner reauthentication, Origin, CSRF, atomic handoff |
66
+
67
+ Use browser `credentials: 'same-origin'`, read current CSRF from `/session` and send `X-CSRF-Token` for writes. Never persist credentials, Cookie or CSRF in browser storage, URLs or logs. Common errors: 400 invalid request/Host; 401 unauthenticated; 403 policy/Origin/CSRF; 404 missing object; 409 conflict; 413 oversized body; 429 rate limit; 503 controlled capacity/service failure. The operation catalog supplements this contract and host OpenAPI; it does not replace request/response schemas.
68
+
69
+ ## Gear, links and DIY
70
+
71
+ ```python
72
+ from chatlogin.account_ui import AccountMenuUI
73
+
74
+ menu = await auth.render_account_menu(request) # Chinese-first native details
75
+ menu = await auth.render_account_menu(request, ui=AccountMenuUI(mode="links", language="en"))
76
+ menu = await auth.render_account_menu(
77
+ request, ui=AccountMenuUI(template_dirs=["templates"], template_name="account/menu.html")
78
+ )
79
+ navigation = await auth.navigation_from_request(request) # host-owned rendering
80
+ ```
81
+
82
+ Host HTML containing current identity must also set `Cache-Control: no-store`; never share-cache an account menu. Navigation resolves the actual current session. Anonymous visitors see login; members see profile; admins/owners also see management. Changes invalidate stale sessions. The native vertical gear popover needs no JavaScript initialization, has scoped CSS and inherits host typography/theme. Default rendering escapes identity/labels and validates local links; trusted custom renderers own HTML safety. Sign-out remains the existing CSRF-protected POST, not a GET link.
83
+
84
+ `pages=False` retains JSON APIs without packaged HTML/assets and produces no fake empty settings control. Host frontends use the same HTTP contract. `LoginUI`, `UserAdminUI` and `UserProfileUI` remain separately replaceable; never patch site-packages. Existing account providers retain their own lifecycle unless an explicit managed adapter exists. A unified HTTP contract is not a shared account database or cross-site SSO. See [Managed Users](managed-users.en.md) and [Integration and Security](integration.en.md).
@@ -0,0 +1,99 @@
1
+ # 新服务接入:统一账号 HTTP 契约
2
+
3
+ ChatLogin 0.2.1 把账号接口和页面作为**每个服务自己的插件**挂载。一次 `create_managed_auth` 可得到登录、会话、本人资料和用户管理;宿主选择齿轮、普通链接或自有前端,不复制认证实现。这不是共享 Cookie 的 SSO、集中身份服务或任意外部用户库的通用 CRUD。
4
+
5
+ ## 从空服务到可登录页面
6
+
7
+ ```bash
8
+ python -m pip install "ChatLogin[web]==0.2.1" uvicorn
9
+ ```
10
+
11
+ 先在受保护的进程环境中提供 `MY_SERVICE_BOOTSTRAP_PASSWORD`,再初始化空实例。命令行只接收变量名,不接收密码值;没有生产默认账号或自动注册。
12
+
13
+ ```bash
14
+ chatlogin users bootstrap operator --instance my-service --password-env MY_SERVICE_BOOTSTRAP_PASSWORD
15
+ ```
16
+
17
+ 把 [完整 factory](https://github.com/ChatArch/ChatLogin/blob/main/examples/managed_service.py) 保存为 `auth_app.py`,再建立 `app.py`:
18
+
19
+ ```python
20
+ import os
21
+ from auth_app import create_app
22
+ from chatlogin.account_ui import AccountMenuUI
23
+
24
+ app = create_app(
25
+ instance="my-service", # 与 bootstrap 相同
26
+ origin=os.environ["MY_SERVICE_ORIGIN"],
27
+ prefix="/auth", # 也可 /admin;不影响角色策略
28
+ menu_ui=AccountMenuUI(mode="gear"),
29
+ allow_insecure_loopback=os.environ.get("MY_SERVICE_ALLOW_LOOPBACK") == "1",
30
+ )
31
+ ```
32
+
33
+ 部署使用浏览器真正访问的固定 HTTPS origin,由宿主负责 TLS/反代:
34
+
35
+ ```bash
36
+ MY_SERVICE_ORIGIN=https://service.example.com python -m uvicorn app:app --host 127.0.0.1 --port 8765
37
+ ```
38
+
39
+ 仅在本机开发时显式开启 loopback HTTP:
40
+
41
+ ```bash
42
+ MY_SERVICE_ORIGIN=http://127.0.0.1:8765 MY_SERVICE_ALLOW_LOOPBACK=1 python -m uvicorn app:app --host 127.0.0.1 --port 8765
43
+ ```
44
+
45
+ 打开首页 → 齿轮“账号设置” → 登录;owner/admin 登录后可进入用户管理,普通用户只进入本人资料。示例还提供 `/private` 的 `auth.current_user` 和 `/operator` 的明确角色依赖。业务数据仍需 `require_owner` 或宿主 ACL,admin/owner 不自动读取他人的业务记录。
46
+
47
+ factory 自建的 store 在 ASGI shutdown 关闭。测试或共享同进程服务可显式注入 `users`;注入对象由调用方拥有并负责关闭,不因一个宿主退出而被销毁。它不会迁移既有账户或读取演示默认凭据。
48
+
49
+ ## 统一的 API 发现入口
50
+
51
+ `GET /auth/api` 返回 `version`(安装包版本)、`schema_version=1`(发现格式)、`operations`(实际注册的 HTTP 方法和路径)、`pages`(存在的页面)和 `capabilities`(login/managed_users/profile)。`prefix="/admin"` 时入口为 `/admin/api`;可信 ASGI mount 也计入 URL,忽略任意 forwarded-prefix 头。
52
+
53
+ 发现接口验证 Host、返回 `no-store`,不返回用户目录、Cookie、CSRF、凭据或 state 路径。它描述**功能是否提供**,不代表当前用户有权限。固定账号/callback 不虚报用户管理;`pages=False` 的页面表为空。
54
+
55
+ ### 默认 HTTP 契约
56
+
57
+ 以下路径均相对 `/auth`(或宿主选择的前缀)。会话身份由服务端解析,绝不从请求的 actor/role 字段获得管理员权限。
58
+
59
+ | 方法与路径 | JSON/结果 | 权限 |
60
+ | --- | --- | --- |
61
+ | `GET /api` | 发现信息 | 可信 Host,可匿名 |
62
+ | `GET /session` | authenticated、user、csrf_token | 可信 Host;匿名也返回 200 |
63
+ | `POST /login` | username、password、可选 next | 同源;已有会话还需当前 CSRF |
64
+ | `POST /logout` | 撤销会话 | 登录、同源、CSRF |
65
+ | `GET /api/users?offset=0&limit=100` | 安全用户列表;limit≤100 | owner/admin,范围由后端策略限制 |
66
+ | `POST /api/users` | username、password、可选 display_name/role;201 | owner/admin;只有 owner 可授予 admin |
67
+ | `GET /api/users/{user_id}` | 用户安全元数据 | owner/admin 的可管理范围 |
68
+ | `PATCH /api/users/{user_id}` | display_name、role、enabled 的合法组合 | 对象级权限、同源、CSRF |
69
+ | `DELETE /api/users/{user_id}` | deleted | 对象级权限、同源、CSRF;禁止删 owner |
70
+ | `POST /api/users/{user_id}/password` | new_password | 对象级权限、同源、CSRF |
71
+ | `GET /api/profile` | 本人用户资料 | 当前登录用户 |
72
+ | `PATCH /api/profile` | display_name | 本人、同源、CSRF |
73
+ | `POST /api/profile/password` | current_password、new_password | 本人、同源、CSRF;旧会话失效 |
74
+ | `POST /api/owner/transfer` | target_user_id、current_password、confirm_username | owner 复验、同源、CSRF、原子交接 |
75
+
76
+ 浏览器 `credentials: 'same-origin'`,从 `/session` 读取当前 CSRF,在写操作 `X-CSRF-Token` 头发送;不要把密码、Cookie 或 CSRF 写入 localStorage、URL 或日志。常见错误为 400(非法请求/Host)、401(未认证)、403(权限/Origin/CSRF)、404(对象不存在)、409(状态冲突)、413(体上限)、429(限流)、503(受控容量/服务不可用)。发现目录不是完整请求/响应 Schema,也不替代上述契约和宿主 OpenAPI。
77
+
78
+ ## 齿轮、普通链接与 DIY
79
+
80
+ ```python
81
+ from chatlogin.account_ui import AccountMenuUI
82
+
83
+ # 宿主 async GET handler 内;request 为真实 FastAPI Request。
84
+ menu = await auth.render_account_menu(request) # 中文、原生齿轮浮层
85
+ menu = await auth.render_account_menu(request, ui=AccountMenuUI(mode="links"))
86
+ menu = await auth.render_account_menu(request, ui=AccountMenuUI(language="en"))
87
+ # 自有模板或可信 renderer:
88
+ menu = await auth.render_account_menu(
89
+ request, ui=AccountMenuUI(template_dirs=["templates"], template_name="account/menu.html")
90
+ )
91
+ # 完全 DIY:只拿安全导航信息,自行渲染。
92
+ navigation = await auth.navigation_from_request(request)
93
+ ```
94
+
95
+ 宿主承载当前身份的 HTML 响应也需设置 `Cache-Control: no-store`,不要由 CDN 或共享缓存保存用户菜单。导航从真实当前 session 解析 identity/role/links/assets_path;改密、禁用或角色变化后旧会话不继续提供管理入口。菜单不依赖 JS 初始化;CSS 仅作用于自身,并继承宿主字体和 ChatLogin 色板。默认片段自动转义身份/标签并验证本地链接,renderer 的 HTML 安全由可信宿主负责。退出仍是现有页面中的受 CSRF 保护 POST,不提供 GET 退出链接。
96
+
97
+ `pages=False` 保留 JSON API、没有默认 HTML/assets;默认菜单也不生成假的空设置按钮。自有前端按同一 HTTP 契约工作。`LoginUI`、`UserAdminUI`、`UserProfileUI` 保持独立模板/renderer 覆盖,安装位置不应被手动修改。
98
+
99
+ 已有用户库应选择 [适配路径](integration.md):callback 只认证,不自动接管账户生命周期;ChatVoice legacy schema 使用明确保留式 adapter。统一 HTTP 契约不等于统一账号库、共享 Cookie 或跨站 SSO。
@@ -0,0 +1,59 @@
1
+ """New-service factory; no production accounts or credentials are generated."""
2
+ from contextlib import asynccontextmanager
3
+ from html import escape
4
+
5
+ from fastapi import Depends, FastAPI, Request
6
+ from fastapi.responses import HTMLResponse
7
+
8
+ from chatlogin import Role
9
+ from chatlogin.account_ui import AccountMenuUI
10
+ from chatlogin.managed_web import create_managed_auth
11
+
12
+
13
+ def create_app(*, instance: str, origin: str, prefix: str = "/auth", users=None,
14
+ pages: bool = True, allow_insecure_loopback: bool = False,
15
+ menu_ui: AccountMenuUI | None = None) -> FastAPI:
16
+ owns_users = users is None
17
+ auth = create_managed_auth(instance, origin=origin, prefix=prefix, users=users,
18
+ pages=pages, allow_insecure_loopback=allow_insecure_loopback)
19
+
20
+ @asynccontextmanager
21
+ async def lifespan(_app):
22
+ try:
23
+ yield
24
+ finally:
25
+ if owns_users:
26
+ auth.users.close()
27
+
28
+ app = FastAPI(lifespan=lifespan)
29
+ app.state.chatlogin_auth = auth
30
+ app.include_router(auth.router)
31
+
32
+ @app.get("/", response_class=HTMLResponse)
33
+ async def home(request: Request):
34
+ menu = await auth.render_account_menu(request, ui=menu_ui)
35
+ navigation = await auth.navigation_from_request(request)
36
+ assets = escape(str(navigation["assets_path"]), quote=True)
37
+ styles = (f'<link rel="stylesheet" href="{assets}/login.css">'
38
+ f'<link rel="stylesheet" href="{assets}/users.css">') if assets else ""
39
+ response = HTMLResponse(
40
+ '<!doctype html><html lang="zh-CN"><head><meta charset="utf-8">'
41
+ '<meta name="viewport" content="width=device-width, initial-scale=1">'
42
+ f'<title>新服务接入示例</title>{styles}</head><body class="chatlogin-page">'
43
+ '<main class="chatlogin" data-appearance="system"><section class="chatlogin__panel">'
44
+ '<header class="chatlogin-users__header"><h1>示例服务</h1>'
45
+ f'{menu}</header><p class="chatlogin__subtitle">本页复用 ChatLogin 登录、账号与用户管理入口。</p>'
46
+ '</section></main></body></html>')
47
+ response.headers["Cache-Control"] = "no-store"
48
+ response.headers["Content-Security-Policy"] = "default-src 'self'; style-src 'self'; base-uri 'none'; frame-ancestors 'none'"
49
+ return response
50
+
51
+ @app.get("/private")
52
+ async def private(principal=Depends(auth.current_user)):
53
+ return principal.as_dict()
54
+
55
+ @app.get("/operator")
56
+ async def operator(principal=Depends(auth.roles(Role.ADMIN, Role.OWNER))):
57
+ return {"user_id": principal.user_id}
58
+
59
+ return app
@@ -43,6 +43,7 @@ plugins:
43
43
  快速接入: Quick Integration
44
44
  演示站与快速开始: Demo and Quick Start
45
45
  托管用户: Managed Users
46
+ 新服务接入: New Service Onboarding
46
47
  ChatVoice legacy schema 集成: ChatVoice Legacy Schema Integration
47
48
  markdown_extensions:
48
49
  - admonition
@@ -71,6 +72,7 @@ nav:
71
72
  - 快速接入: quickstart.md
72
73
  - 接入与安全: integration.md
73
74
  - 托管用户: managed-users.md
75
+ - 新服务接入: service-onboarding.md
74
76
  - ChatVoice legacy schema 集成: chatvoice-managed.md
75
77
  - 命令与接口:
76
78
  - CLI 树: cli-tree.md
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ChatLogin
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: Reusable authentication, sessions, and login templates for Python-backed websites.
5
5
  Author-email: ChatArch <1073853456@qq.com>
6
6
  License-Expression: MIT
@@ -105,7 +105,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
105
105
 
106
106
  核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
107
107
 
108
- ## 托管用户(0.2.0)
108
+ ## 托管用户(0.2.1)
109
+
110
+ 新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
109
111
 
110
112
  需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
111
113
 
@@ -24,7 +24,10 @@ docs/managed-users.en.md
24
24
  docs/managed-users.md
25
25
  docs/quickstart.en.md
26
26
  docs/quickstart.md
27
+ docs/service-onboarding.en.md
28
+ docs/service-onboarding.md
27
29
  examples/demo_fastapi.py
30
+ examples/managed_service.py
28
31
  examples/quickstart_fastapi.py
29
32
  src/ChatLogin.egg-info/PKG-INFO
30
33
  src/ChatLogin.egg-info/SOURCES.txt
@@ -33,6 +36,7 @@ src/ChatLogin.egg-info/entry_points.txt
33
36
  src/ChatLogin.egg-info/requires.txt
34
37
  src/ChatLogin.egg-info/top_level.txt
35
38
  src/chatlogin/__init__.py
39
+ src/chatlogin/account_ui.py
36
40
  src/chatlogin/cli.py
37
41
  src/chatlogin/config.py
38
42
  src/chatlogin/credentials.py
@@ -63,10 +67,12 @@ src/chatlogin/demo_site/templates/managed.html
63
67
  src/chatlogin/demo_site/templates/templates.html
64
68
  src/chatlogin/demo_site/templates/workspace.html
65
69
  src/chatlogin/web/__init__.py
70
+ src/chatlogin/web/assets/account-menu.css
66
71
  src/chatlogin/web/assets/login.css
67
72
  src/chatlogin/web/assets/login.js
68
73
  src/chatlogin/web/assets/users.css
69
74
  src/chatlogin/web/assets/users.js
75
+ src/chatlogin/web/templates/chatlogin/account-menu.html
70
76
  src/chatlogin/web/templates/chatlogin/login.html
71
77
  src/chatlogin/web/templates/chatlogin/profile.html
72
78
  src/chatlogin/web/templates/chatlogin/users.html
@@ -101,10 +107,12 @@ tests/code-tests/test_managed_sessions.py
101
107
  tests/code-tests/test_managed_ui.py
102
108
  tests/code-tests/test_managed_users.py
103
109
  tests/code-tests/test_managed_web.py
110
+ tests/code-tests/test_onboarding_acceptance.py
104
111
  tests/code-tests/test_origin_mount.py
105
112
  tests/code-tests/test_packaging_demo.py
106
113
  tests/code-tests/test_packaging_imports.py
107
114
  tests/code-tests/test_scaffold_contract.py
115
+ tests/code-tests/test_service_onboarding.py
108
116
  tests/code-tests/test_session_purge.py
109
117
  tests/code-tests/test_sqlite_security.py
110
118
  tests/code-tests/test_storage_platform.py
@@ -32,7 +32,7 @@ from .security import LoginRateLimiter, require_csrf, safe_next
32
32
  from .sessions import IssuedSession, MemorySessionStore, Session, SessionManager, SessionStore, StoreFull
33
33
  from .sqlite import SQLiteSessionStore
34
34
 
35
- __version__ = "0.2.0"
35
+ __version__ = "0.2.1"
36
36
  __all__ = [
37
37
  "__version__", "AccessDenied", "Principal", "Role", "require_admin", "require_owner", "require_role", "require_user",
38
38
  "AsyncCallbackBackend", "AsyncCredentialBackend", "CallbackBackend", "CredentialBackend",
@@ -0,0 +1,59 @@
1
+ """Optional, host-composable account navigation fragment."""
2
+ from __future__ import annotations
3
+
4
+ from dataclasses import dataclass
5
+ from pathlib import Path
6
+ from typing import Callable, Mapping, Sequence
7
+
8
+ from jinja2 import ChoiceLoader, Environment, FileSystemLoader, PackageLoader, select_autoescape
9
+
10
+ from .user_ui import _template_dirs, _template_name
11
+ from .ui import _local_url
12
+
13
+
14
+ @dataclass(frozen=True)
15
+ class AccountMenuUI:
16
+ mode: str = "gear"
17
+ language: str = "zh-CN"
18
+ template_dirs: Sequence[str | Path] | None = None
19
+ template_name: str = "chatlogin/account-menu.html"
20
+ renderer: Callable[[Mapping[str, object]], str] | None = None
21
+
22
+ def __post_init__(self) -> None:
23
+ if self.mode not in {"gear", "links"}:
24
+ raise ValueError("mode must be gear or links")
25
+ if self.language not in {"zh-CN", "en"}:
26
+ raise ValueError("language must be zh-CN or en")
27
+ _template_name(self.template_name)
28
+ object.__setattr__(self, "template_dirs", _template_dirs(self.template_dirs, ()))
29
+ if self.renderer is not None and not callable(self.renderer):
30
+ raise TypeError("renderer must be callable")
31
+
32
+ def render(self, context: Mapping[str, object]) -> str:
33
+ data = dict(context)
34
+ for link in data.get("links", ()):
35
+ _local_url(link["url"], "account link")
36
+ if data.get("assets_path"):
37
+ _local_url(data["assets_path"], "assets_path")
38
+ data["mode"] = self.mode
39
+ labels = ({"login": "登录", "profile": "我的账号", "users": "用户管理"}
40
+ if self.language == "zh-CN" else
41
+ {"login": "Login", "profile": "My profile", "users": "Manage users"})
42
+ data["links"] = [dict(link, label=labels.get(link.get("key"), link["label"]))
43
+ for link in data.get("links", ())]
44
+ data["settings_label"] = "账号设置" if self.language == "zh-CN" else "Account settings"
45
+ if data.get("role") == "guest":
46
+ data["identity"] = "访客" if self.language == "zh-CN" else "Guest"
47
+ if self.renderer is not None:
48
+ html = self.renderer(data)
49
+ if not isinstance(html, str):
50
+ raise TypeError("renderer must return trusted HTML as a string")
51
+ return html
52
+ if not data["links"]:
53
+ return ""
54
+ loaders = []
55
+ if self.template_dirs:
56
+ loaders.append(FileSystemLoader([str(path) for path in self.template_dirs]))
57
+ loaders.append(PackageLoader("chatlogin.web", "templates"))
58
+ environment = Environment(loader=ChoiceLoader(loaders), autoescape=select_autoescape(("html", "xml"), default=True))
59
+ return environment.get_template(self.template_name).render(**data)
@@ -35,11 +35,7 @@
35
35
  <li>User can view and change only its own profile and password.</li>
36
36
  </ul>
37
37
  </section>
38
- <nav aria-label="Managed demo entry points">
39
- <a id="managed-demo-login" href="{{LOGIN_URL}}">Login</a>
40
- <a id="managed-demo-users" href="{{USERS_URL}}">Manage users</a>
41
- <a id="managed-demo-profile" href="{{PROFILE_URL}}">My profile</a>
42
- </nav>
38
+ {{ACCOUNT_MENU}}
43
39
  </main>
44
40
  </body>
45
41
  </html>