Mona 的 Unix Domain Socket 客户端代码

此存储库包含 UDS 代码的所有 Mona python 客户端。主包位于目录“client”下，并作为“mona-uds-client”发布到 PyPi。

Mona UDS 客户端需要本地部署的 Mona 代理才能运行。其他软件包包含有关如何在不同环境中安装 Mona 代理的必要信息，并单独发布。

如有任何问题，请发送电子邮件至 itai@monalabs.io。

示例使用：

示例代码可以在 client/mona_uds_client_test.py 中找到。

简而言之，安装 PyPi 包后： $ pip install mona_uds_client

这是常见的用法：

from mona_uds_client.mona_uds_client import MonaUdsClient, MonaSingleMessage

# Use User ID as supplied by Mona team here.
client = MonaUdsClient("test_user")

# Use relevant context ID as defined in Mona configuration.
context_class = "MY_CONTEXT"

# Export a batch of two messages to Mona.
message1 = {"x": 1, "s": "some_str", "l": ["a"], "o": {"k": ["v1", "v2"]}}
message2 = {"x": 2, "s": "another_str", "l": ["b"], "o": {"k": ["v3", "v4"]}}

# Actual export
client.export(
    [
        MonaSingleMessage(
            contextId="context_id1",
            message=message1,
            arcClass=context_class,
        ),  # No export timestamp means use current time
        MonaSingleMessage(
            contextId="context_id2",
            message=message2,
            arcClass=context_class,
            exportTimestamp=1234567890
        ),
    ]
)

部署

UDS 客户端使用本地文件夹与 Mona UDS 代理进行通信。因此，当部署在容器上时，需要将以下挂载添加到容器的 YAML 中：

在 spec.template.spec 中：

volumes:
- name: uds-mona-socket
  hostPath:
    path: /var/run/mona-agent/

在 spec.template.spec.container 中：

volumeMounts:
- mountPath: /uds/mona
  name: uds-mona-socket

将新版本上传到 PyPI

要遵循的主要参考是： https ://packaging.python.org/tutorials/packaging-projects/

先决条件：

1. 使用您的 mona 电子邮件在 PyPI 上注册：https ://pypi.org/
2. 请联系 itai@monalabs.io或nemo@monalabs.io将您添加为合作者
3. 如果未安装，请安装 twine： $ python3 -m pip install --user --upgrade twine
4. 如果未安装，请安装构建工具： $ python3 -m pip install --user --upgrade setuptools wheel

实际上传：

1. 在 setup.py 下更改版本号
2. 如果需要新的依赖项，请将其添加到 setup.py 下的“install_requires”下
3. 构建新版本：

$ python3 setup.py sdist bdist_wheel

4. 上传新版本（可以将'*'更改为实际版本）：

$ python -m twine upload dist/*