How tableau/tabcmd works
Main Components
a. Command Layer:
• Commands by functionality domains (auth, datasources_and_workbooks, extracts, group, project, site, user)
• Command controller (tabcmd_controller.py) as the central orchestrator
b. Execution Layer:
• Global options handling
• Localization system
• Logging system
• Version management
c. External Integration:
• Tableau Server/Cloud API interaction
• Authentication/Session management
• File system interactions for import/export
Architecture Pattern
The project follows a Command Pattern architecture with these key elements:
• Command Parser/Router
• Command Executors
• Global State Management
• Internationalization (i18n) Support
[User CLI Input] → [Parent Parser] → [Command Router]
• ↓
[Global Options] → [TabCmd Controller] ← [Command Executors]
• ↓ ↓
[Session Management] → [Tableau Server/Cloud API]
Key Relationships
a. Command Flow:
CLI Input → Parser → Command Mapping → Command Execution → API Calls
b. Support Systems Integration:
Localization System ←→ Command Execution
Logging System ←→ All Components
Global Options ←→ Command Execution
Important Implementation Details
• Command categories as separate modules:
• Authentication Commands
• Datasource/Workbook Management
• Extract Management
• User Management
• Site Management
• Project Management
• Cross-cutting concerns:
• Session Management
• Logging
• Internationalization
• Configuration
→ : Data/Control Flow
↔ : Bidirectional Communication
⟲ : Recurring Process
□ : Core Component
◇ : Decision Point
○ : Support System