drawlib.diagrams.architecture（アーキテクチャ構成図）

アイコン付きサービスカード、ネスト可能な境界グループ、直交バスルーティングを備えた、クラウド・インフラ・分散システム向けの宣言的アーキテクチャ構成図モジュールです。標準インポート: from drawlib.diagrams.architecture import ArchitectureDiagram, Edge, GcpIcon, Junction, Node, NodeGroup, PhosphorIcon。

from drawlib.canvas import save, setup
from drawlib.diagrams.architecture import ArchitectureDiagram, GcpIcon, Node, NodeGroup, PhosphorIcon
from drawlib.styles import Colors, Styles

setup(width=120, height=64)

d = ArchitectureDiagram(
    node_style=Styles.Primary,
    node_text_style=Styles.DarkBold.patch(text_size=10.5),
    edge_style=Styles.DarkBold,
    edge_text_style=Styles.Dark.patch(text_size=10.0),
    node_card_style=Styles.Neutral,
)

client = d.add(
    Node("Client", width=18, height=16, icon=PhosphorIcon.LAPTOP, icon_size=7.0),
    xy=(9.0, 25.0),
)

vpc = d.add(
    NodeGroup(
        title="VPC Network",
        width=56,
        height=54,
        padding=5.0,
        style=Styles.PrimaryNeutral.patch(line_style="dashed"),
        text_style=Styles.PrimaryBold.patch(text_size=11.0, halign="left"),
    ),
    xy=(30.0, 0.0),
)
gateway = vpc.add(
    Node(
        "API Gateway",
        width=20,
        height=16,
        icon=PhosphorIcon.CLOUD_CHECK,
        icon_size=6.5,
        style=Styles.White,
        text_style=Styles.WhiteBold.patch(text_color=Colors.White, text_size=10.5),
        card_style=Styles.PrimaryFlat,
    ),
    xy=(13.5, 25.0),
)
auth_pod = vpc.add(
    Node("Auth Pod", width=19, height=15, icon=GcpIcon.GOOGLE_KUBERNETES_ENGINE, icon_size=6.5),
    xy=(43.0, 36.5),
)
order_pod = vpc.add(
    Node(
        "Order Pod",
        width=19,
        height=15,
        icon=GcpIcon.GOOGLE_KUBERNETES_ENGINE,
        icon_size=6.5,
        card_style=Styles.SecondaryNeutral,
    ),
    xy=(43.0, 13.5),
)

db = d.add(
    Node("Cloud SQL", width=20, height=16, icon=GcpIcon.CLOUD_SQL, icon_size=7.0, card_style=Styles.SecondaryNeutral),
    xy=(102.0, 25.0),
)

d.connect(client, gateway, label="HTTPS", padding=1.0)
gateway.fork([auth_pod, order_pod], at_x=58.0, padding=1.0)
d.connect(auth_pod, db, padding=1.0)
d.connect(order_pod, db, padding=1.0)

d.draw(xy=(60.0, 32.0), align="center")
save()

classArchitectureDiagram#

サービスノード、ネストされた境界グループ、ジャンクション（分岐・合流点）、およびエッジルーティングを統合管理するアーキテクチャ構成図のトップレベルコンテナです。

ArchitectureDiagram(
    *,
    node_style: Style,
    node_text_style: Style,
    edge_style: Style,
    edge_text_style: Style,
    node_card_style: Style | None = None,
    title: str = "",
    title_style: Style | None = None,
    width: float | None = None,
    height: float | None = None,
    style: Style | None = None,
) -> None

• 座標アンカー: draw(xy=(0.0, 0.0), align="bottom_left") は図のローカル左下原点 (0.0, 0.0) をキャンバス座標 xy に配置します（align="center" の場合は図全体のバウンディングボックス中心を xy に配置）。自動トポロジ座標計算については ArchitectureGraph.get_layout() を参照してください。

コンストラクタ引数#

パブリックメソッド・プロパティ#

classNode#

アーキテクチャ構成図内のサービス、アクター、コンピュートインスタンス、マネージドテスト・DB リソースを表すノードカード要素です。

