# irakoti/joemarini architecture

> Architecture diagram of the GitHub repository irakoti/joemarini, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/irakoti/joemarini
- Repository: https://github.com/irakoti/joemarini

## Overview

This repository is course material, not an application with a shared runtime. Learners work through paired starter and completed Python examples, progressing from language basics to classes and modules, date/time handling, filesystem operations, and web-data formats. The graph groups examples by those instructional domains; its edges show documented course topics, not calls between scripts. The README supports the major capabilities, but the sampled files do not establish a runtime orchestrator or links among lessons.

Main entry points: [`Finished/Ch2`](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2) (Syntax and variables), [`Finished/Ch3`](https://github.com/irakoti/joemarini/tree/main/Finished/Ch3) (Built-in functions), [`Finished/Ch5`](https://github.com/irakoti/joemarini/tree/main/Finished/Ch5) (Calendars), [`Finished/Ch6`](https://github.com/irakoti/joemarini/tree/main/Finished/Ch6) (Paths and OS utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_basics["Python basics"]
  node_syntax["Syntax and variables"]
  node_conditionals["Conditionals and loops"]
  node_functions["Functions"]
  node_collections["Collections"]
  node_bestpractices["Best practices"]
end

subgraph group_structure["Code structure"]
  node_builtins["Built-in functions"]
  node_classes["Classes and objects"]
  node_exceptions["Exceptions"]
  node_modules["Modules"]
end

subgraph group_time["Dates and time"]
  node_calendars["Calendars"]
  node_dates["Dates"]
  node_formatting["Date formatting"]
  node_timedeltas["Time calculations"]
end

subgraph group_files["Filesystem"]
  node_paths["Paths and OS utilities"]
  node_fileinput["Reading files"]
  node_fileoutput["Writing files"]
  node_shell["Shell and archives"]
end

subgraph group_webdata["Web data"]
  node_internet["Internet data"]
  node_json["JSON data"]
  node_xml["XML parsing"]
end

node_learner(("Learner"))

node_learner -->|"learns basics"| node_syntax
node_learner -->|"learns basics"| node_conditionals
node_learner -->|"learns basics"| node_functions
node_learner -->|"learns basics"| node_collections
node_learner -->|"learns basics"| node_bestpractices
node_learner -->|"learns Python"| node_builtins
node_learner -->|"learns Python"| node_classes
node_learner -->|"learns Python"| node_exceptions
node_learner -->|"learns Python"| node_modules
node_learner -->|"learns dates"| node_calendars
node_learner -->|"learns dates"| node_dates
node_learner -->|"learns dates"| node_formatting
node_learner -->|"learns dates"| node_timedeltas
node_learner -->|"learns files"| node_paths
node_learner -->|"learns files"| node_fileinput
node_learner -->|"learns files"| node_fileoutput
node_learner -->|"learns files"| node_shell
node_learner -->|"learns web data"| node_internet
node_learner -->|"learns web data"| node_json
node_learner -->|"learns web data"| node_xml

click node_syntax "https://github.com/irakoti/joemarini/tree/main/Finished/Ch2"
click node_conditionals "https://github.com/irakoti/joemarini/tree/main/Finished/Ch2"
click node_functions "https://github.com/irakoti/joemarini/tree/main/Finished/Ch2"
click node_collections "https://github.com/irakoti/joemarini/tree/main/Finished/Ch2"
click node_bestpractices "https://github.com/irakoti/joemarini/tree/main/Finished/Ch2"
click node_builtins "https://github.com/irakoti/joemarini/tree/main/Finished/Ch3"
click node_classes "https://github.com/irakoti/joemarini/tree/main/Finished/Ch3"
click node_exceptions "https://github.com/irakoti/joemarini/tree/main/Finished/Ch3"
click node_modules "https://github.com/irakoti/joemarini/tree/main/Finished/Ch3"
click node_calendars "https://github.com/irakoti/joemarini/tree/main/Finished/Ch5"
click node_dates "https://github.com/irakoti/joemarini/tree/main/Finished/Ch5"
click node_formatting "https://github.com/irakoti/joemarini/tree/main/Finished/Ch5"
click node_timedeltas "https://github.com/irakoti/joemarini/tree/main/Finished/Ch5"
click node_paths "https://github.com/irakoti/joemarini/tree/main/Finished/Ch6"
click node_fileinput "https://github.com/irakoti/joemarini/tree/main/Finished/Ch6"
click node_fileoutput "https://github.com/irakoti/joemarini/tree/main/Finished/Ch6"
click node_shell "https://github.com/irakoti/joemarini/tree/main/Finished/Ch6"
click node_internet "https://github.com/irakoti/joemarini/tree/main/Finished/Ch7"
click node_json "https://github.com/irakoti/joemarini/tree/main/Finished/Ch7"
click node_xml "https://github.com/irakoti/joemarini/tree/main/Finished/Ch7"

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_syntax,node_conditionals,node_functions,node_collections,node_bestpractices toneBlue
class node_builtins,node_classes,node_exceptions,node_modules toneAmber
class node_calendars,node_dates,node_formatting,node_timedeltas toneMint
class node_paths,node_fileinput,node_fileoutput,node_shell toneRose
class node_internet,node_json,node_xml,node_learner toneIndigo
```

## Components

### Python basics

- [Syntax and variables](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2): `Finished/Ch2`
- [Conditionals and loops](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2): `Finished/Ch2`
- [Functions](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2): `Finished/Ch2`
- [Collections](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2): `Finished/Ch2`
- [Best practices](https://github.com/irakoti/joemarini/tree/main/Finished/Ch2): `Finished/Ch2`

### Code structure

- [Built-in functions](https://github.com/irakoti/joemarini/tree/main/Finished/Ch3): `Finished/Ch3`
- [Classes and objects](https://github.com/irakoti/joemarini/tree/main/Finished/Ch3): `Finished/Ch3`
- [Exceptions](https://github.com/irakoti/joemarini/tree/main/Finished/Ch3): `Finished/Ch3`
- [Modules](https://github.com/irakoti/joemarini/tree/main/Finished/Ch3): `Finished/Ch3`

### Dates and time

- [Calendars](https://github.com/irakoti/joemarini/tree/main/Finished/Ch5): `Finished/Ch5`
- [Dates](https://github.com/irakoti/joemarini/tree/main/Finished/Ch5): `Finished/Ch5`
- [Date formatting](https://github.com/irakoti/joemarini/tree/main/Finished/Ch5): `Finished/Ch5`
- [Time calculations](https://github.com/irakoti/joemarini/tree/main/Finished/Ch5): `Finished/Ch5`

### Filesystem

- [Paths and OS utilities](https://github.com/irakoti/joemarini/tree/main/Finished/Ch6): `Finished/Ch6`
- [Reading files](https://github.com/irakoti/joemarini/tree/main/Finished/Ch6): `Finished/Ch6`
- [Writing files](https://github.com/irakoti/joemarini/tree/main/Finished/Ch6): `Finished/Ch6`
- [Shell and archives](https://github.com/irakoti/joemarini/tree/main/Finished/Ch6): `Finished/Ch6`

### Web data

- [Internet data](https://github.com/irakoti/joemarini/tree/main/Finished/Ch7): `Finished/Ch7`
- [JSON data](https://github.com/irakoti/joemarini/tree/main/Finished/Ch7): `Finished/Ch7`
- [XML parsing](https://github.com/irakoti/joemarini/tree/main/Finished/Ch7): `Finished/Ch7`

### Other components

- **Learner**

## Connections

- Learner → Syntax and variables: learns basics (evidence: `README.md`)
- Learner → Conditionals and loops: learns basics (evidence: `README.md`)
- Learner → Functions: learns basics (evidence: `README.md`)
- Learner → Collections: learns basics (evidence: `README.md`)
- Learner → Best practices: learns basics (evidence: `README.md`)
- Learner → Built-in functions: learns Python (evidence: `README.md`)
- Learner → Classes and objects: learns Python (evidence: `README.md`)
- Learner → Exceptions: learns Python (evidence: `README.md`)
- Learner → Modules: learns Python (evidence: `README.md`)
- Learner → Calendars: learns dates (evidence: `README.md`)
- Learner → Dates: learns dates (evidence: `README.md`)
- Learner → Date formatting: learns dates (evidence: `README.md`)
- Learner → Time calculations: learns dates (evidence: `README.md`)
- Learner → Paths and OS utilities: learns files (evidence: `README.md`)
- Learner → Reading files: learns files (evidence: `README.md`)
- Learner → Writing files: learns files (evidence: `README.md`)
- Learner → Shell and archives: learns files (evidence: `README.md`)
- Learner → Internet data: learns web data (evidence: `README.md`)
- Learner → JSON data: learns web data (evidence: `README.md`)
- Learner → XML parsing: learns web data (evidence: `README.md`)
