nonebot-plugin-uninfo 0.1.0__tar.gz

nonebot_plugin_uninfo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 RF-Tar-Railt
+
+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.

nonebot_plugin_uninfo-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.1
+Name: nonebot-plugin-uninfo
+Version: 0.1.0
+Summary: Universal Information Model for Nonebot2
+Author-Email: RF-Tar-Railt <rf_tar_railt@qq.com>
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: nonebot2>=2.3.0
+Requires-Dist: importlib-metadata>=4.13.0
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+  <a href="https://nonebot.dev/">
+    <img src="https://nonebot.dev/logo.png" width="200" height="200" alt="nonebot">
+  </a>
+
+# nonebot-plugin-uninfo
+
+_✨ [Nonebot2](https://github.com/nonebot/nonebot2) 多平台的会话信息(用户、群组、频道)获取插件 ✨_
+
+<p align="center">
+  <img src="https://img.shields.io/github/license/RF-Tar-Railt/nonebot-plugin-uninfo" alt="license">
+  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/nonebot-2.3.0+-red.svg" alt="NoneBot">
+  <a href="https://pypi.org/project/nonebot-plugin-uninfo">
+    <img src="https://badgen.net/pypi/v/nonebot-plugin-uninfo" alt="pypi">
+  </a>
+</p>
+
+</div>
+
+本插件提供了多个模型，可以从不同适配器的 `Bot` 和 `Event` 中提取与会话相关的属性
+
+## 安装
+
+- 使用 nb-cli
+
+```
+nb plugin install nonebot-plugin-uninfo
+```
+
+- 使用 pip
+
+```
+pip install nonebot-plugin-uninfo
+```
+
+## 使用
+
+### 获取 `Session`：
+
+```python
+from nonebot_plugin_uninfo import get_session
+
+@matcher.handle()
+async def handle(bot: Bot, event: Event):
+    session = await get_session(bot, event)
+```
+
+或使用依赖注入的形式：
+
+```python
+from nonebot_plugin_uninfo import Uninfo, UniSession, Session
+
+@matcher.handle()
+async def handle(session: Session = UniSession()):
+    ...
+
+@matcher.handle()
+async def handle1(session: Uninfo):
+    ...
+```
+
+### 拉取用户/群组/频道列表：
+
+```python
+from nonebot_plugin_uninfo import get_interface
+
+@matcher.handle()
+async def handle(bot: Bot):
+    interface = await get_interface(bot)
+    if interface:
+        users = await interface.get_users()
+```
+
+## 模型定义
+
+### `User`
+
+| 属性       | 类型          | 含义    | 备注   |
+|----------|-------------|-------|------|
+| `id`     | str         | 用户 id |      |
+| `name`   | str \| None | 用户名称  |      |
+| `nick`   | str \| None | 用户昵称  | 好友备注 |
+| `avatar` | str \| None | 用户头像  |      |
+| `gender` | str         | 用户性别  |      |
+
+### `Scene`
+
+| 属性       | 类型            | 含义    | 备注                                              |
+|----------|---------------|-------|-------------------------------------------------|
+| `id`     | str           | 场景 id |                                                 |
+| `type`   | SceneType     | 场景类型  | 可分为 `Private`, `Group`, `Guild` 和 `Channel_XXX` |
+| `name`   | str \| None   | 场景名称  |                                                 |
+| `avatar` | str \| None   | 场景图标  |                                                 |
+| `parent`  | Scene \| None | 父级场景  | 适用于频道的二级群组场景, 或针对临时会话的来源群组                      |
+
+### `Member`
+
+| 属性          | 类型               | 含义      | 备注                            |
+|-------------|------------------|---------|-------------------------------|
+| `user`      | User             | 成员的用户信息 |                               |
+| `nick`      | str \| None      | 成员昵称    |                               |
+| `role`      | str \| None      | 成员角色组   | 当可能存在多个角色组时，此处会使用 level 最高的那个 |
+| `mute`      | MuteInfo \| None | 成员禁言信息  |                               |
+| `joined_at` | datetime \| None | 成员加入时间  |                               |
+
+### `Session`
+
+| 属性         | 类型             | 含义     | 备注                 |
+|------------|----------------|--------|--------------------|
+| `self_id`  | str            | 机器人 id |                    |
+| `adapter`  | str            | 适配器名称  |                    |
+| `scope`    | str            | 适配器范围  | 相比 adapter 更指向实际平台 |
+| `scene`    | Scene          | 事件场景   |                    |
+| `user`     | User           | 用户信息   |                    |
+| `member`   | Member \| None | 成员信息   | 仅适用于群组,频道场景        |
+| `operator` | Member \| None | 操作者信息  | 仅适用于群组,频道场景        |
+
+## 示例
+
+```python
+from nonebot_plugin_uninfo import Uninfo
+from nonebot import on_command
+
+matcher = on_command("inspect", aliases={"查看"}, priority=1)
+
+
+@matcher.handle()
+async def inspect(session: Uninfo):
+    texts = [
+        f"平台名: {session.adapter} | {session.scope}",
+        f"用户ID: {session.user.name + ' | ' if session.user.name else ''}{session.user.id}",
+        f"自身ID: {session.self_id}",
+        f"事件场景: {session.scene.type.name}",
+        f"频道 ID: {session.scene.name + ' | ' if session.scene.name else ''}{session.scene.id}"
+    ]
+    if session.scene.parent:
+        texts.append(f"群组 ID: {session.scene.parent.name + ' | ' if session.scene.parent.name else ''}{session.scene.parent.id}")
+    if session.member:
+        texts.append(f"成员 ID: {session.member.nick + ' | ' if session.member.nick else ''}{session.member.id}")
+    await matcher.send("\n".join(texts))
+```
+
+## 支持的 adapter
+
+- [x] OneBot v11
+- [x] OneBot v12
+- [x] Console
+- [x] Kook (Kaiheila)
+- [x] Telegram
+- [x] Feishu
+- [x] Discord
+- [x] QQ
+- [x] Satori
+- [x] DoDo
+- [x] Kritor
+- [x] Mirai
+- [ ] Tailchat
+
+## 相关插件
+
+- [nonebot-plugin-alconna](https://github.com/nonebot/plugin-alconna) 强大的 Nonebot2 命令匹配拓展，支持富文本/多媒体解析，跨平台消息收发
+## 鸣谢
+
+- [nonebot-plugin-session](https://github.com/noneplugin/nonebot-plugin-session) 与 [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) 项目的灵感来源以及部分实现的参考

nonebot_plugin_uninfo-0.1.0/README.md

@@ -0,0 +1,166 @@
+<div align="center">
+
+  <a href="https://nonebot.dev/">
+    <img src="https://nonebot.dev/logo.png" width="200" height="200" alt="nonebot">
+  </a>
+
+# nonebot-plugin-uninfo
+
+_✨ [Nonebot2](https://github.com/nonebot/nonebot2) 多平台的会话信息(用户、群组、频道)获取插件 ✨_
+
+<p align="center">
+  <img src="https://img.shields.io/github/license/RF-Tar-Railt/nonebot-plugin-uninfo" alt="license">
+  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/nonebot-2.3.0+-red.svg" alt="NoneBot">
+  <a href="https://pypi.org/project/nonebot-plugin-uninfo">
+    <img src="https://badgen.net/pypi/v/nonebot-plugin-uninfo" alt="pypi">
+  </a>
+</p>
+
+</div>
+
+本插件提供了多个模型，可以从不同适配器的 `Bot` 和 `Event` 中提取与会话相关的属性
+
+## 安装
+
+- 使用 nb-cli
+
+```
+nb plugin install nonebot-plugin-uninfo
+```
+
+- 使用 pip
+
+```
+pip install nonebot-plugin-uninfo
+```
+
+## 使用
+
+### 获取 `Session`：
+
+```python
+from nonebot_plugin_uninfo import get_session
+
+@matcher.handle()
+async def handle(bot: Bot, event: Event):
+    session = await get_session(bot, event)
+```
+
+或使用依赖注入的形式：
+
+```python
+from nonebot_plugin_uninfo import Uninfo, UniSession, Session
+
+@matcher.handle()
+async def handle(session: Session = UniSession()):
+    ...
+
+@matcher.handle()
+async def handle1(session: Uninfo):
+    ...
+```
+
+### 拉取用户/群组/频道列表：
+
+```python
+from nonebot_plugin_uninfo import get_interface
+
+@matcher.handle()
+async def handle(bot: Bot):
+    interface = await get_interface(bot)
+    if interface:
+        users = await interface.get_users()
+```
+
+## 模型定义
+
+### `User`
+
+| 属性       | 类型          | 含义    | 备注   |
+|----------|-------------|-------|------|
+| `id`     | str         | 用户 id |      |
+| `name`   | str \| None | 用户名称  |      |
+| `nick`   | str \| None | 用户昵称  | 好友备注 |
+| `avatar` | str \| None | 用户头像  |      |
+| `gender` | str         | 用户性别  |      |
+
+### `Scene`
+
+| 属性       | 类型            | 含义    | 备注                                              |
+|----------|---------------|-------|-------------------------------------------------|
+| `id`     | str           | 场景 id |                                                 |
+| `type`   | SceneType     | 场景类型  | 可分为 `Private`, `Group`, `Guild` 和 `Channel_XXX` |
+| `name`   | str \| None   | 场景名称  |                                                 |
+| `avatar` | str \| None   | 场景图标  |                                                 |
+| `parent`  | Scene \| None | 父级场景  | 适用于频道的二级群组场景, 或针对临时会话的来源群组                      |
+
+### `Member`
+
+| 属性          | 类型               | 含义      | 备注                            |
+|-------------|------------------|---------|-------------------------------|
+| `user`      | User             | 成员的用户信息 |                               |
+| `nick`      | str \| None      | 成员昵称    |                               |
+| `role`      | str \| None      | 成员角色组   | 当可能存在多个角色组时，此处会使用 level 最高的那个 |
+| `mute`      | MuteInfo \| None | 成员禁言信息  |                               |
+| `joined_at` | datetime \| None | 成员加入时间  |                               |
+
+### `Session`
+
+| 属性         | 类型             | 含义     | 备注                 |
+|------------|----------------|--------|--------------------|
+| `self_id`  | str            | 机器人 id |                    |
+| `adapter`  | str            | 适配器名称  |                    |
+| `scope`    | str            | 适配器范围  | 相比 adapter 更指向实际平台 |
+| `scene`    | Scene          | 事件场景   |                    |
+| `user`     | User           | 用户信息   |                    |
+| `member`   | Member \| None | 成员信息   | 仅适用于群组,频道场景        |
+| `operator` | Member \| None | 操作者信息  | 仅适用于群组,频道场景        |
+
+## 示例
+
+```python
+from nonebot_plugin_uninfo import Uninfo
+from nonebot import on_command
+
+matcher = on_command("inspect", aliases={"查看"}, priority=1)
+
+
+@matcher.handle()
+async def inspect(session: Uninfo):
+    texts = [
+        f"平台名: {session.adapter} | {session.scope}",
+        f"用户ID: {session.user.name + ' | ' if session.user.name else ''}{session.user.id}",
+        f"自身ID: {session.self_id}",
+        f"事件场景: {session.scene.type.name}",
+        f"频道 ID: {session.scene.name + ' | ' if session.scene.name else ''}{session.scene.id}"
+    ]
+    if session.scene.parent:
+        texts.append(f"群组 ID: {session.scene.parent.name + ' | ' if session.scene.parent.name else ''}{session.scene.parent.id}")
+    if session.member:
+        texts.append(f"成员 ID: {session.member.nick + ' | ' if session.member.nick else ''}{session.member.id}")
+    await matcher.send("\n".join(texts))
+```
+
+## 支持的 adapter
+
+- [x] OneBot v11
+- [x] OneBot v12
+- [x] Console
+- [x] Kook (Kaiheila)
+- [x] Telegram
+- [x] Feishu
+- [x] Discord
+- [x] QQ
+- [x] Satori
+- [x] DoDo
+- [x] Kritor
+- [x] Mirai
+- [ ] Tailchat
+
+## 相关插件
+
+- [nonebot-plugin-alconna](https://github.com/nonebot/plugin-alconna) 强大的 Nonebot2 命令匹配拓展，支持富文本/多媒体解析，跨平台消息收发
+## 鸣谢
+
+- [nonebot-plugin-session](https://github.com/noneplugin/nonebot-plugin-session) 与 [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) 项目的灵感来源以及部分实现的参考

nonebot_plugin_uninfo-0.1.0/pyproject.toml

@@ -0,0 +1,131 @@
+[project]
+name = "nonebot-plugin-uninfo"
+version = "0.1.0"
+description = "Universal Information Model for Nonebot2"
+authors = [
+    { name = "RF-Tar-Railt", email = "rf_tar_railt@qq.com" },
+]
+dependencies = [
+    "nonebot2>=2.3.0",
+    "importlib-metadata>=4.13.0",
+]
+requires-python = ">=3.9"
+readme = "README.md"
+
+[project.license]
+text = "MIT"
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.dev-dependencies]
+dev = [
+    "isort>=5.13.2",
+    "black>=24.4.2",
+    "loguru>=0.7.2",
+    "ruff>=0.4.2",
+    "fastapi>=0.110.2",
+    "uvicorn[standard]>=0.28.1",
+    "pydantic>=2.7.0",
+    "nonebot2[httpx,websockets]>=2.3.0",
+    "nonebot-adapter-console>=0.5.0",
+    "nonebot-adapter-ding>=2.0.0a16",
+    "nonebot-adapter-discord>=0.1.8",
+    "nonebot-adapter-dodo>=0.2.1",
+    "nonebot-adapter-feishu>=2.6.0",
+    "nonebot-adapter-kaiheila>=0.3.4",
+    "nonebot-adapter-mirai>=2.3.3",
+    "nonebot-adapter-mirai2>=0.0.22",
+    "nonebot-adapter-minecraft>=1.3.2",
+    "nonebot-adapter-onebot>=2.4.3",
+    "nonebot-adapter-qq>=1.5.1",
+    "nonebot-adapter-red>=0.9.0",
+    "nonebot-adapter-satori>=0.12.5",
+    "nonebot-adapter-telegram>=0.1.0b17",
+    "nonebot-adapter-kritor>=0.3.0",
+    "nonebot-adapter-tailchat>=0.1.0b7",
+]
+
+[tool.pdm.build]
+includes = [
+    "src/nonebot_plugin_uninfo",
+]
+
+[tool.pdm.scripts.format]
+composite = [
+    "isort ./src/ ",
+    "black ./src/ ",
+    "ruff check ./src/",
+]
+
+[tool.black]
+line-length = 120
+target-version = [
+    "py39",
+    "py310",
+    "py311",
+    "py312",
+]
+include = "\\.pyi?$"
+extend-exclude = ""
+
+[tool.isort]
+profile = "black"
+line_length = 120
+length_sort = false
+skip_gitignore = true
+force_sort_within_sections = true
+extra_standard_library = [
+    "typing_extensions",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "UP",
+    "C",
+    "T",
+    "PYI",
+    "PT",
+    "Q",
+]
+ignore = [
+    "C901",
+    "T201",
+    "E731",
+    "E402",
+]
+
+[tool.pyright]
+pythonVersion = "3.9"
+pythonPlatform = "All"
+typeCheckingMode = "basic"
+reportShadowedImports = false
+disableBytesTypePromotions = true
+
+[tool.pyright.defineConstant]
+PYDANTIC_V2 = true
+
+[tool.nonebot]
+adapters = [
+    { name = "OneBot V11", module_name = "nonebot.adapters.onebot.v11" },
+    { name = "Satori", module_name = "nonebot.adapters.satori" },
+    { name = "QQ", module_name = "nonebot.adapters.qq" },
+]
+plugins = [
+    "example",
+]
+plugin_dirs = []
+builtin_plugins = []

nonebot_plugin_uninfo-0.1.0/src/nonebot_plugin_uninfo/__init__.py

@@ -0,0 +1,34 @@
+from nonebot.plugin import PluginMetadata
+
+from .constraint import SupportAdapterModule
+from .fetch import InfoFetcher as InfoFetcher
+from .model import Session as Session
+from .params import Interface as Interface
+from .params import QryItrface as QryItrface
+from .params import QueryInterface as QueryInterface
+from .params import UniSession as UniSession
+from .params import Uninfo as Uninfo
+from .params import get_interface as get_interface
+from .params import get_session as get_session
+from .permission import ADMIN as ADMIN
+from .permission import GROUP as GROUP
+from .permission import GUILD as GUILD
+from .permission import MEMBER as MEMBER
+from .permission import OWNER as OWNER
+from .permission import PRIVATE as PRIVATE
+from .permission import ROLE_IN as ROLE_IN
+from .permission import ROLE_LEVEL as ROLE_LEVEL
+from .permission import ROLE_NOT_IN as ROLE_NOT_IN
+from .permission import SCENE_IN as SCENE_IN
+from .permission import SCENE_NOT_IN as SCENE_NOT_IN
+from .permission import USER_IN as USER_IN
+from .permission import USER_NOT_IN as USER_NOT_IN
+
+__plugin_meta__ = PluginMetadata(
+    name="通用信息",
+    description="多平台的会话信息(用户、群组、频道)获取插件",
+    usage="session_info: Uninfo",
+    type="library",
+    homepage="https://github.com/RF-Tar-Railt/nonebot-plugin-uninfo",
+    supported_adapters=set(SupportAdapterModule.__members__.values()),
+)

nonebot_plugin_uninfo-0.1.0/src/nonebot_plugin_uninfo/adapters/__init__.py

@@ -0,0 +1,56 @@
+import importlib
+import os
+from pathlib import Path
+from typing import cast
+from warnings import warn
+
+from nonebot import get_adapters
+
+from ..fetch import InfoFetcher
+from ..loader import BaseLoader
+
+root = Path(__file__).parent
+loaders: dict[str, BaseLoader] = {}
+_adapters = [path.stem for path in root.iterdir() if path.is_dir() and not path.stem.startswith("_")]
+for name in _adapters:
+    try:
+        module = importlib.import_module(f".{name}", __package__)
+        loader = cast(BaseLoader, getattr(module, "Loader")())
+        loaders[loader.get_adapter().value] = loader
+    except Exception as e:
+        warn(f"Failed to import uniseg adapter {name}: {e}", RuntimeWarning, 5)
+
+
+INFO_FETCHER_MAPPING: dict[str, InfoFetcher] = {}
+adapters = {}
+try:
+    adapters = get_adapters()
+except Exception as e:
+    warn(f"Failed to get nonebot adapters: {e}", RuntimeWarning, 5)
+
+if os.environ.get("PLUGIN_UNINFO_TESTENV"):
+    for adapter, loader in loaders.items():
+        try:
+            INFO_FETCHER_MAPPING[adapter] = loaders[adapter].get_fetcher()
+        except Exception as e:
+            warn(f"Failed to load uniseg adapter {adapter}: {e}", RuntimeWarning, 5)
+elif not adapters:
+    warn(
+        "No adapters found, please make sure you have installed at least one adapter.",
+        RuntimeWarning,
+        5,
+    )
+else:
+    for adapter in adapters:
+        if adapter in loaders:
+            try:
+                INFO_FETCHER_MAPPING[adapter] = loaders[adapter].get_fetcher()
+            except Exception as e:
+                warn(f"Failed to load uniseg adapter {adapter}: {e}", RuntimeWarning, 5)
+        else:
+            warn(
+                f"Adapter {adapter} is not found in the uniseg.adapters,"
+                f"please go to the github repo and create an issue for it.",
+                RuntimeWarning,
+                5,
+            )

nonebot_plugin_uninfo-0.1.0/src/nonebot_plugin_uninfo/adapters/console/__init__.py

@@ -0,0 +1,13 @@
+from nonebot_plugin_uninfo.constraint import SupportAdapter
+from nonebot_plugin_uninfo.fetch import InfoFetcher
+from nonebot_plugin_uninfo.loader import BaseLoader
+
+
+class Loader(BaseLoader):
+    def get_adapter(self) -> SupportAdapter:
+        return SupportAdapter.console
+
+    def get_fetcher(self) -> InfoFetcher:
+        from .main import fetcher
+
+        return fetcher

nonebot_plugin_uninfo-0.1.0/src/nonebot_plugin_uninfo/adapters/console/main.py

@@ -0,0 +1,57 @@
+from typing import Optional
+
+from nonebot.adapters.console import Bot
+from nonebot.adapters.console.event import Event
+
+from nonebot_plugin_uninfo.constraint import SupportAdapter, SupportScope
+from nonebot_plugin_uninfo.fetch import InfoFetcher as BaseInfoFetcher
+from nonebot_plugin_uninfo.fetch import SuppliedData
+from nonebot_plugin_uninfo.model import Scene, SceneType, User
+
+
+class InfoFetcher(BaseInfoFetcher):
+    def extract_user(self, data):
+        return User(
+            id=data["user_id"],
+            name=data["name"],
+            avatar=data["avatar"],
+        )
+
+    def extract_scene(self, data):
+        return Scene(
+            id=data["user_id"],
+            type=SceneType.PRIVATE,
+            name=data["name"],
+            avatar=data["avatar"],
+        )
+
+    def extract_member(self, data, user: Optional[User]):
+        return None
+
+    async def query_user(self, bot: Bot):
+        raise NotImplementedError
+
+    async def query_scene(self, bot: Bot, guild_id: Optional[str]):
+        raise NotImplementedError
+
+    async def query_member(self, bot: Bot, guild_id: str):
+        raise NotImplementedError
+
+    def supply_self(self, bot: Bot) -> SuppliedData:
+        return {
+            "self_id": str(bot.self_id),
+            "adapter": SupportAdapter.console,
+            "scope": SupportScope.console,
+        }
+
+
+fetcher = InfoFetcher(SupportAdapter.console)
+
+
+@fetcher.supply_wildcard
+async def _(bot: Bot, event: Event):
+    return {
+        "user_id": event.user.id,
+        "name": event.user.nickname,
+        "avatar": f"https://emojicdn.elk.sh/{event.user.avatar}?style=twitter",
+    }

nonebot_plugin_uninfo-0.1.0/src/nonebot_plugin_uninfo/adapters/discord/__init__.py

@@ -0,0 +1,13 @@
+from nonebot_plugin_uninfo.constraint import SupportAdapter
+from nonebot_plugin_uninfo.fetch import InfoFetcher
+from nonebot_plugin_uninfo.loader import BaseLoader
+
+
+class Loader(BaseLoader):
+    def get_adapter(self) -> SupportAdapter:
+        return SupportAdapter.discord
+
+    def get_fetcher(self) -> InfoFetcher:
+        from .main import fetcher
+
+        return fetcher