# 3breadt/dd-plist architecture

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

- Interactive diagram: https://gitdiagram.com/3breadt/dd-plist
- Repository: https://github.com/3breadt/dd-plist

## Overview

dd-plist is a Java library for reading, writing, and converting Cocoa XML, Cocoa binary, and ASCII property lists. The main workflow routes input through PropertyListParser to a format-specific parser, producing an NSObject tree that applications can inspect or convert to Java objects. Writing wraps Java values or uses that object tree, then emits a selected format; PropertyListConverter provides format conversion. The graph reflects documented features and SOURCE INDEX references; some implementation details are unsampled, so uncertain relationships are omitted.

Main entry points: [`src/main/java/com/dd/plist/NSObject.java`](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSObject.java) (NSObject base), [`src/main/java/com/dd/plist/PropertyListParser.java`](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListParser.java) (Parser API), [`src/main/java/com/dd/plist/BinaryPropertyListParser.java`](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/BinaryPropertyListParser.java) (Binary parser), [`src/main/java/com/dd/plist/PropertyListConverter.java`](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListConverter.java) (Format converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Library API"]
  node_parser["Parser API"]
  node_diagnostics["Parse diagnostics"]
  node_bom["BOM handling"]
  node_format_error["Format errors"]
end

subgraph group_formats["Format Processing"]
  node_ascii_parse["ASCII parser"]
  node_binary_parse["Binary parser"]
  node_xml_parse["XML parser"]
  node_ascii_write["ASCII writer"]
  node_binary_write["Binary writer"]
  node_xml_write["XML writer"]
end

subgraph group_model["Property List Model"]
  node_object["NSObject base<br/>[NSObject.java]"]
  node_dictionary["Dictionary<br/>[NSDictionary.java]"]
  node_array["Array<br/>[NSArray.java]"]
  node_scalar["Scalar values<br/>[NSString.java]"]
  node_number["Numeric values<br/>[NSNumber.java]"]
  node_date["Date values<br/>[NSDate.java]"]
  node_data["Data values<br/>[NSData.java]"]
  node_set["Set values<br/>[NSSet.java]"]
  node_null["Null values<br/>[NSNull.java]"]
  node_uid["UID values<br/>[UID.java]"]
end

subgraph group_conversion["Conversion"]
  node_converter["Format converter"]
end

node_app(("Java application"))

node_app -->|"parses input"| node_parser
node_app -->|"builds values"| node_object
node_parser -->|"dispatches to"| node_ascii_parse
node_parser -->|"dispatches to"| node_binary_parse
node_parser -->|"dispatches to"| node_xml_parse
node_ascii_parse -->|"creates values"| node_object
node_binary_parse -->|"creates values"| node_object
node_xml_parse -->|"creates values"| node_object
node_parser -->|"checks encoding"| node_bom
node_ascii_parse -->|"tracks locations"| node_diagnostics
node_binary_parse -->|"tracks locations"| node_diagnostics
node_parser -->|"reports invalid format"| node_format_error
node_app -->|"converts formats"| node_converter
node_converter -->|"parses source"| node_parser
node_converter -->|"emits ASCII"| node_ascii_write
node_converter -->|"emits binary"| node_binary_write
node_converter -->|"emits XML"| node_xml_write
node_app -->|"writes ASCII"| node_ascii_write
node_app -->|"writes binary"| node_binary_write
node_object -->|"renders XML"| node_xml_write
node_object -->|"serializes binary"| node_binary_write
node_object -->|"wraps mappings"| node_dictionary
node_object -->|"wraps arrays"| node_array
node_object -->|"wraps strings"| node_scalar
node_object -->|"wraps numbers"| node_number
node_object -->|"wraps dates"| node_date
node_object -->|"wraps data"| node_data
node_object -->|"wraps sets"| node_set
node_object -->|"handles nulls"| node_null
node_binary_parse -->|"parses sets"| node_set
node_binary_parse -->|"parses UIDs"| node_uid
node_app -->|"converts to Java"| node_object

click node_parser "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListParser.java"
click node_converter "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListConverter.java"
click node_ascii_parse "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ASCIIPropertyListParser.java"
click node_binary_parse "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/BinaryPropertyListParser.java"
click node_xml_parse "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/XMLPropertyListParser.java"
click node_ascii_write "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ASCIIPropertyListWriter.java"
click node_binary_write "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/BinaryPropertyListWriter.java"
click node_xml_write "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/XMLPropertyListWriter.java"
click node_object "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSObject.java"
click node_dictionary "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSDictionary.java"
click node_array "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSArray.java"
click node_scalar "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSString.java"
click node_number "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSNumber.java"
click node_date "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSDate.java"
click node_data "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSData.java"
click node_set "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSSet.java"
click node_null "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSNull.java"
click node_uid "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/UID.java"
click node_diagnostics "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/LocationInformation.java"
click node_bom "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ByteOrderMarkReader.java"
click node_format_error "https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListFormatException.java"

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_parser,node_diagnostics,node_bom,node_format_error toneBlue
class node_ascii_parse,node_binary_parse,node_xml_parse,node_ascii_write,node_binary_write,node_xml_write toneAmber
class node_object,node_dictionary,node_array,node_scalar,node_number,node_date,node_data,node_set,node_null,node_uid toneMint
class node_converter toneRose
class node_app toneIndigo
```

## Components

### Library API

- [Parser API](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListParser.java): `src/main/java/com/dd/plist/PropertyListParser.java`
- [Parse diagnostics](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/LocationInformation.java): `src/main/java/com/dd/plist/LocationInformation.java`
- [BOM handling](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ByteOrderMarkReader.java): `src/main/java/com/dd/plist/ByteOrderMarkReader.java`
- [Format errors](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListFormatException.java): `src/main/java/com/dd/plist/PropertyListFormatException.java`

### Format Processing

- [ASCII parser](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ASCIIPropertyListParser.java): `src/main/java/com/dd/plist/ASCIIPropertyListParser.java`
- [Binary parser](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/BinaryPropertyListParser.java): `src/main/java/com/dd/plist/BinaryPropertyListParser.java`
- [XML parser](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/XMLPropertyListParser.java): `src/main/java/com/dd/plist/XMLPropertyListParser.java`
- [ASCII writer](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/ASCIIPropertyListWriter.java): `src/main/java/com/dd/plist/ASCIIPropertyListWriter.java`
- [Binary writer](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/BinaryPropertyListWriter.java): `src/main/java/com/dd/plist/BinaryPropertyListWriter.java`
- [XML writer](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/XMLPropertyListWriter.java): `src/main/java/com/dd/plist/XMLPropertyListWriter.java`

### Property List Model

- [NSObject base](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSObject.java): `src/main/java/com/dd/plist/NSObject.java`
- [Dictionary](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSDictionary.java): `src/main/java/com/dd/plist/NSDictionary.java`
- [Array](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSArray.java): `src/main/java/com/dd/plist/NSArray.java`
- [Scalar values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSString.java): `src/main/java/com/dd/plist/NSString.java`
- [Numeric values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSNumber.java): `src/main/java/com/dd/plist/NSNumber.java`
- [Date values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSDate.java): `src/main/java/com/dd/plist/NSDate.java`
- [Data values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSData.java): `src/main/java/com/dd/plist/NSData.java`
- [Set values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSSet.java): `src/main/java/com/dd/plist/NSSet.java`
- [Null values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/NSNull.java): `src/main/java/com/dd/plist/NSNull.java`
- [UID values](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/UID.java): `src/main/java/com/dd/plist/UID.java`

### Conversion

- [Format converter](https://github.com/3breadt/dd-plist/blob/master/src/main/java/com/dd/plist/PropertyListConverter.java): `src/main/java/com/dd/plist/PropertyListConverter.java`

### Other components

- **Java application**

## Connections

- Java application → Parser API: parses input (evidence: `README.md`)
- Java application → NSObject base: builds values (evidence: `README.md`)
- Parser API → ASCII parser: dispatches to (evidence: `src/main/java/com/dd/plist/PropertyListParser.java`)
- Parser API → Binary parser: dispatches to (evidence: `src/main/java/com/dd/plist/PropertyListParser.java`)
- Parser API → XML parser: dispatches to (evidence: `src/main/java/com/dd/plist/PropertyListParser.java`)
- ASCII parser → NSObject base: creates values (evidence: `src/main/java/com/dd/plist/ASCIIPropertyListParser.java`)
- Binary parser → NSObject base: creates values (evidence: `src/main/java/com/dd/plist/BinaryPropertyListParser.java`)
- XML parser → NSObject base: creates values (evidence: `src/main/java/com/dd/plist/XMLPropertyListParser.java`)
- Parser API → BOM handling: checks encoding (evidence: `src/main/java/com/dd/plist/PropertyListParser.java`)
- ASCII parser → Parse diagnostics: tracks locations (evidence: `src/main/java/com/dd/plist/ASCIIPropertyListParser.java`)
- Binary parser → Parse diagnostics: tracks locations (evidence: `src/main/java/com/dd/plist/BinaryPropertyListParser.java`)
- Parser API → Format errors: reports invalid format (evidence: `src/main/java/com/dd/plist/PropertyListParser.java`)
- Java application → Format converter: converts formats (evidence: `README.md`)
- Format converter → Parser API: parses source (evidence: `src/main/java/com/dd/plist/PropertyListConverter.java`)
- Format converter → ASCII writer: emits ASCII (evidence: `src/main/java/com/dd/plist/PropertyListConverter.java`)
- Format converter → Binary writer: emits binary (evidence: `src/main/java/com/dd/plist/PropertyListConverter.java`)
- Format converter → XML writer: emits XML (evidence: `src/main/java/com/dd/plist/PropertyListConverter.java`)
- Java application → ASCII writer: writes ASCII (evidence: `README.md`)
- Java application → Binary writer: writes binary (evidence: `README.md`)
- NSObject base → XML writer: renders XML (evidence: `README.md`)
- NSObject base → Binary writer: serializes binary (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Dictionary: wraps mappings (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Array: wraps arrays (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Scalar values: wraps strings (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Numeric values: wraps numbers (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Date values: wraps dates (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Data values: wraps data (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Set values: wraps sets (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- NSObject base → Null values: handles nulls (evidence: `src/main/java/com/dd/plist/NSObject.java`)
- Binary parser → Set values: parses sets (evidence: `src/main/java/com/dd/plist/BinaryPropertyListParser.java`)
- Binary parser → UID values: parses UIDs (evidence: `src/main/java/com/dd/plist/BinaryPropertyListParser.java`)
- Java application → NSObject base: converts to Java (evidence: `README.md`)
