d2：デフォルトのパッケージモジュール（__init__.pyのようですが、Dの場合）

Question

私はprivateモジュールまたはpackageモジュールの洗練されたツリーを持つ大規模なライブラリパッケージを持っています - それをfunnylibとしましょう。エンドユーザーが直接内部モジュール（のようなfunnylib.foo、funnylib.barなど）をタッチすることは望ましいことではないですので、私が代わりに外部インタフェースを提供したい - このように：

funnylib.d：

public import funnylib.foo; 
public import funnylib.bar; 
public import funnylib.baz; 

だけであることをエンドユーザがimport funnylibのようにインポートしました。問題は、Dがfunnylib.dとfunnylib/を同時に持つことを禁止していることです。

Pythonで__init__.pyのように、「default package module」のようなものがありますか？いいえ、上記の設計を行う正しい方法は何ですか？

アップデート1：私はfunnylibはもはやアクセスpackageシンボルを保護しますと、そのfunnylibは罰金インポートされますが、これは保護低下（強く望ましくない）のコストを持つことになり、funnylib_privateのようにパッケージ化するiternalモジュールを移動について考え、そして不快なファイルレイアウトにつながります。

Answer 1

をインポートするために文書化されている公共の輸入で簡単なallモジュールを作成します。したがって、例えば、Phobosはstd/algorithm.dとstd/algorithm/sorting.dを持つことができませんでした。 std/algorithm.dとstd/algorithmが矛盾します。典型的なことは、ratchet freak describesであり、そのパッケージ内のすべてのモジュールを公にインポートするallという名前のモジュールを使用します。あなたはすべてのサブモジュールを使用しているという事実を隠したい場合しかし、あなたは単に

funnylib.d 
_funnylib/foo.d 
_funnylib/bar.d 
_funnylib/baz.d 

なくどこでも_funnylibを文書化するような何かを行うことができ、それは、DDOCで非常にうまく機能しません。それぞれ_funnylibモジュールのドキュメントを生成する予定であり、funnylib.dのために生成するものは、ドキュメント化するシンボルがないため、モジュールドキュメントです。モジュールシステムは、あなたがしようとしているようなモジュールを隠してしまうという考えで設計されていません。それが（大きくなりすぎたとき

さて、は、それが可能になるためproposal under discussionはきれいにパッケージにモジュールを分割するために、現在あり例えばそのように明示的などstd.algorithm.search、std.algorithm.sorting、コードにstd.algorithmを分割する場合std.algorithm.countUntilは現在でもstd.algorithm.search.countUntilになっていても使用されません）。一度それが整理されれば、それを使うことができますが、ドキュメントはあなたのuber-moduleではなく、各サブモジュールについても実行されます。これは本当にあなたがモジュールを分割しているという事実を隠そうとするのではなく、コードを変換する手段としての意味です。これは、基本的にはallモジュールを使用することと同じですが、パッケージが単一のモジュールであった場合にコードを破るのを避けるために、意味論的な砂糖を使用しています。

Answer 2

あなたはモジュールと同じ名前のパッケージを使用することはできませんライブラリ

module funnylib.all; 

public import funnylib.foo; 
public import funnylib.bar; 
public import funnylib.baz;