SVG.Path 开源项目使用教程

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

SVG.Path 项目的目录结构相对简单，主要包含以下几个部分：

svg.path/
├── LICENSE
├── MANIFEST.in
├── README.md
├── setup.cfg
├── setup.py
├── svg
│   ├── __init__.py
│   ├── path.py
│   └── tests
│       ├── __init__.py
│       ├── test_path.py
│       └── test_parser.py
└── tox.ini

• LICENSE: 项目的许可证文件。
• MANIFEST.in: 用于指定在打包时包含的文件。
• README.md: 项目的说明文档。
• setup.cfg: 配置文件，用于设置一些打包和测试的选项。
• setup.py: 用于安装和打包项目的脚本。
• svg/: 项目的主要代码目录。
  • init.py: 使 svg 目录成为一个 Python 包。
  • path.py: 实现 SVG 路径操作的核心代码。
  • tests/: 包含项目的测试代码。
    • init.py: 使 tests 目录成为一个 Python 包。
    • test_path.py: 针对 path.py 的测试代码。
    • test_parser.py: 针对路径解析的测试代码。
• tox.ini: 用于配置 tox 自动化测试工具。

2. 项目的启动文件介绍

SVG.Path 项目的启动文件是 svg/path.py。这个文件包含了处理 SVG 路径的主要功能，包括路径的解析、操作和生成。以下是 path.py 文件的主要内容概述：

• Path 类：用于表示和操作 SVG 路径。
• parse_path 函数：用于解析 SVG 路径字符串。
• Line, QuadraticBezier, CubicBezier, Arc 等类：用于表示不同类型的路径段。

3. 项目的配置文件介绍

SVG.Path 项目的配置文件主要包括 setup.cfg 和 tox.ini。

setup.cfg

setup.cfg 文件用于配置打包和测试的一些选项。以下是一些关键配置：

[metadata]
name = svg.path
version = 4.1
description = SVG path objects and parser
long_description = file: README.md
long_description_content_type = text/markdown
url = https://github.com/regebro/svg.path
author = Lennart Regebro
author_email = [e-mail]
license = MIT
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

[options]
packages = find:
python_requires = >=3.6

[options.package_data]
* = *.txt, *.rst, *.md

[tool:pytest]
addopts = --doctest-modules

tox.ini

tox.ini 文件用于配置 tox 自动化测试工具。以下是一些关键配置：

[tox]
envlist = py36,py37,py38,py39
skipsdist = True

[testenv]
deps =
    pytest
commands =
    pytest

这些配置文件确保了项目的正确打包、分发和测试。