# routekickr/sublime_cobol architecture

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

- Interactive diagram: https://gitdiagram.com/routekickr/sublime_cobol
- Repository: https://github.com/routekickr/sublime_cobol

## Overview

COBOL Language Support is a Sublime Text package for COBOL editing, not an IDE. Its user workflow is to edit COBOL with syntax highlighting, completions and snippets, use commands for common navigation or sequence-number operations, and optionally run a configured syntax-checking build. The README documents these capabilities, but the sampled source only shows the text-editing commands; the grammar, completion, snippet and build configurations were not sampled. Edges therefore show documented user-facing capabilities, not unverified internal calls.

Main entry points: [`COBOL_commands.py`](https://github.com/routekickr/sublime_cobol/blob/master/COBOL_commands.py) (Editing commands), [`OpenCOBOL.sublime-build`](https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.sublime-build) (Syntax-check builds), [`COBOL.tmLanguage`](https://github.com/routekickr/sublime_cobol/blob/master/COBOL.tmLanguage) (COBOL syntax), [`OpenCOBOL.tmLanguage`](https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.tmLanguage) (OpenCOBOL syntax)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["Language Editing"]
  node_cobol_syntax["COBOL syntax<br/>[COBOL.tmLanguage]"]
  node_open_syntax["OpenCOBOL syntax"]
  node_acu_syntax["ACUCOBOL syntax"]
  node_completion["Keyword completion"]
end

subgraph group_commands["Editing Commands"]
  node_commands_py["Editing commands<br/>[COBOL_commands.py]"]
  node_command_palette["Command palette"]
  node_keymaps["Syntax shortcuts"]
end

subgraph group_authoring["Authoring and Checking"]
  node_snippets["COBOL snippets"]
  node_builds["Syntax-check builds"]
end

node_user(("COBOL editor"))
node_sublime["Sublime Text"]
node_compiler["COBOL compiler"]

node_user -->|"edits in"| node_sublime
node_sublime -->|"highlights"| node_cobol_syntax
node_sublime -->|"highlights"| node_open_syntax
node_sublime -->|"highlights"| node_acu_syntax
node_sublime -->|"offers completion"| node_completion
node_user -->|"runs commands"| node_commands_py
node_commands_py -->|"edits document"| node_sublime
node_sublime -->|"exposes commands"| node_command_palette
node_sublime -->|"binds shortcuts"| node_keymaps
node_sublime -->|"inserts templates"| node_snippets
node_user -->|"runs syntax check"| node_builds
node_builds -.->|"invokes"| node_compiler

click node_cobol_syntax "https://github.com/routekickr/sublime_cobol/blob/master/COBOL.tmLanguage"
click node_open_syntax "https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.tmLanguage"
click node_acu_syntax "https://github.com/routekickr/sublime_cobol/blob/master/ACUCOBOL.tmLanguage"
click node_completion "https://github.com/routekickr/sublime_cobol/blob/master/COBOL.sublime-completions"
click node_commands_py "https://github.com/routekickr/sublime_cobol/blob/master/COBOL_commands.py"
click node_command_palette "https://github.com/routekickr/sublime_cobol/blob/master/COBOL.sublime-commands"
click node_keymaps "https://github.com/routekickr/sublime_cobol/blob/master/Default%20(Windows).sublime-keymap"
click node_snippets "https://github.com/routekickr/sublime_cobol/tree/master/Code"
click node_builds "https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.sublime-build"

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_cobol_syntax,node_open_syntax,node_acu_syntax,node_completion toneBlue
class node_commands_py,node_command_palette,node_keymaps toneAmber
class node_snippets,node_builds toneMint
class node_user,node_sublime,node_compiler toneIndigo
```

## Components

### Language Editing

- [COBOL syntax](https://github.com/routekickr/sublime_cobol/blob/master/COBOL.tmLanguage): `COBOL.tmLanguage`
- [OpenCOBOL syntax](https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.tmLanguage): `OpenCOBOL.tmLanguage`
- [ACUCOBOL syntax](https://github.com/routekickr/sublime_cobol/blob/master/ACUCOBOL.tmLanguage): `ACUCOBOL.tmLanguage`
- [Keyword completion](https://github.com/routekickr/sublime_cobol/blob/master/COBOL.sublime-completions): `COBOL.sublime-completions`

### Editing Commands

- [Editing commands](https://github.com/routekickr/sublime_cobol/blob/master/COBOL_commands.py): `COBOL_commands.py`
- [Command palette](https://github.com/routekickr/sublime_cobol/blob/master/COBOL.sublime-commands): `COBOL.sublime-commands`
- [Syntax shortcuts](https://github.com/routekickr/sublime_cobol/blob/master/Default%20(Windows).sublime-keymap): `Default (Windows).sublime-keymap`

### Authoring and Checking

- [COBOL snippets](https://github.com/routekickr/sublime_cobol/tree/master/Code): `Code`
- [Syntax-check builds](https://github.com/routekickr/sublime_cobol/blob/master/OpenCOBOL.sublime-build): `OpenCOBOL.sublime-build`

### Other components

- **COBOL editor**
- **Sublime Text**
- **COBOL compiler**

## Connections

- COBOL editor → Sublime Text: edits in (evidence: `README.md`)
- Sublime Text → COBOL syntax: highlights (evidence: `README.md`)
- Sublime Text → OpenCOBOL syntax: highlights (evidence: `README.md`)
- Sublime Text → ACUCOBOL syntax: highlights (evidence: `README.md`)
- Sublime Text → Keyword completion: offers completion (evidence: `README.md`)
- COBOL editor → Editing commands: runs commands (evidence: `README.md`)
- Editing commands → Sublime Text: edits document (evidence: `COBOL_commands.py`)
- Sublime Text → Command palette: exposes commands (evidence: `README.md`)
- Sublime Text → Syntax shortcuts: binds shortcuts (evidence: `README.md`)
- Sublime Text → COBOL snippets: inserts templates (evidence: `README.md`)
- COBOL editor → Syntax-check builds: runs syntax check (evidence: `README.md`)
- Syntax-check builds → COBOL compiler: invokes
