Python：Tailscale API的异步客户端

Tailscale API的异步客户端。

关于

此包允许您以编程方式控制和监控Tailscale客户端。它主要创建来允许第三方程序集成到Tailscale。

安装

pip install tailscale

使用

import asyncio

from tailscale import Tailscale


async def main():
    """Show example on using the Tailscale API client."""
    async with Tailscale(
        tailnet="frenck",
        api_key="tskey-somethingsomething",
    ) as tailscale:

        devices = await tailscale.devices()
        print(devices)


if __name__ == "__main__":
    asyncio.run(main())

变更日志 & 发布

此仓库使用GitHub的发布功能维护变更日志。日志的格式基于Keep a Changelog。

发布基于语义版本化，并使用MAJOR.MINOR.PATCH格式。简而言之，版本将根据以下方式递增：

• MAJOR：不兼容或重大更改。
• MINOR：向后兼容的新功能和增强。
• PATCH：向后兼容的修复和包更新。

贡献

这是一个活跃的开源项目。我们始终欢迎那些想使用或贡献代码的人。

我们已为我们的贡献指南建立了一个单独的文档。

感谢您的参与！ :heart_eyes

设置开发环境

本Python项目完全使用Poetry依赖管理器进行管理。同时，在开发过程中也依赖于NodeJS进行某些检查。

您至少需要以下内容

• Python 3.11+
• Poetry
• NodeJS 20+（包括NPM）

安装所有包，包括所有开发需求

npm install
poetry install

由于此存储库使用pre-commit框架，每次提交都会对所有更改进行lint和测试。您可以使用以下命令手动运行所有检查和测试

poetry run pre-commit run --all-files

仅运行Python测试

poetry run pytest

作者和贡献者

此存储库的原始设置由Franck Nijhof完成。

要查看所有作者和贡献者的完整列表，请查看贡献者页面。

许可证

MIT许可协议

版权所有 (c) 2021-2024 Franck Nijhof

在此特此免费授予任何人获得此软件及其相关文档文件（“软件”）副本的权利，无论是否付费，都可以在不受限制的情况下处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向提供软件的个人提供这样做，前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他原因而产生的，与软件或其使用或其他交易有关。