# testsigmahq/testsigma-addons architecture

> Architecture diagram of the GitHub repository testsigmahq/testsigma-addons, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/testsigmahq/testsigma-addons
- Repository: https://github.com/testsigmahq/testsigma-addons

## Overview

##### Main Components

a. Core Add-on Framework Layer:
- Base add-on infrastructure that all individual add-ons extend from
- SDK properties and common utilities
- Standardized build system (Maven based on pom.xml files)

b. -on Categories Layer:
- Web Automation Add-ons
- Mobile Automation Add-ons (Android/iOS)
- Database Integration Add-ons
- UI Element Interaction Add-ons
- Network/Protocol Add-ons
- Utility Add-ons

c. Integration Layer:
- Testsigma Platform Integration
- External Services Integration (SSH, FTP, etc.)
- Database Connectors (SQL Server, Snowflake)

##### Component Relationships

- Inheritance lines showing how individual add-ons extend the core framework
- Integration lines showing how add-ons connect to external services
- Dependencies between add-ons when they share utilities

##### Key Architectural Elements

a. -on Structure Pattern:
**Add-on Package**
- Source Code
- Main Implementation
- Test Implementation
- Resources
- Build Configuration
- Distribution Artifacts

- Core Framework Components (Blue)
- Web Automation Add-ons (Green)
- Mobile Automation Add-ons (Orange)
- Integration Add-ons (Purple)
- Utility Add-ons (Gray)

##### Implementation Details

Technical annotations showing:
- Java-based implementation
- Maven build system
- TestSigma SDK integration
- Test implementation pattern
- Resource management

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Core["Core Framework Layer"]
        SDK["SDK Properties"]
        Build["Build System"]
        Common["Common Utilities"]
    end

    subgraph Web["Web Automation Add-ons"]
        UI["UI Elements"]:::web
        Text["Text Operations"]:::web
        Browser["Browser Actions"]:::web
        Console["Console Actions"]:::web
    end

    subgraph Mobile["Mobile Automation Add-ons"]
        Android["Android Operations"]:::mobile
        Gestures["Mobile Gestures"]:::mobile
        Network["Network Operations"]:::mobile
        Geo["Geolocation"]:::mobile
    end

    subgraph DB["Database Integration"]
        SQL["SQL Server"]:::db
        Snow["Snowflake"]:::db
    end

    subgraph External["External Services"]
        SSH["SSH Integration"]:::ext
        FTP["FTP Integration"]:::ext
    end

    subgraph Utils["Utility Add-ons"]
        String["String Operations"]:::util
        JSON["JSON Operations"]:::util
        PDF["PDF Operations"]:::util
        XML["XML Operations"]:::util
    end

    SDK --> Web
    SDK --> Mobile
    SDK --> DB
    SDK --> External
    SDK --> Utils
    Build --> Web
    Build --> Mobile
    Build --> DB
    Build --> External
    Build --> Utils
    Common --> Web
    Common --> Mobile
    Common --> DB
    Common --> External
    Common --> Utils

    classDef core fill:#2374ab
    classDef web fill:#2a9d8f
    classDef mobile fill:#f4a261
    classDef db fill:#8338ec
    classDef ext fill:#ff006e
    classDef util fill:#586f7c

    click SDK "https://github.com/testsigmahq/testsigma-addons/blob/dev/src/main/resources/testsigma-sdk.properties"
    click Build "https://github.com/testsigmahq/testsigma-addons/blob/dev/pom.xml"
    click UI "https://github.com/testsigmahq/testsigma-addons/tree/dev/automate_checkbox_using_attributes"
    click Text "https://github.com/testsigmahq/testsigma-addons/tree/dev/automate_textbox_using_attributes"
    click Browser "https://github.com/testsigmahq/testsigma-addons/tree/dev/browser_local_storage_actions"
    click Console "https://github.com/testsigmahq/testsigma-addons/tree/dev/developer_console_actions"
    click Android "https://github.com/testsigmahq/testsigma-addons/tree/dev/android_tv_operations"
    click Gestures "https://github.com/testsigmahq/testsigma-addons/tree/dev/mobile_gestures"
    click Network "https://github.com/testsigmahq/testsigma-addons/tree/dev/mobile_network_operations"
    click Geo "https://github.com/testsigmahq/testsigma-addons/tree/dev/mock_geolocation"
    click SQL "https://github.com/testsigmahq/testsigma-addons/tree/dev/sql_server_queries"
    click Snow "https://github.com/testsigmahq/testsigma-addons/tree/dev/snowflakedb_queries"
    click SSH "https://github.com/testsigmahq/testsigma-addons/tree/dev/ssh_command_line_execution"
    click FTP "https://github.com/testsigmahq/testsigma-addons/tree/dev/ftp_file_upload"
    click String "https://github.com/testsigmahq/testsigma-addons/tree/dev/string_actions"
    click JSON "https://github.com/testsigmahq/testsigma-addons/tree/dev/JsonUtils_982187920716202948315267669918166316366"
    click PDF "https://github.com/testsigmahq/testsigma-addons/tree/dev/pdf_actions"
    click XML "https://github.com/testsigmahq/testsigma-addons/tree/dev/xml_verification_"
```
