# avedian/avedian-dl-examples architecture

> Architecture diagram of the GitHub repository avedian/avedian-dl-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/avedian/avedian-dl-examples
- Repository: https://github.com/avedian/avedian-dl-examples

## Overview

##### Project type and purpose
- This is a set of Python “integration‐example” scripts (EDL-S3 and EDL-Trino) that demonstrate how to connect to Avedian’s EDL service (via Trino/DBAPI) and how to upload data to AWS S3.
- The README confirms it’s not a full product but illustrative code to:
- Query data from EDL through Trino (Example-DBAPI.py)
- Push CSV files into S3 buckets (Example-Upload-S3.py)

##### File structure
- Top level: README.md, two sample‐demo directories (EDL-S3, EDL-Trino), each with:
- requirements.txt  (Python dependencies)
- Example-*.py      (entry‐point scripts)
- No monolithic backend or frontend—each directory is a standalone demo.
- Implicit “deployment” is a local Python venv. No Docker or CI/CD scripts.

##### README for additional insights
- It lists required credentials (Avedian EDL, AWS) and target buckets.
- It provides step‐by‐step commands to create a venv, install deps, and run each example.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Project Files"
        Readme["README.md"]:::doc
        Gitignore[".gitignore"]:::doc
    end

    subgraph "Credentials Layer"
        ENV["Environment Variables"]:::credentials
    end

    subgraph "Client Layer"
        subgraph "Python venv"
            DBAPI["Example-DBAPI.py"]:::code
            reqTrino["requirements.txt"]:::code
            UploadS3["Example-Upload-S3.py"]:::code
            reqS3["requirements.txt"]:::code
            LocalFile["Local CSV File"]:::storage
        end
    end

    subgraph "Service Layer"
        Trino["Avedian Trino Endpoint"]:::service
        S3["AWS S3 Bucket"]:::storage
    end

    %% Relationships
    DBAPI -->|"JDBC/HTTP"| Trino
    Trino -->|"Query Results (CSV)"| LocalFile
    LocalFile -->|"reads CSV"| UploadS3
    UploadS3 -->|"boto3 PutObject"| S3

    ENV -.-> DBAPI
    ENV -.-> UploadS3

    Readme --> DBAPI
    Readme --> UploadS3
    Gitignore --> ENV

    %% Click Events
    click DBAPI "https://github.com/avedian/avedian-dl-examples/blob/master/EDL-Trino/Example-DBAPI.py"
    click reqTrino "https://github.com/avedian/avedian-dl-examples/blob/master/EDL-Trino/requirements.txt"
    click UploadS3 "https://github.com/avedian/avedian-dl-examples/blob/master/EDL-S3/Example-Upload-S3.py"
    click reqS3 "https://github.com/avedian/avedian-dl-examples/blob/master/EDL-S3/requirements.txt"
    click Readme "https://github.com/avedian/avedian-dl-examples/blob/master/README.md"
    click Gitignore "https://github.com/avedian/avedian-dl-examples/blob/master/.gitignore"

    %% Styles
    classDef code fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef service fill:#FFE0B2,stroke:#FB8C00,color:#E65100;
    classDef storage fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32;
    classDef credentials fill:#F5F5F5,stroke:#9E9E9E,color:#616161;
    classDef doc fill:#FFF9C4,stroke:#FBC02D,color:#F57F17;
```
