Pyparrot 项目安装与使用教程

1. 项目的目录结构及介绍

Pyparrot 项目的目录结构如下：

pyparrot/
├── coursework/
├── docs/
├── examples/
├── pyparrot/
│   ├── Bebop.py
│   ├── DroneVision.py
│   ├── DroneVisionGUI.py
│   ├── Minidrone.py
│   ├── VisionServer.py
│   └── __init__.py
├── .gitignore
├── LICENSE
├── MANIFEST.in
├── README.md
├── readthedocs.yml
└── setup.py

目录结构介绍

• coursework/: 包含课程相关文件。
• docs/: 包含项目文档文件。
• examples/: 包含示例代码文件。
• pyparrot/: 核心代码目录，包含与 Parrot 无人机交互的 Python 模块。
  • Bebop.py: 与 Parrot Bebop 无人机交互的模块。
  • DroneVision.py: 无人机视觉处理模块。
  • DroneVisionGUI.py: 无人机视觉 GUI 模块。
  • Minidrone.py: 与 Parrot Minidrone 无人机交互的模块。
  • VisionServer.py: 视觉服务器模块。
  • init.py: 初始化文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• MANIFEST.in: 打包清单文件。
• README.md: 项目介绍和使用说明。
• readthedocs.yml: ReadTheDocs 配置文件。
• setup.py: 项目安装配置文件。

2. 项目的启动文件介绍

Pyparrot 项目没有明确的“启动文件”，因为它的主要功能是通过 Python 模块调用来实现的。用户可以根据需要导入 pyparrot 目录中的模块，并编写自己的脚本来控制无人机。

例如，要启动一个简单的无人机控制脚本，可以创建一个新的 Python 文件，并导入 pyparrot 模块：

from pyparrot.Minidrone import Mambo

# 创建 Mambo 对象
mambo = Mambo("your_mambo_address_here", use_wifi=True)

# 连接到无人机
success = mambo.connect(num_retries=3)

if success:
    print("连接成功")
    mambo.safe_takeoff(5)
    mambo.safe_land(5)
else:
    print("连接失败")

3. 项目的配置文件介绍

Pyparrot 项目的主要配置文件是 setup.py，它用于项目的安装和打包。以下是 setup.py 文件的简要介绍：

from setuptools import setup, find_packages

setup(
    name='pyparrot',
    version='1.5.3',
    packages=find_packages(),
    install_requires=[
        # 依赖项列表
    ],
    author='Amy McGovern',
    author_email='[e-mail]',
    description='Python interface for Parrot Drones',
    long_description=open('README.md').read(),
    long_description_content_type='text/markdown',
    license='MIT',
    url='https://github.com/amymcgovern/pyparrot',
    classifiers=[
        'Development Status :: 5 - Production/Stable',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
        'Programming Language :: Python :: 3.9',
    ],
)

配置文件介绍

• name: 项目名称。
• version: 项目版本号。
• packages: 需要包含的 Python 包。
• install_requires: 项目依赖项列表。
• author: 项目作者。
• author_email: 作者邮箱。
• description: 项目简短描述。
• long_description: 项目详细描述，通常从 README.md 文件中读取。
• long_description_content_type: 详细描述的内容类型。
• license: 项目许可证。
• url: 项目主页 URL。
• classifiers: 项目分类信息。

通过 setup.py 文件，用户可以轻松地安装和打包 Pyparrot 项目。