6. Evennia 库概述¶

有几种很好的方法可以探索 Evennia 库。

本文档包含 Evennia-API 文档，这些文档是从源码自动生成的。尝试点击一些条目——一旦深入，你会看到每个组件的完整描述及其文档。你也可以点击 [source] 查看每个内容的完整 Python 源代码。
如果你想要更详细的解释，可以查看每个组件的独立文档页面。
你可以浏览 GitHub 上的 Evennia 仓库。这就是你可以从我们这里下载的内容。
最后，你可以将 Evennia 仓库克隆到自己的电脑上并阅读源码。如果你想真正理解发生了什么，或者帮助 Evennia 的开发，这是必要的。请参阅扩展安装说明以了解如何操作。

6.1. 它在哪里？¶

如果安装了 Evennia，你可以通过以下方式简单地导入它：

import evennia
from evennia import some_module
from evennia.some_module.other_module import SomeClass

等等。

如果你是通过 pip install 安装的 Evennia，库文件夹将被安装在你的 Python 安装目录深处；你最好在 GitHub 上查看它。如果你是克隆的，你应该有一个 evennia 文件夹可以查看。

你会发现这是最外层的结构：

evennia/
    bin/
    CHANGELOG.md
    ...
    ...
    docs/
    evennia/

这个外层是用于 Evennia 的安装和包分发。内部文件夹 evennia/evennia/ 是 实际的 库，即 API 自动文档所涵盖的内容，也是你执行 import evennia 时得到的内容。

evennia/docs/ 文件夹包含本文档的源文件。查看贡献文档以了解更多关于其工作原理的信息。

这是 Evennia 库的结构：

虽然所有实际的 Evennia 代码都位于各个文件夹中，但 __init__.py 代表整个包 evennia。它包含了指向实际位于其他地方的代码的“快捷方式”。如果你在 Evennia-API 页面上向下滚动一点，大多数这些快捷方式都列在那里。

在上一课中，我们简要查看了 mygame/typeclasses/objects 作为 Python 模块的一个示例。让我们再打开它。

"""
模块文档字符串
"""
from evennia import DefaultObject

class Object(DefaultObject):
    """
    类文档字符串
    """
    pass

我们有 Object 类，它继承自 DefaultObject。模块顶部附近有这一行：

from evennia import DefaultObject

我们想弄清楚这个 DefaultObject 提供了什么。由于这是直接从 evennia 导入的，我们实际上是从 evennia/__init__.py 导入的。

from .objects.objects import DefaultObject

你也可以查看 API 首页的右侧部分并通过这种方式点击查看代码。

DefaultObject 被导入到 __init__.py 这里，这使得即使类的代码实际上不在这里，也可以通过 from evennia import DefaultObject 导入它。

因此，要找到 DefaultObject 的代码，我们需要查看 evennia/objects/objects.py。以下是在文档中查找的方法：

这是一个重要的课程。它教你如何自己寻找信息。知道如何跟随类继承树并导航到你需要的东西是学习像 Evennia 这样的新库的重要部分。

接下来，我们将开始利用迄今为止学到的知识，并将其与 Evennia 提供的构建块结合起来。