Node(
    text: str = "",
    width: float = 20.0,
    height: float = 16.0,
    icon: IconType = None,
    icon_size: float = 8.0,
    style: Style | None = None,
    text_style: Style | None = None,
    card_style: Style | None = None,
    show: bool = True,
) -> None

• 座標アンカー: 中心 (cx, cy)。d.add(node, xy=(cx, cy)) では図ルート座標、group.add(node, xy=(lx, ly)) では親 NodeGroup の左下 (0, 0) からのグループ相対中心座標で指定します。

コンストラクタ引数#

パブリックメソッド・プロパティ#

classNodeGroup#

Node カード、Junction、およびネストされたサブグループを束ねる階層的境界コンテナです（クラウドリージョン、VPC、サブネット、Kubernetes クラスタ等の表現に最適）。

NodeGroup(
    title: str = "",
    width: float | None = None,
    height: float | None = None,
    padding: float = 5.0,
    style: Style | None = None,
    text_style: Style | None = None,
    show: bool = True,
) -> None

• 座標アンカー: 左下 (x0, y0)。group.add(child, xy=(lx, ly)) に渡す座標 (lx, ly) は、その group 自身の左下隅 (0, 0) を基準とするグループ相対座標になります（子要素が Node なら中心、ネストされた NodeGroup なら左下）。

コンストラクタ引数#

パブリックメソッド・プロパティ#

classEdge#

2 つの接続可能要素（Node、NodeGroup、Junction）を結ぶ単方向・双方向・無方向の接続エッジです。

Edge(
    start: Connectable,
    end: Connectable,
    label: str = "",
    arrow: ArrowType = "->",
    routing: RoutingType = "orthogonal",
    style: Style | None = None,
    text_style: Style | None = None,
    padding: PaddingType = 0.0,
    show: bool = True,
) -> None

• 座標アンカー: start と end の外周境界アンカーに自動接続されます。.points()、.via()、.add_point() に渡す中間ウェイポイントは図ルート座標系 (x, y) を使用します。

コンストラクタ引数#

パブリックメソッド・プロパティ#

classJunction#

アーキテクチャ構成図内でエッジの折れ曲がり制御や複数エッジの分岐・合流に用いる面積ゼロの接続ポイントです。

Junction(
    xy: tuple[float, float],
    *,
    show: bool = True,
) -> None

• 座標アンカー: 親コンテナ（ArchitectureDiagram または NodeGroup）内の厳密な点座標 (x, y)。通常は d.junction(xy) または edge.add_point(xy) から生成します。

コンストラクタ引数#

パブリックメソッド・プロパティ#

classCustomIcon#

任意のラスター画像ファイル、Dimage オブジェクト、または PIL.Image.Image インスタンスをラップし、Node(..., icon=CustomIcon(...)) として利用可能にするアダプタクラスです。

CustomIcon(
    image: str | Path | Dimage | Image | CustomIcon,
) -> None

• 座標アンカー: ホストとなる Node カード内のアイコンスロット中央に icon_size で自動配置されます。

コンストラクタ引数#

パブリックメソッド・プロパティ#

typeicons#

CustomIcon、IconType、および全 34 種類の構成図アイコン列挙型をまとめて提供する再エクスポート・サブモジュール名前空間（drawlib.diagrams.architecture.icons）です。

from drawlib.diagrams.architecture import icons

# サブモジュール名前空間経由でのアクセス:
node = Node("Gateway", icon=icons.GcpIcon.API_GATEWAY)

• 座標アンカー: 該当なし（40 個のアイコン型およびヘルパーを再公開する名前空間モジュール）。

enumIcon Enums (34 Suites)#

Node(..., icon=<Enum>.<MEMBER>) で宣言的に指定可能な、全 34 種類の標準アイコン StrEnum クラス群です（drawlib.diagrams.architecture 直下および drawlib.diagrams.architecture.icons の双方から再エクスポートされています）。PhosphorIcon は node.style / diagram.node_style で任意の色に着色可能な単色ベクターフォントアイコンであり、残り 33 スイートは drawlib.icons のマルチカラー／パステル PNG アセットを描画します。