manuf 项目安装与使用教程

manuf Parser library for Wireshark's OUI database. 项目地址: https://gitcode.com/gh_mirrors/ma/manuf

1. 项目目录结构及介绍

manuf/
├── github/workflows/          # GitHub Actions 工作流配置文件
├── manuf/                     # 项目核心代码目录
│   ├── __init__.py            # 初始化文件
│   ├── manuf.py               # 主解析库文件
│   └── test_manuf.py          # 测试文件
├── gitignore                  # Git 忽略文件配置
├── LICENSE.txt                # 许可证文件
├── README.md                  # 项目说明文件
├── setup.py                   # 项目安装配置文件
└── manuf.py                   # 命令行工具入口文件

目录详细介绍

github/workflows/: 包含用于自动化测试和部署的 GitHub Actions 配置文件。
manuf/: 核心代码目录，包含项目的主体逻辑。
gitignore: 定义了在版本控制中应忽略的文件和目录。
LICENSE.txt: 项目许可证文件，说明了使用该项目需遵守的协议。
README.md: 项目说明文件，包含了项目简介、安装方法、使用示例等。
setup.py: 项目安装配置文件，用于将项目打包和安装。
manuf.py: 命令行工具入口文件，用于直接在命令行中使用该项目。

2. 项目的启动文件介绍

manuf.py

manuf.py 是项目的命令行入口文件，可以通过以下命令直接使用：

$ python -m manuf <MAC地址>

例如，查询 MAC 地址 BC:EE:7B:00:00:00 的制造商信息：

$ python -m manuf BC:EE:7B:00:00:00

输出结果示例：

Vendor(manuf='AsustekC', comment='ASUSTek COMPUTER INC')

setup.py

setup.py 用于项目的安装和打包，通过以下命令安装项目：

$ git clone https://github.com/coolbho3k/manuf.git
$ cd manuf
$ python setup.py install

安装完成后，可以通过 manuf 命令直接在命令行中使用。

3. 项目的配置文件介绍

gitignore

gitignore 文件定义了在版本控制中应忽略的文件和目录，通常包含以下内容：

Python 缓存文件：如 __pycache__ 目录。
编辑器配置文件：如 .idea、.vscode 目录。
操作系统生成的临时文件：如 .DS_Store。

LICENSE.txt

LICENSE.txt 文件包含了项目的许可证信息，本项目使用 LGPLv3 和 Apache License 2.0 双重许可。

README.md

README.md 是项目的说明文件，包含了以下内容：

项目简介：简要介绍项目的功能和用途。
安装方法：详细说明如何安装和使用项目。
使用示例：提供实际使用项目的示例代码。
许可证信息：说明项目的许可证类型。

manuf 文件

manuf 文件是 Wireshark 的 OUI 数据库文件，用于将 MAC 地址转换为制造商信息。项目默认包含一个初始版本的 manuf 文件，但可以通过以下命令更新到最新版本：

$ manuf --update

更新命令会从 Wireshark 的 git 仓库中获取最新的 manuf 文件。

总结

通过以上介绍，你应该能够了解 manuf 项目的目录结构、启动文件和配置文件的使用方法。希望这篇教程能帮助你顺利安装和使用 manuf 项目。如果有任何问题，请参考项目的 README.md 或联系项目作者。

manuf Parser library for Wireshark's OUI database. 项目地址: https://gitcode.com/gh_mirrors/ma/manuf