APLpy 项目启动与配置教程

1. 项目目录结构及介绍

APLpy（Astronomical Plotting Library in Python）是一个用于生成天文学图像数据（FITS格式）的出版质量图表的Python模块。项目目录结构如下：

• .circleci/：存放持续集成配置文件。
• .github/：包含GitHub Actions的工作流文件，用于自动化各种任务，如代码测试、构建等。
• aplpy/：核心模块目录，包含所有Python代码文件。
  • tests/：单元测试代码。
  • examples/：示例代码和图像。
• docs/：文档源文件，用于构建项目的官方文档。
• scripts/：辅助脚本。
• CHANGES.md：项目更新日志。
• CITATION：引用本项目的信息。
• LICENSE.md：项目的许可协议文件。
• MANIFEST.in：打包配置文件。
• README.rst：项目的readme文件。
• conftest.py：pytest配置文件。
• pyproject.toml：项目元数据和构建系统配置。
• tox.ini：tox测试配置文件。

2. 项目的启动文件介绍

项目的启动主要是通过安装Python模块来实现的。在aplpy/目录下，主要的启动文件是__init__.py，它初始化了APLpy模块并使其可以被Python解释器导入。

# aplpy/__init__.py

"""
aplpy - Astronomical Plotting Library in Python
"""

from .aplpy import FITSFigure

__version__ = '2.2.0'

用户可以通过Python解释器直接导入FITSFigure类来使用APLpy。

3. 项目的配置文件介绍

项目的配置主要是通过pyproject.toml文件进行的，它包含了项目的元数据以及构建系统的配置。以下是pyproject.toml的一个示例：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
packages = find:
install-requires = [
    "matplotlib",
    "astropy",
    "numpy",
    "scipy",
]

[metadata]
name = "aplpy"
version = "2.2.0"
description = "Astronomical Plotting Library in Python"
long�述 = """
APLpy 是一个用于生成出版质量的天文图表的Python模块，它支持FITS格式图像数据。
"""
author = "The APLpy team"
author-email = "[e-mail]"
license = "MIT"
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
    "Topic :: Scientific/Engineering :: Astronomy",
]

在这个配置文件中，指定了项目依赖的包，以及项目的元数据，如名称、版本、描述等。用户在使用pip install aplpy安装模块时，这些配置将自动被使用。