# shpota/github-activity-generator architecture

> Architecture diagram of the GitHub repository shpota/github-activity-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shpota/github-activity-generator
- Repository: https://github.com/shpota/github-activity-generator

## Overview

This small Python script generates dated Git commits in a new local repository and optionally pushes them to a remote. The README documents controls for commit frequency, daily count, weekends, date range, and Git identity; these are options within the single runtime script, not separate subsystems. The graph follows the documented CLI-to-generation workflow. External Git behavior is represented at the subprocess boundary; no other source files implement runtime product behavior.

Main entry points: [`contribute.py`](https://github.com/shpota/github-activity-generator/blob/main/contribute.py) (CLI arguments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generator["Commit generator"]
  node_cli["CLI arguments<br/>[contribute.py]"]
  node_schedule["Date scheduler<br/>[contribute.py]"]
  node_commit["Commit creation<br/>[contribute.py]"]
end

node_user(("User"))
node_git["Git"]
node_remote[("Remote repository")]

node_user -->|"runs script"| node_cli
node_cli -->|"configures dates"| node_schedule
node_schedule -->|"selects commit times"| node_commit
node_commit -->|"runs Git commands"| node_git
node_cli -->|"initializes repository"| node_git
node_git -->|"pushes commits"| node_remote

click node_cli "https://github.com/shpota/github-activity-generator/blob/main/contribute.py"
click node_schedule "https://github.com/shpota/github-activity-generator/blob/main/contribute.py"
click node_commit "https://github.com/shpota/github-activity-generator/blob/main/contribute.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_schedule,node_commit,node_user toneBlue
class node_git toneIndigo
class node_remote toneAmber
```

## Components

### Commit generator

- [CLI arguments](https://github.com/shpota/github-activity-generator/blob/main/contribute.py): `contribute.py`
- [Date scheduler](https://github.com/shpota/github-activity-generator/blob/main/contribute.py): `contribute.py`
- [Commit creation](https://github.com/shpota/github-activity-generator/blob/main/contribute.py): `contribute.py`

### Other components

- **User**
- **Git**
- **Remote repository**

## Connections

- User → CLI arguments: runs script (evidence: `contribute.py`)
- CLI arguments → Date scheduler: configures dates (evidence: `contribute.py`)
- Date scheduler → Commit creation: selects commit times (evidence: `contribute.py`)
- Commit creation → Git: runs Git commands (evidence: `contribute.py`)
- CLI arguments → Git: initializes repository (evidence: `contribute.py`)
- Git → Remote repository: pushes commits
