Nonebot-plugin-alconna

What's Changed
* `Text` 和 `UniMessage` 新增 `replace` 方法
* 修复 telegram 适配器下按钮无法发送的问题 by KomoriDev in https://github.com/nonebot/plugin-alconna/pull/60

New Contributors
* KomoriDev made their first contribution in https://github.com/nonebot/plugin-alconna/pull/60

**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.50.1...v0.50.2

- 修复 `AlconnaMatcher.send` 会调用两次 `send_wrapper` 的问题
- `UniMessage` 新增方法 `map` 和 `select`
- 移除非必要的 `Segment.from_`

**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.50.0...v0.50.1

新增
- 增加 `Button` 与 `Keyboard` 消息段，表示按钮元素与按钮组/按钮矩阵元素。
- `Button` 有四种 flag: `action`, `link`, `input`, `enter`
- `Keyboard` 不传入参数 `row` 时，根据适配器情况自动选择作为一行发送或者换行成按钮矩阵
- 只传入 `Button` 或 只传入 `Keyboard` 时，根据适配器情况自动选择合并为 Keyboard 或展开为 Button
- 增加内建消息段 `Markdown`, 负责专门适配 `QQ` 适配器下的 md消息模板
- 若 `Markdown` 只传入了参数 `content` , 其行为与构造 `Text(...).markdown()` 相同
python
from nonebot_plugin_alconna import Button
from nonebot_plugin_alconna.builtins.uniseg.markdown import Markdown

await (
Markdown(
template_id="102060544_1720161790",
params={
"text": ["a"],
"image_spec": ["1024px 648px"],
"image": ["http://res.dunnoaskrf.top/gacha_sim_910f39dca8bb930cc35175f23289dd65.png"],
},
)
+ Button("enter", "再来一发", text="/十连")
).send()

- `UniMessage` 新增若干方法：
- `transform` & `tansform_async`: 遍历消息并依据传入的规则对消息内容进行替换/验证
- `split`: 和 `str.split` 差不多, 提供一个字符串, 然后返回分割结果.
- `startswith` & `endswith`: 断消息链是否以给出的字符串开头/结尾
- `removeprefix` & `removesuffix`: 移除消息链前缀/后缀
- `strip` & `lstrip` & `rstrip`: 去除首尾的空白字符

改进
- 在 `QQ` 适配器的群聊场景下 `Reply` 元素暂时会略过
- `Extension` 的 send_wrapper 现在在 `UniMessage.send` 时会调用
* ⬆️ Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by dependabot in https://github.com/nonebot/plugin-alconna/pull/58


**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.49.0...v0.50.0

新增
- `UniMessage` 新增 `export_sync` 方法，用来同步形式调用 `.export` 方法
python
from nonebot_plugin_alconna import UniMessage

msg = UniMessage.at("123").text("hello").export_sync(adapter="OneBot V11")

- 新增配置项 `ALCONNA_BUILTIN_PLUGINS`, 用来在配置项中声明要加载的内置插件
- `echo` 插件增加配置项 `NBP_ALC_ECHO_TOME`
- `help` 插件增加配置项 `NBP_ALC_HELP_TEXT`, `NBP_ALC_HELP_ALIAS` 等
- `help` 插件新增命名空间的相关功能（列出，筛选）
- `Command` 构造器增加 `.namespace`

改进
- `MusicShare.brief` 字段改名为 `.summary`
- `TelegramSlashExtension` 现在会检查 command 参数是否符合 tg 标准
- `context` 中增加 `bot.self_id`, `bot.platform` 和 `adapter.name` 三项
- `UniMessage.export` 增加 `adapter` 参数表示指定适配器，并将 bot 参数设为严格可选
- `select` 方法现在返回一个自定义的 `SelectPattern`, 其上有 `.nth()`, `.first`, `.last`, `.from_()` 四个方法/属性
python
from nonebot_plugin_alconna import Image, Video, select

img = select(Image).first
img_in_video = select(Image).from_(Video).nth(1)

- :arrow_up: auto update by pre-commit hooks by pre-commit-ci in https://github.com/nonebot/plugin-alconna/pull/56


**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.48.0...v0.49.0

新增
* `AlconnaMatcher.test` 方法，其用来在 startup 阶段测试 alc 对象的可用性。
python
matcher = on_alconna(...)
matcher.test("command bar", {"foo": "bar"})

* `builtins.uniseg.MusicShare`, 对应qq下的音乐分享元素

改进
* feat: support `Media.name` in `telegram` adapter by lgc2333 in https://github.com/nonebot/plugin-alconna/pull/55
* `AlconnaMatcher.shortcut` 现在返回值为 matcher 自身

**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.47.2...v0.48.0

新增
- `at_me` 和 `at_in` 两个 Rule，分别表示消息是否at了bot自己，是否at了指定目标（暂时不考虑尾部at）

改进
- 传入 alc 解析的消息现在不带 reply 了

**Full Changelog**: https://github.com/nonebot/plugin-alconna/compare/v0.47.1...v0.47.2