Struct SdkImplBuilder 

pub struct SdkImplBuilder { /* private fields */ }

SdkImplのビルダー。

Location（拠点）を location() で登録し、ルートを connect() で宣言する。 Location からスキャナーが自動導出され、ルートコストは LocationKind の 組み合わせから自動推定される。

使用例

let sdk = SdkImplBuilder::new(topology_files, location_files, transfer_store)
    .location(Arc::new(LocalLocation::new(root, hasher)))
    .location(Arc::new(SshLocation::new(pod_id, pod_root, shell)))
    .location(Arc::new(CloudLocation::new(cloud_id, cloud_root, backend)))
    .connect(&local_id, &cloud_id, rclone_backend)
    .connect_with_shell(&pod_id, &cloud_id, pod_rclone, pod_shell)
    .connect_pull(&cloud_id, &local_id, rclone_pull)
    .exclude(".git")
    .build()?;

Implementations

impl SdkImplBuilder

pub fn new( topology_files: Arc<dyn TopologyFileStore>, location_files: Arc<dyn LocationFileStore>, transfer_store: Arc<dyn TransferStore>, ) -> Self

必須3ストアでビルダーを作成。

pub fn archive_route_to(self, dest: &LocationId, archive_root: PathBuf) -> Self

Enable archive-on-delete for routes targeting dest.

All routes whose destination is dest will move deleted files to {archive_root}/{ISO8601_ts}/{relative_path} instead of hard-deleting. The backend must implement archive_move (e.g. RcloneBackend via rclone moveto).

pub fn location(self, loc: Arc<dyn Location>) -> Self

Location（拠点）追加。

Location trait 実装からスキャナーが自動導出される。 同じLocationIdの二重登録は無視される。

pub fn connect( self, src: &LocationId, dest: &LocationId, backend: Box<dyn StorageBackend>, ) -> Self

Push方向のルート接続を宣言。

src → dest への転送ルートを登録する。 file_root は build() 時に Location から自動解決される。 コストは LocationKind の組み合わせから自動推定される。

pub fn connect_with_shell( self, src: &LocationId, dest: &LocationId, backend: Box<dyn StorageBackend>, src_shell: Box<dyn RemoteShell>, ) -> Self

Push方向 + ソース側Shell付きのルート接続。

リモートホスト（Pod等）がソースの場合、ソース側でのファイル操作 （存在確認、ハッシュ計算）に src_shell を使用する。

pub fn connect_pull( self, src: &LocationId, dest: &LocationId, backend: Box<dyn StorageBackend>, ) -> Self

Pull方向のルート接続。

Cloud → Local, Cloud → Pod のように、リモートからローカル方向への 転送ルートを登録する。backend.pull() が使用される。

pub fn config(self, config: SyncConfig) -> Self

SyncConfig設定。

pub fn exclude(self, pattern: &str) -> Self

スキャン除外パターン追加。

pub fn build(self) -> Result<SdkImpl, SyncError>

SdkImplを構築。

1. Location から Scanner を自動導出
2. PendingRoute → TransferRoute に変換（file_root 自動解決 + コスト自動推定）
3. TransferRoute から RouteGraph + TransferEngine を構築
4. TopologyStore + TopologyScanner を構築