ChatLark 0.1.0__tar.gz

chatlark-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChatArch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chatlark-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: ChatLark
+Version: 0.1.0
+Summary: ChatArch Feishu/Lark bot helpers extracted from ChatTool.
+Author-email: ChatArch <noreply@chatarch.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLark
+Project-URL: Repository, https://github.com/ChatArch/ChatLark
+Keywords: chatlark,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: chatenv<0.3.0,>=0.2.0
+Requires-Dist: lark-oapi==1.5.3
+Requires-Dist: flask>=2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: llm
+Requires-Dist: chattool<8.0.0,>=7.1.0; extra == "llm"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLark">
+        <img src="https://img.shields.io/pypi/v/ChatLark.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLark
+
+ChatArch 的 Feishu/Lark bot helper 包，承接从 ChatTool 拆出的轻量机器人、消息发送、事件服务和消息内容构造能力。更广泛的 Feishu/Lark OpenAPI 操作仍优先使用官方 `lark-cli`。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlark --help
+chatlark --version
+chatlark send --help
+chatlark serve --help
+python -m pytest -q
+python -m build
+```
+
+## CLI
+
+```bash
+chatlark info
+chatlark send USER_ID "Hello"
+chatlark send "Hello"                  # 使用 FEISHU_DEFAULT_RECEIVER_ID
+chatlark send -t chat_id "Hello team" # 使用 FEISHU_DEFAULT_CHAT_ID
+chatlark serve echo
+chatlark serve webhook
+```
+
+AI 对话命令保留为可选边界，避免 ChatLark 基础包依赖 ChatTool 形成循环：
+
+```bash
+pip install "chatlark[llm]"
+chatlark chat
+chatlark serve ai --system "你是工作助手"
+```
+
+## Python API
+
+```python
+from chatlark import LarkBot, ChatSession
+
+bot = LarkBot()
+session = ChatSession(system="你是助手")
+
+@bot.on_message
+def chat(ctx):
+    ctx.reply(session.chat(ctx.sender_id, ctx.text))
+
+bot.start()
+```
+
+## 配置
+
+ChatLark 复用 ChatEnv 的 Feishu 配置字段：
+
+- `FEISHU_APP_ID`
+- `FEISHU_APP_SECRET`
+- `FEISHU_API_BASE`
+- `FEISHU_DEFAULT_RECEIVER_ID`
+- `FEISHU_DEFAULT_CHAT_ID`
+
+可通过环境变量直接提供，也可以通过 `-e/--env` 指定 ChatEnv Feishu profile 或 `.env` 文件。
+
+## 边界
+
+- ChatLark：bot helper、消息发送、事件服务、消息上下文、消息内容构造。
+- lark-cli：广泛 Feishu/Lark OpenAPI 操作和用户授权流程。
+- ChatTool：迁移完成后只应保留有意设计的兼容入口或依赖连接，不再重复持有 Lark business logic。
+
+## 开发说明
+
+扩展前先阅读 `DEVELOP.md` 和 `AGENTS.md`。发布走 PyPI Trusted Publisher/OIDC workflow，不使用本地 token 上传正式版本。

chatlark-0.1.0/README.md

@@ -0,0 +1,85 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLark">
+        <img src="https://img.shields.io/pypi/v/ChatLark.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLark
+
+ChatArch 的 Feishu/Lark bot helper 包，承接从 ChatTool 拆出的轻量机器人、消息发送、事件服务和消息内容构造能力。更广泛的 Feishu/Lark OpenAPI 操作仍优先使用官方 `lark-cli`。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlark --help
+chatlark --version
+chatlark send --help
+chatlark serve --help
+python -m pytest -q
+python -m build
+```
+
+## CLI
+
+```bash
+chatlark info
+chatlark send USER_ID "Hello"
+chatlark send "Hello"                  # 使用 FEISHU_DEFAULT_RECEIVER_ID
+chatlark send -t chat_id "Hello team" # 使用 FEISHU_DEFAULT_CHAT_ID
+chatlark serve echo
+chatlark serve webhook
+```
+
+AI 对话命令保留为可选边界，避免 ChatLark 基础包依赖 ChatTool 形成循环：
+
+```bash
+pip install "chatlark[llm]"
+chatlark chat
+chatlark serve ai --system "你是工作助手"
+```
+
+## Python API
+
+```python
+from chatlark import LarkBot, ChatSession
+
+bot = LarkBot()
+session = ChatSession(system="你是助手")
+
+@bot.on_message
+def chat(ctx):
+    ctx.reply(session.chat(ctx.sender_id, ctx.text))
+
+bot.start()
+```
+
+## 配置
+
+ChatLark 复用 ChatEnv 的 Feishu 配置字段：
+
+- `FEISHU_APP_ID`
+- `FEISHU_APP_SECRET`
+- `FEISHU_API_BASE`
+- `FEISHU_DEFAULT_RECEIVER_ID`
+- `FEISHU_DEFAULT_CHAT_ID`
+
+可通过环境变量直接提供，也可以通过 `-e/--env` 指定 ChatEnv Feishu profile 或 `.env` 文件。
+
+## 边界
+
+- ChatLark：bot helper、消息发送、事件服务、消息上下文、消息内容构造。
+- lark-cli：广泛 Feishu/Lark OpenAPI 操作和用户授权流程。
+- ChatTool：迁移完成后只应保留有意设计的兼容入口或依赖连接，不再重复持有 Lark business logic。
+
+## 开发说明
+
+扩展前先阅读 `DEVELOP.md` 和 `AGENTS.md`。发布走 PyPI Trusted Publisher/OIDC workflow，不使用本地 token 上传正式版本。

