7

При инициализации пакета в Python 2.7, мне нужно определить функции, которые должны быть общими для всех модулей данного пакета. Я определил их в __init__.py. Как теперь к ней обратиться внутри пакета? Извне получается так:

import package.module
package.foo() #обращение

Внутри пакета (например в модуле module), не определено foo, dir(__package__) - так же не выводит этой функции.

Структура проекта:

package\         # пакет
    __init__.py  # здесь функция
    module.py    # здесь мне функцию нужно вызвать

Названия, естественно, отличаются.

0

3 ответа 3

9

Исправлено

На самом деле, файл __init__.py не предназначен для хранения реализации общих для пакета функций. Их предлагается выносить в другие файлы.

Вот что говорится в документации:

<...> In the simplest case, __init__.py can just be an empty file, but it can also execute initialization code for the package or set the __all__ variable, described later.

Цитата с python-guide.org:

<...> special behavior for the __init__.py file, which is used to gather all package-wide definitions.

<...>

Leaving an init.py file empty is considered normal and even a good practice, if the package’s modules and sub-packages do not need to share any code.

Lastly, a convenient syntax is available for importing deeply nested packages: import very.deep.module as mod. This allows you to use mod in place of the verbose repetition of very.deep.module.


Таким образом, __init__.py нужен для того, чтобы настроить представление реализации пакета для использующих его скриптов. Например, с помощью переменной __all__ вы можете управлять видимыми подмодулями, или импортировать какой-то класс на уровень модуля.

Так что ответом на ваш вопрос будет то, что сейчас у вас неправильно распределена реализация функций по файлам, и стоит создать отдельный файл с реализацией нужных вам функций, а не хранить их в __init__.py.


Например, если у вас сейчас есть функция boo в файле __init__.py, вы можете вынести её в файл module.py, при необходимости вынеся её на уровень пакета, добавив следующую строку в ваш файл __init__.py:

# файл package/__init__.py
from module import boo

и для внешнего кода, импортирующего ваш модуль, она станет доступна не только через прямой импорт

# файл my_script.py
from package.module import boo

но и через импорт из пакета:

# файл my_script.py
from package import boo          # та же функция

Источники:

5
  • Django пишет что нет такого модуля.
    – A1essandro
    5 мая 2015 в 12:09
  • @A1essandro исправил ответ. На самом деле решение несколько иное. 5 мая 2015 в 12:24
  • спасибо, за подробное объяснение.
    – A1essandro
    6 мая 2015 в 19:15
  • ваш ответ противоречит, приведённым в нём цитатам. Вы говорите: "файл __init__.py не предназначен для хранения реализации общих для пакета функций", а затем цитируете "special behavior for the __init__.py file, which is used to gather all package-wide definitions." что буквально означает противоположное: особенность __init__.py в том, что собирает все определения общие для пакета (package-wide).
    – jfs
    21 сен 2017 в 13:28
  • @TimofeiBondarev Спасибо за отличный ответ. Очень помогло. 19 дек 2018 в 4:48
4

Внутри пакета к модулям при импортировании из других модулей обращаются через точку. Если к примеру в __init__.py имеется функция create_app, то в другом модуле лежащим в этой этой же папке импортирование этой функции будет таким:

from . import create_app

А если модуль в под-папке, то через две точки:

from .. import create_app

Подроблнее можно почитать либо в официальной документации на docs.python.org, либо в книге "Python. Подробный справочник. 4 издание" Девида Бизли с ISBN 978-5-93286-157-8, начиная со стр. 189

0

Начиная с python3.3+, __init__.py не обязателен:

It used to be a required part of a package old, pre-3.3 "regular package", not newer 3.3+ "namespace package"

Если Вы хотите включить тот или иной модуль в пакет, то нужно указать его в списке пакетов так, в setup.py:

введите сюда описание изображения

setuptools.setup(
    name='mypackage',
    version='0.0.0',
    packages=['mypackage', 'mypackage.x'],
    package_data={
        'mypackage': ['data/hello.txt', '__x/*'],
    },
)

Также можно включать данные в пакет с помощью package_data. Если хотите включить директорию, то укажите *. ринципиального отличия между package_data и packages, я не увидел, за тем исключением, что в package_data можно включать и данные, и файлы *.py.

3

Ваш ответ

By clicking “Отправить ответ”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.