How decalage2/oletools works
Main Components
a) Core Analysis Modules:
• Main analysis tools (olevba, mraptor, msodde, oleobj, rtfobj, etc.)
• Their relationships and dependencies
• Common utilities they share
b) File Format Handlers:
• OLE2 file parser
• RTF parser
• OpenXML parser
• SWF analyzer
c) Support Components:
• Common utilities (in oletools/common/)
• Logging system (log_helper)
• Third-party integrations (thirdparty folder)
• Client Tools Layer |
• [olevba] [mraptor] [msodde] [oleobj] [rtfobj] [oleid] [olebrowse] [olemeta] [others] |
• Analysis Layer |
• VBA Analysis | | XLM Analysis | | DDE Detection | | Object Extraction | |
• Parser Layer |
• OLE2 Parser | | RTF Parser | | OOXML | | SWF | | Format | |
• Handler | | Analyzer | | Detection | |
• Common Services Layer |
• Logging System | | Crypto Utils | | CLSID Library | | Common IO Utilities | |
Connection Types
• Double lines: API boundaries
Additional Elements
• Version information
• Optional vs. required components
• Error handling paths
Metadata
A metadata section showing:
• Python version compatibility
• Key dependencies
• Licensing information
• Integration capabilities
Implementation Notes
• Maintain separate views for different detail levels
• A simplified view for quick understanding
• The modular nature of the tools
• The separation between analysis and parsing
• The common utilities shared across components
• The security-focused architecture
• The extensibility points for third-party integration