Netdisco 项目使用教程

1. 项目目录结构及介绍

Netdisco 是一个使用 Python 3 编写的库，用于发现本地网络中的设备和服务。以下是项目的目录结构及其介绍：

• netdisco/: 根目录，包含主要的 Python 模块和库文件。
• example_service.py: 一个示例服务文件，展示如何使用 Netdisco 库。
• tests/: 测试目录，包含项目的单元测试代码。
• .codehost/: 存储与代码托管平台有关的配置文件。
• .gitignore: 指定版本控制忽略的文件和目录。
• CLA.md: 贡献者协议。
• CODE_OF_CONDUCT.md: 项目行为准则。
• LICENSE.md: 项目许可证信息。
• MANIFEST.in: 包含打包信息。
• README.md: 项目说明文件。
• pylintrc: Python 代码风格配置文件。
• requirements.txt: 项目依赖的第三方库列表。
• setup.cfg: 打包配置文件。
• setup.py: 项目安装和打包脚本。
• tox.ini: tox 配置文件，用于自动化测试。

2. 项目的启动文件介绍

项目的启动主要是通过 netdisco 模块中的 NetworkDiscovery 类来完成的。以下是如何从命令行启动项目的基本方法：

python3 -m netdisco

如果你想查看所有扫描到的原始数据，可以使用以下命令：

python3 -m netdisco dump

在脚本中启动项目，可以按照以下步骤：

from netdisco.discovery import NetworkDiscovery

netdis = NetworkDiscovery()
netdis.scan()

for dev in netdis.discover():
    print(dev, netdis.get_info(dev))

netdis.stop()

上述代码会扫描网络，并列出发现的设备及其相关信息。

3. 项目的配置文件介绍

Netdisco 项目的主要配置是通过 Python 的标准库和模块来进行的，没有专门的配置文件。但是，可以通过修改 netdisco 模块中的默认设置来调整项目的行为。

例如，如果你想要调整扫描间隔或其他运行参数，可以在创建 NetworkDiscovery 对象时传入相应的参数。

由于项目是基于标准 Python 库构建的，因此也可以使用环境变量或命令行参数来调整配置。

请注意，由于项目的维护者不再接受新的协议实现，因此新的配置选项可能有限，主要支持基于 mDNS 或 uPnP 的协议。