chatlark-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatLark"
+dynamic = ["version"]
+description = "ChatArch Feishu/Lark bot helpers extracted from ChatTool."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "click>=8.0",
+    "chatstyle>=0.1.0,<0.2.0",
+    "chatenv>=0.2.0,<0.3.0",
+    "lark-oapi==1.5.3",
+    "flask>=2.0",
+]
+authors = [{name = "ChatArch", email = "noreply@chatarch.org"}]
+keywords = ["chatlark", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatLark"
+Repository = "https://github.com/ChatArch/ChatLark"
+
+[project.scripts]
+chatlark = "chatlark.cli:main"
+
+[project.optional-dependencies]
+dev = ["build", "pytest", "twine"]
+llm = ["chattool>=7.1.0,<8.0.0"]
+
+[tool.setuptools.dynamic]
+version = {attr = "chatlark.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatlark-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

chatlark-0.1.0/src/ChatLark.egg-info/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: ChatLark
+Version: 0.1.0
+Summary: ChatArch Feishu/Lark bot helpers extracted from ChatTool.
+Author-email: ChatArch <noreply@chatarch.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLark
+Project-URL: Repository, https://github.com/ChatArch/ChatLark
+Keywords: chatlark,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: chatenv<0.3.0,>=0.2.0
+Requires-Dist: lark-oapi==1.5.3
+Requires-Dist: flask>=2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: llm
+Requires-Dist: chattool<8.0.0,>=7.1.0; extra == "llm"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLark">
+        <img src="https://img.shields.io/pypi/v/ChatLark.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLark/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLark
+
+ChatArch 的 Feishu/Lark bot helper 包，承接从 ChatTool 拆出的轻量机器人、消息发送、事件服务和消息内容构造能力。更广泛的 Feishu/Lark OpenAPI 操作仍优先使用官方 `lark-cli`。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlark --help
+chatlark --version
+chatlark send --help
+chatlark serve --help
+python -m pytest -q
+python -m build
+```
+
+## CLI
+
+```bash
+chatlark info
+chatlark send USER_ID "Hello"
+chatlark send "Hello"                  # 使用 FEISHU_DEFAULT_RECEIVER_ID
+chatlark send -t chat_id "Hello team" # 使用 FEISHU_DEFAULT_CHAT_ID
+chatlark serve echo
+chatlark serve webhook
+```
+
+AI 对话命令保留为可选边界，避免 ChatLark 基础包依赖 ChatTool 形成循环：
+
+```bash
+pip install "chatlark[llm]"
+chatlark chat
+chatlark serve ai --system "你是工作助手"
+```
+
+## Python API
+
+```python
+from chatlark import LarkBot, ChatSession
+
+bot = LarkBot()
+session = ChatSession(system="你是助手")
+
+@bot.on_message
+def chat(ctx):
+    ctx.reply(session.chat(ctx.sender_id, ctx.text))
+
+bot.start()
+```
+
+## 配置
+
+ChatLark 复用 ChatEnv 的 Feishu 配置字段：
+
+- `FEISHU_APP_ID`
+- `FEISHU_APP_SECRET`
+- `FEISHU_API_BASE`
+- `FEISHU_DEFAULT_RECEIVER_ID`
+- `FEISHU_DEFAULT_CHAT_ID`
+
+可通过环境变量直接提供，也可以通过 `-e/--env` 指定 ChatEnv Feishu profile 或 `.env` 文件。
+
+## 边界
+
+- ChatLark：bot helper、消息发送、事件服务、消息上下文、消息内容构造。
+- lark-cli：广泛 Feishu/Lark OpenAPI 操作和用户授权流程。
+- ChatTool：迁移完成后只应保留有意设计的兼容入口或依赖连接，不再重复持有 Lark business logic。
+
+## 开发说明
+
+扩展前先阅读 `DEVELOP.md` 和 `AGENTS.md`。发布走 PyPI Trusted Publisher/OIDC workflow，不使用本地 token 上传正式版本。

chatlark-0.1.0/src/ChatLark.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChatLark.egg-info/PKG-INFO
+src/ChatLark.egg-info/SOURCES.txt
+src/ChatLark.egg-info/dependency_links.txt
+src/ChatLark.egg-info/entry_points.txt
+src/ChatLark.egg-info/requires.txt
+src/ChatLark.egg-info/top_level.txt
+src/chatlark/__init__.py
+src/chatlark/bot.py
+src/chatlark/cli.py
+src/chatlark/config.py
+src/chatlark/context.py
+src/chatlark/docx_blocks.py
+src/chatlark/elements.py
+src/chatlark/markdown_blocks.py
+src/chatlark/serve.py
+src/chatlark/session.py
+tests/test_api.py
+tests/test_cli.py
+tests/test_version.py

chatlark-0.1.0/src/ChatLark.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatlark-0.1.0/src/ChatLark.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chatlark = chatlark.cli:main

chatlark-0.1.0/src/ChatLark.egg-info/requires.txt

@@ -0,0 +1,13 @@
+click>=8.0
+chatstyle<0.2.0,>=0.1.0
+chatenv<0.3.0,>=0.2.0
+lark-oapi==1.5.3
+flask>=2.0
+
+[dev]
+build
+pytest
+twine
+
+[llm]
+chattool<8.0.0,>=7.1.0

chatlark-0.1.0/src/ChatLark.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatlark

chatlark-0.1.0/src/chatlark/__init__.py

@@ -0,0 +1,34 @@
+import importlib
+
+
+_LAZY_ATTRS = {
+    "LarkBot": ("chatlark.bot", "LarkBot"),
+    "MessageContext": ("chatlark.context", "MessageContext"),
+    "DocxBlockType": ("chatlark.docx_blocks", "DocxBlockType"),
+    "parse_markdown_blocks": ("chatlark.markdown_blocks", "parse_markdown_blocks"),
+    "ChatSession": ("chatlark.session", "ChatSession"),
+}
+
+
+def __getattr__(name: str):
+    if name == "__version__":
+        return "0.1.0"
+    target = _LAZY_ATTRS.get(name)
+    if target is None:
+        raise AttributeError(name)
+    module_name, attr_name = target
+    value = getattr(importlib.import_module(module_name), attr_name)
+    globals()[name] = value
+    return value
+
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    "LarkBot",
+    "MessageContext",
+    "ChatSession",
+    "DocxBlockType",
+    "parse_markdown_blocks",
+]