# jbmol/tool_holdfetch architecture

> Architecture diagram of the GitHub repository jbmol/tool_holdfetch, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jbmol/tool_holdfetch
- Repository: https://github.com/jbmol/tool_holdfetch

## Overview

Hold & Fetch is a Maya utility for temporarily exporting selected objects to a Maya Binary file and importing them back into a scene. The main workflow is shelf or script launch → UI → Hold/Fetch callbacks → core file operations. The UI also supports choosing and locking a custom directory, while path helpers create the documented per-user default. Installer details are excluded as setup machinery. Relationships shown are supported by the README or excerpts; unsampled details are not inferred.

Main entry points: [`hold_fetch_tool/ui.py`](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/ui.py) (Maya UI), [`hold_fetch_tool/core.py`](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/core.py) (Hold / Fetch operations), [`HoldFetch_Launcher.py`](https://github.com/jbmol/tool_holdfetch/blob/main/HoldFetch_Launcher.py) (Standalone launcher), [`hold_fetch_tool/launcher.py`](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/launcher.py) (Tool launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and UI"]
  node_launcher_script["Standalone launcher"]
  node_package_launcher["Tool launcher<br/>[launcher.py]"]
  node_tool_ui["Maya UI<br/>[ui.py]"]
end

subgraph group_operations["Hold and Fetch"]
  node_hold_fetch_core["Hold / Fetch operations<br/>[core.py]"]
  node_temp_file["Temporary Maya file"]
end

subgraph group_paths["Path handling"]
  node_path_helpers["Default path helpers<br/>[paths.py]"]
end

node_maya_user(("Maya user"))
node_maya_scene["Maya scene"]
node_maya_filesystem[("User filesystem")]

node_maya_user -->|"runs"| node_launcher_script
node_launcher_script -->|"loads"| node_package_launcher
node_package_launcher -->|"opens"| node_tool_ui
node_tool_ui -->|"creates default"| node_path_helpers
node_tool_ui -->|"dispatches hold / fetch"| node_hold_fetch_core
node_path_helpers -->|"creates default directory"| node_maya_filesystem
node_hold_fetch_core -->|"exports selection / imports file"| node_maya_scene
node_hold_fetch_core -->|"writes / reads"| node_temp_file
node_temp_file -->|"stored in chosen directory"| node_maya_filesystem

click node_launcher_script "https://github.com/jbmol/tool_holdfetch/blob/main/HoldFetch_Launcher.py"
click node_package_launcher "https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/launcher.py"
click node_tool_ui "https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/ui.py"
click node_path_helpers "https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/paths.py"
click node_hold_fetch_core "https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/core.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher_script,node_package_launcher,node_tool_ui,node_maya_user toneBlue
class node_hold_fetch_core,node_temp_file,node_maya_filesystem toneAmber
class node_path_helpers toneMint
class node_maya_scene toneIndigo
```

## Components

### Entry and UI

- [Standalone launcher](https://github.com/jbmol/tool_holdfetch/blob/main/HoldFetch_Launcher.py): `HoldFetch_Launcher.py`
- [Tool launcher](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/launcher.py): `hold_fetch_tool/launcher.py`
- [Maya UI](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/ui.py): `hold_fetch_tool/ui.py`

### Hold and Fetch

- [Hold / Fetch operations](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/core.py): `hold_fetch_tool/core.py`
- **Temporary Maya file**

### Path handling

- [Default path helpers](https://github.com/jbmol/tool_holdfetch/blob/main/hold_fetch_tool/paths.py): `hold_fetch_tool/paths.py`

### Other components

- **Maya user**
- **Maya scene**
- **User filesystem**

## Connections

- Maya user → Standalone launcher: runs (evidence: `README.txt`)
- Standalone launcher → Tool launcher: loads (evidence: `HoldFetch_Launcher.py`)
- Tool launcher → Maya UI: opens (evidence: `hold_fetch_tool/launcher.py`)
- Maya UI → Default path helpers: creates default (evidence: `hold_fetch_tool/ui.py`)
- Maya UI → Hold / Fetch operations: dispatches hold / fetch (evidence: `hold_fetch_tool/ui.py`)
- Default path helpers → User filesystem: creates default directory (evidence: `hold_fetch_tool/paths.py`)
- Hold / Fetch operations → Maya scene: exports selection / imports file (evidence: `hold_fetch_tool/core.py`)
- Hold / Fetch operations → Temporary Maya file: writes / reads (evidence: `hold_fetch_tool/core.py`)
- Temporary Maya file → User filesystem: stored in chosen directory (evidence: `README.txt`)
