# sphinx.ext.inheritance_diagram -- 継承関係図の追加¶

バージョン 0.6 で追加.

この拡張機能を使うと、継承関係図をドキュメントに挿入できます。図は、 Graphviz拡張 を使ってレンダリングされます。

この拡張機能は次のディレクティブを追加します。

.. inheritance-diagram::

このディレクティブは1つ以上の引数を持ちます。モジュールかクラス名を与えます。現在説明中のモジュールの中であれば(py:module 参照)、クラス名の名前には完全修飾名以外も使えます。

This directive supports an option called parts that, if given, must be an integer, advising the directive to keep that many dot-separated parts in the displayed names (from right to left). For example, parts=1 will only display class names, without the names of the modules that contain them.

バージョン 2.0 で変更: The value of for parts can also be negative, indicating how many parts to drop from the left. For example, if all your class names start with lib., you can give :parts: -1 to remove that prefix from the displayed node names.

The directive also supports a private-bases flag option; if given, private base classes (those whose name starts with _) will be included.

ダイアグラムに見出しをつけるには、captionオプションを利用できます。

バージョン 1.1 で変更: private-bases オプションを追加しました。以前は常に全てのベースクラスが含まれていました。

バージョン 1.5 で変更: 追加されたcaptionオプション

It also supports a top-classes option which requires one or more class names separated by comma. If specified inheritance traversal will stop at the specified class names. Given the following Python module:

"""
A
/ \
B   C
/ \ / \
E   D   F
"""

class A:
pass

class B(A):
pass

class C(A):
pass

class D(B, C):
pass

class E(B):
pass

class F(C):
pass


If you have specified a module in the inheritance diagram like this:

.. inheritance-diagram:: dummy.test
:top-classes: dummy.test.B, dummy.test.C


any base classes which are ancestors to top-classes and are also defined in the same module will be rendered as stand alone nodes. In this example class A will be rendered as stand alone node in the graph. This is a known issue due to how this extension works internally.

If you don't want class A (or any other ancestors) to be visible then specify only the classes you would like to generate the diagram for like this:

.. inheritance-diagram:: dummy.test.D dummy.test.E dummy.test.F
:top-classes: dummy.test.B, dummy.test.C


バージョン 1.7 で変更: Added top-classes option to limit the scope of inheritance graphs.

## サンプル¶

The following are different inheritance diagrams for the internal InheritanceDiagram class that implements the directive.

With full names:

.. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram


Showing class names only:

.. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram
:parts: 1


Stopping the diagram at sphinx.util.docutils.SphinxDirective (the highest superclass still part of Sphinx), and dropping the common left-most part (sphinx) from all names:

.. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram
:top-classes: sphinx.util.docutils.SphinxDirective
:parts: -1


## 設定¶

inheritance_graph_attrs

inheritance_graph_attrs = dict(rankdir="LR", size='"6.0, 8.0"',
fontsize=14, ratio='compress')

inheritance_node_attrs

inheritance_node_attrs = dict(shape='ellipse', fontsize=14, height=0.75,
color='dodgerblue1', style='filled')

inheritance_edge_attrs

inheritance_alias

Allows mapping the full qualified name of the class to custom values (useful when exposing the underlying path of a class is not desirable, e.g. it's a private class and should not be instantiated by the user).

inheritance_alias = {'_pytest.Magic': 'pytest.Magic'}