# jbevain/cecil architecture

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

- Interactive diagram: https://gitdiagram.com/jbevain/cecil
- Repository: https://github.com/jbevain/cecil

## Overview

Mono.Cecil is a .NET library for inspecting and modifying ECMA CIL assemblies through an object model, then writing modified binaries. Its main workflow is to read an assembly into modules and metadata objects, inspect or edit types and method bodies, and emit a binary image. The graph also preserves the documented analysis and modification capabilities, plus debug-symbol support visible in the repository tree. Relationships are limited to README statements and SOURCE INDEX references; unsampled implementation details are not inferred.

Main entry points: [`Mono.Cecil/ModuleDefinition.cs`](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/ModuleDefinition.cs) (Module Definition), [`Mono.Cecil/AssemblyReader.cs`](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyReader.cs) (Assembly Reader), [`Mono.Cecil.PE/ImageWriter.cs`](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/ImageWriter.cs) (Image Writer), [`Mono.Cecil/AssemblyWriter.cs`](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyWriter.cs) (Assembly Writer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assembly_io["Assembly I/O"]
  node_assembly_reader["Assembly Reader<br/>[AssemblyReader.cs]"]
  node_assembly_writer["Assembly Writer<br/>[AssemblyWriter.cs]"]
end

subgraph group_model["Assembly Model"]
  node_module["Module Definition"]
  node_types["Type Definitions<br/>[TypeDefinition.cs]"]
  node_type_refs["Type References<br/>[TypeReference.cs]"]
  node_generic_params["Generic Parameters"]
  node_method_defs["Method Definitions"]
  node_il["CIL Instructions<br/>[Code.cs]"]
  node_collections["Collections<br/>[Collection.cs]"]
end

subgraph group_binary["Binary and Metadata"]
  node_pe_image["PE Image<br/>[Image.cs]"]
  node_image_reader["Image Reader<br/>[ImageReader.cs]"]
  node_image_writer["Image Writer<br/>[ImageWriter.cs]"]
  node_metadata_tables[("Metadata Tables<br/>[TableHeap.cs]")]
  node_metadata_tokens["Metadata Tokens<br/>[MetadataToken.cs]"]
end

subgraph group_debug["Debug Symbols"]
  node_symbol_readers["Symbol Readers<br/>[MdbReader.cs]"]
  node_symbol_writers["Symbol Writers<br/>[NativePdbWriter.cs]"]
  node_documents["Debug Documents<br/>[Document.cs]"]
end

node_user(("Library User"))

node_user -->|"requests analysis"| node_assembly_reader
node_assembly_reader -->|"reads image"| node_pe_image
node_assembly_reader -->|"populates model"| node_module
node_module -->|"exposes types"| node_types
node_module -->|"exposes methods"| node_method_defs
node_method_defs -.->|"provides method bodies"| node_il
node_types -->|"supports generics"| node_generic_params
node_generic_params -->|"uses type references"| node_type_refs
node_module -->|"uses collections"| node_collections
node_module -->|"looks up tokens"| node_metadata_tokens
node_pe_image -->|"holds table heap"| node_metadata_tables
node_assembly_writer -->|"serializes model"| node_module
node_assembly_writer -.->|"writes image"| node_image_writer
node_image_writer -->|"writes image data"| node_pe_image
node_image_writer -->|"writes metadata"| node_metadata_tables
node_user -->|"requests modification output"| node_assembly_writer
node_symbol_readers -->|"adds symbol data"| node_module
node_symbol_readers -->|"reads documents"| node_documents
node_symbol_writers -.->|"writes symbols"| node_module

click node_assembly_reader "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyReader.cs"
click node_module "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/ModuleDefinition.cs"
click node_assembly_writer "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyWriter.cs"
click node_types "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/TypeDefinition.cs"
click node_type_refs "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/TypeReference.cs"
click node_generic_params "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/GenericParameter.cs"
click node_method_defs "https://github.com/jbevain/cecil/blob/master/Mono.Cecil/MethodDefinition.cs"
click node_il "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Cil/Code.cs"
click node_pe_image "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/Image.cs"
click node_image_reader "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/ImageReader.cs"
click node_image_writer "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/ImageWriter.cs"
click node_metadata_tables "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Metadata/TableHeap.cs"
click node_metadata_tokens "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Metadata/MetadataToken.cs"
click node_collections "https://github.com/jbevain/cecil/blob/master/Mono.Collections.Generic/Collection.cs"
click node_symbol_readers "https://github.com/jbevain/cecil/blob/master/symbols/mdb/Mono.Cecil.Mdb/MdbReader.cs"
click node_symbol_writers "https://github.com/jbevain/cecil/blob/master/symbols/pdb/Mono.Cecil.Pdb/NativePdbWriter.cs"
click node_documents "https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Cil/Document.cs"

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_assembly_reader,node_assembly_writer,node_user toneBlue
class node_module,node_types,node_type_refs,node_generic_params,node_method_defs,node_il,node_collections toneAmber
class node_pe_image,node_image_reader,node_image_writer,node_metadata_tables,node_metadata_tokens toneMint
class node_symbol_readers,node_symbol_writers,node_documents toneRose
```

## Components

### Assembly I/O

- [Assembly Reader](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyReader.cs): `Mono.Cecil/AssemblyReader.cs`
- [Assembly Writer](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/AssemblyWriter.cs): `Mono.Cecil/AssemblyWriter.cs`

### Assembly Model

- [Module Definition](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/ModuleDefinition.cs): `Mono.Cecil/ModuleDefinition.cs`
- [Type Definitions](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/TypeDefinition.cs): `Mono.Cecil/TypeDefinition.cs`
- [Type References](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/TypeReference.cs): `Mono.Cecil/TypeReference.cs`
- [Generic Parameters](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/GenericParameter.cs): `Mono.Cecil/GenericParameter.cs`
- [Method Definitions](https://github.com/jbevain/cecil/blob/master/Mono.Cecil/MethodDefinition.cs): `Mono.Cecil/MethodDefinition.cs`
- [CIL Instructions](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Cil/Code.cs): `Mono.Cecil.Cil/Code.cs`
- [Collections](https://github.com/jbevain/cecil/blob/master/Mono.Collections.Generic/Collection.cs): `Mono.Collections.Generic/Collection.cs`

### Binary and Metadata

- [PE Image](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/Image.cs): `Mono.Cecil.PE/Image.cs`
- [Image Reader](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/ImageReader.cs): `Mono.Cecil.PE/ImageReader.cs`
- [Image Writer](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.PE/ImageWriter.cs): `Mono.Cecil.PE/ImageWriter.cs`
- [Metadata Tables](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Metadata/TableHeap.cs): `Mono.Cecil.Metadata/TableHeap.cs`
- [Metadata Tokens](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Metadata/MetadataToken.cs): `Mono.Cecil.Metadata/MetadataToken.cs`

### Debug Symbols

- [Symbol Readers](https://github.com/jbevain/cecil/blob/master/symbols/mdb/Mono.Cecil.Mdb/MdbReader.cs): `symbols/mdb/Mono.Cecil.Mdb/MdbReader.cs`
- [Symbol Writers](https://github.com/jbevain/cecil/blob/master/symbols/pdb/Mono.Cecil.Pdb/NativePdbWriter.cs): `symbols/pdb/Mono.Cecil.Pdb/NativePdbWriter.cs`
- [Debug Documents](https://github.com/jbevain/cecil/blob/master/Mono.Cecil.Cil/Document.cs): `Mono.Cecil.Cil/Document.cs`

### Other components

- **Library User**

## Connections

- Library User → Assembly Reader: requests analysis
- Assembly Reader → PE Image: reads image (evidence: `Mono.Cecil/AssemblyReader.cs`)
- Assembly Reader → Module Definition: populates model (evidence: `Mono.Cecil/AssemblyReader.cs`)
- Module Definition → Type Definitions: exposes types (evidence: `Mono.Cecil/ModuleDefinition.cs`)
- Module Definition → Method Definitions: exposes methods (evidence: `Mono.Cecil/ModuleDefinition.cs`)
- Method Definitions → CIL Instructions: provides method bodies
- Type Definitions → Generic Parameters: supports generics (evidence: `Mono.Cecil/GenericParameter.cs`)
- Generic Parameters → Type References: uses type references (evidence: `Mono.Cecil/GenericParameter.cs`)
- Module Definition → Collections: uses collections (evidence: `Mono.Cecil/ModuleDefinition.cs`)
- Module Definition → Metadata Tokens: looks up tokens (evidence: `Mono.Cecil/ModuleDefinition.cs`)
- PE Image → Metadata Tables: holds table heap (evidence: `Mono.Cecil.PE/Image.cs`)
- Assembly Writer → Module Definition: serializes model (evidence: `Mono.Cecil/AssemblyWriter.cs`)
- Assembly Writer → Image Writer: writes image (evidence: `Mono.Cecil/AssemblyWriter.cs`)
- Image Writer → PE Image: writes image data (evidence: `Mono.Cecil.PE/ImageWriter.cs`)
- Image Writer → Metadata Tables: writes metadata (evidence: `Mono.Cecil.PE/ImageWriter.cs`)
- Library User → Assembly Writer: requests modification output
- Symbol Readers → Module Definition: adds symbol data (evidence: `symbols/mdb/Mono.Cecil.Mdb/MdbReader.cs`)
- Symbol Readers → Debug Documents: reads documents (evidence: `symbols/mdb/Mono.Cecil.Mdb/MdbReader.cs`)
- Symbol Writers → Module Definition: writes symbols
