（サブ）モジュールで__init__.pyを使用して名前空間を定義する方法？

Question

私の質問は、Python（3.x）パッケージと（サブ）モジュールを書くことと、__init__.pyファイルを正しく使って名前空間を宣言することです。
私はC++でコーディングしていましたので、プロジェクトを編成するためにたくさんの別々のファイルを使いたいと思います。たとえば、（imo）モジュールに複数のクラスが含まれている場合、これらのクラスはそれぞれ別のファイルに存在する必要があります。

私はPythonでの開発に慣れていないので、私の考えを簡単な質問で策定することは難しいです。 次に、小さなpythonパッケージを例として考えてみましょう。

ディレクトリレイアウト

dir 
| 
+-- example 
| | 
| +-- script.py 
| 
+-- package 
     | 
     +-- __init__.py 
     | 
     +-- foo.py 
     | 
     +-- subpackage 
      | 
      +-- __init__.py 
      | 
      +-- bar.py 

のファイルを見てみましょう。

package/foo.pyファイル内容：

def foo: 
    print('foo') 

package/subpackage/bar.pyは：

def bar: 
    print('bar') 

次example/script.pyが正常に動作します。

import sys 
sys.path.insert(0, '..') 

import package 
import package.subpackage 


package.foo.foo() 
package.subpackage.bar.bar() 

私はpackage.foo.foo()/package.subpackage.bar.bar()を使用することを好きではないとpackage.foo()/package.subpackage.bar()を使用したいと思います。

from package.subpackage.bar import barを使用したくありません。サブパッケージの名前空間をスクリプトに混ぜる必要はありません。

ソリューションは、私はそれを達成するために__init__.pyファイルを使用していました。

package/__init__.py：

from package.foo import foo 

package/subpackage/__init__.py：

from package.subpackage.bar import bar 

質問

• これは、名前空間を定義するのは良いのpython-ような方法は何ですか？あるいは、Pythonでパッケージのファイルシステムを整理するためのより良い/共通の方法があります。 （私はこれのために適切なチュートリアル/例を見つけることができませんでした。）ファイルpackage/subpackage/__init__.pyで

は、なぜそれがあることを持っています：

from package.subpackage.bar import bar

ない：

を？

これはエラーになり：

Traceback (most recent call last): 
File "script.py", line x, in <module> 
import package.subpackage 
File "..\package\subpackage\__init__.py", line x, in <module> 
from subpackage.bar import bar 
ImportError: No module named 'subpackage' 

Answer 1

Is this a good python-like way to define namespaces? Or is there a better/common way to organize the file-system of a package in python. (I did not find a proper tutorial/example for this.)

これは、セットアップPythonパッケージへ大丈夫方法です。 foo.pyとbar.pyの内容のため、のみが、ではなく「良好」ではありません。

I don't like to use package.foo.foo()/package.subpackage.bar.bar() and would like to use package.foo()/package.subpackage.bar() .

この場合、できません。名前空間を混在させないと、from package.subpackage.bar import barを実行しないとよい理由です。

def foo(): ...とdef bar(): ...が直接__init__.pyであった方が良いでしょう。そうすれば、package.foo()とpackage.subpackage.bar()を実行できました。また、initで__all__を使用することで完了した可能性もありますが、import *も良いとはみなされません。

あるいは、fooとbarパッケージはそれより人に優しい理解できる組織を与えるなどfoo.function1、foo.other_func、bar.drink、のようなことでより多くを持っている必要があります。

• Structuring Your Project — The Hitchhiker's Guide to Python
• The Pythonic way of organizing modules and packages
• How to organize a Python Project?