10.3.1.1 公共代码和包

如果您在作为 MySQL Shell 插件或插件组的一部分的 Python 代码中使用公共代码或内部包,则必须遵循以下命名和导入要求,以避免包名称之间的潜在冲突:

  • 根据 Python 的 PEP 8 风格指南,插件或插件组的顶级文件夹,以及每个被识别为包的内部文件夹,必须是有效的常规包名称,只能使用字母、数字和下划线。

  • 每个被识别为包的内部文件夹必须包含一个名为__init__.py.

  • 导入时,必须指定包名称的完整路径。例如,如果名为 的插件组 ext包含一个名为 的插件 demo,该插件有一个名为 的内包 src包含一个名为 sample的模块,则必须按如下方式导入该模块:

    from ext.demo.src import sample