How dlr-sc/gitlab2prov works
Main Components
a. External Systems:
• GitLab Instance (API)
• Git Repositories
• File System (for output)
b. Core Application Components:
• CLI Interface (entrypoints/cli.py)
• Configuration Management (config/)
• Domain Layer (domain/)
• Service Layer (service_layer/)
• Adapters Layer (adapters/)
• PROV Model Generation (prov/)
Architecture Pattern
The project follows a clean architecture pattern with clear separation of concerns:
• Entrypoints (CLI)
• Service Layer (handlers, messagebus, unit of work)
• Domain Layer (business logic)
• Adapters (external integrations)
[External Systems]
GitLab API <-----> Adapters Layer (gitlab.py)
Git Repos <-----> Adapters Layer (git.py)
[Core Application]
CLI Interface
• v
Configuration Management
• v
Service Layer (Message Bus)
• v
Domain Layer
• v
PROV Model Generation
• v
Output Formats (JSON/RDF/XML/DOT)
Important Elements to Highlight
a. Data Flow:
• Command flow from CLI through the service layer
• Data fetching from GitLab/Git through adapters
• PROV model generation and transformation
b. Key Components:
• Message Bus pattern for command handling
• Unit of Work pattern for consistency
• Repository pattern for data access
• PROV model generation and transformation
Additional Details
Specific features like:
• Pseudonymization capability
• Graph combination functionality
• Multiple output format support
• Configuration validation