# edeustua/peru-dnie architecture

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

- Interactive diagram: https://gitdiagram.com/edeustua/peru-dnie
- Repository: https://github.com/edeustua/peru-dnie

## Overview

Peru DNIe is a Linux command-line tool for extracting DNIe v2 certificates and signing files with the card. The main workflow parses a command, initializes a smart-card connection, then dispatches to certificate extraction or signing; results are written to files. The graph also shows the APDU/card transport layer and supporting hash, configuration, and localization modules. Evidence is limited to the README and indexed source excerpts; unsampled subsystem internals are not inferred.

Main entry points: [`src/peru_dnie/pyscard.py`](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/pyscard.py) (PC/SC Adapter), [`src/peru_dnie/context.py`](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/context.py) (Operation Context), [`src/peru_dnie/cli.py`](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/cli.py) (Command CLI), [`src/peru_dnie/commands/signature.py`](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/signature.py) (File Signing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI"]
  node_cli["Command CLI<br/>[cli.py]"]
  node_init["Card Initialization<br/>[card_init.py]"]
end

subgraph group_operations["Card Operations"]
  node_certificate["Certificate Extraction<br/>[certificate.py]"]
  node_signature["File Signing<br/>[signature.py]"]
  node_general["PIN Verification<br/>[general.py]"]
end

subgraph group_transport["Card Transport"]
  node_apdu["APDU Encoding<br/>[apdu.py]"]
  node_card["Smart Card Interface<br/>[card.py]"]
  node_pyscard["PC/SC Adapter<br/>[pyscard.py]"]
end

subgraph group_support["Shared Support"]
  node_context["Operation Context<br/>[context.py]"]
  node_hashes["Hash Functions<br/>[hashes.py]"]
  node_constants["Card and Hash Constants<br/>[constants.py]"]
  node_i18n["Localization<br/>[i18n.py]"]
  node_config["CLI Configuration<br/>[cli_config.py]"]
  node_exceptions["Card Errors<br/>[exceptions.py]"]
end

node_user(("User"))
node_files["Input and Output Files"]
node_reader(("Smart Card Reader and DNIe"))

node_user -->|"runs command"| node_cli
node_cli -->|"initializes card"| node_init
node_cli -->|"dispatches signing"| node_signature
node_cli -->|"dispatches extraction"| node_certificate
node_cli -->|"selects hash"| node_hashes
node_init -->|"gets connection"| node_pyscard
node_pyscard -->|"connects to card"| node_reader
node_pyscard -->|"implements interface"| node_card
node_pyscard -->|"serializes commands"| node_apdu
node_init -->|"sets card"| node_context
node_signature -->|"transmits commands"| node_context
node_certificate -->|"transmits commands"| node_context
node_general -->|"transmits PIN"| node_context
node_context -->|"forwards commands"| node_card
node_signature -->|"hashes input"| node_hashes
node_signature -->|"verifies PIN"| node_general
node_certificate -->|"selects PKI app"| node_general
node_signature -->|"reads and writes"| node_files
node_certificate -->|"writes certificate"| node_files
node_hashes -->|"uses DER encodings"| node_constants
node_context -->|"uses CLI settings"| node_config
node_apdu -->|"uses error messages"| node_i18n
node_pyscard -->|"matches card ATR"| node_constants
node_pyscard -->|"raises card error"| node_exceptions

click node_cli "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/cli.py"
click node_init "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/card_init.py"
click node_certificate "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/certificate.py"
click node_signature "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/signature.py"
click node_general "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/general.py"
click node_context "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/context.py"
click node_hashes "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/hashes.py"
click node_constants "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/constants.py"
click node_i18n "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/i18n.py"
click node_config "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/cli_config.py"
click node_exceptions "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/exceptions.py"
click node_apdu "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/apdu.py"
click node_card "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/card.py"
click node_pyscard "https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/pyscard.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_init,node_user toneBlue
class node_certificate,node_signature,node_general toneAmber
class node_apdu,node_card,node_pyscard toneMint
class node_context,node_hashes,node_constants,node_i18n,node_config,node_exceptions toneRose
class node_files,node_reader toneIndigo
```

## Components

### CLI

- [Command CLI](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/cli.py): `src/peru_dnie/cli.py`
- [Card Initialization](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/card_init.py): `src/peru_dnie/card_init.py`

### Card Operations

- [Certificate Extraction](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/certificate.py): `src/peru_dnie/commands/certificate.py`
- [File Signing](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/signature.py): `src/peru_dnie/commands/signature.py`
- [PIN Verification](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/commands/general.py): `src/peru_dnie/commands/general.py`

### Card Transport

- [APDU Encoding](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/apdu.py): `src/peru_dnie/apdu.py`
- [Smart Card Interface](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/card.py): `src/peru_dnie/card.py`
- [PC/SC Adapter](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/pyscard.py): `src/peru_dnie/pyscard.py`

### Shared Support

- [Operation Context](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/context.py): `src/peru_dnie/context.py`
- [Hash Functions](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/hashes.py): `src/peru_dnie/hashes.py`
- [Card and Hash Constants](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/constants.py): `src/peru_dnie/constants.py`
- [Localization](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/i18n.py): `src/peru_dnie/i18n.py`
- [CLI Configuration](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/cli_config.py): `src/peru_dnie/cli_config.py`
- [Card Errors](https://github.com/edeustua/peru-dnie/blob/main/src/peru_dnie/exceptions.py): `src/peru_dnie/exceptions.py`

### Other components

- **User**
- **Input and Output Files**
- **Smart Card Reader and DNIe**

## Connections

- User → Command CLI: runs command (evidence: `README.md`)
- Command CLI → Card Initialization: initializes card (evidence: `src/peru_dnie/cli.py`)
- Command CLI → File Signing: dispatches signing (evidence: `src/peru_dnie/cli.py`)
- Command CLI → Certificate Extraction: dispatches extraction (evidence: `src/peru_dnie/cli.py`)
- Command CLI → Hash Functions: selects hash (evidence: `src/peru_dnie/cli.py`)
- Card Initialization → PC/SC Adapter: gets connection (evidence: `src/peru_dnie/card_init.py`)
- PC/SC Adapter → Smart Card Reader and DNIe: connects to card (evidence: `src/peru_dnie/pyscard.py`)
- PC/SC Adapter → Smart Card Interface: implements interface (evidence: `src/peru_dnie/pyscard.py`)
- PC/SC Adapter → APDU Encoding: serializes commands (evidence: `src/peru_dnie/pyscard.py`)
- Card Initialization → Operation Context: sets card (evidence: `src/peru_dnie/card_init.py`)
- File Signing → Operation Context: transmits commands (evidence: `src/peru_dnie/commands/signature.py`)
- Certificate Extraction → Operation Context: transmits commands (evidence: `src/peru_dnie/commands/certificate.py`)
- PIN Verification → Operation Context: transmits PIN (evidence: `src/peru_dnie/commands/general.py`)
- Operation Context → Smart Card Interface: forwards commands (evidence: `src/peru_dnie/context.py`)
- File Signing → Hash Functions: hashes input (evidence: `src/peru_dnie/commands/signature.py`)
- File Signing → PIN Verification: verifies PIN (evidence: `src/peru_dnie/commands/signature.py`)
- Certificate Extraction → PIN Verification: selects PKI app (evidence: `src/peru_dnie/commands/certificate.py`)
- File Signing → Input and Output Files: reads and writes (evidence: `src/peru_dnie/commands/signature.py`)
- Certificate Extraction → Input and Output Files: writes certificate (evidence: `src/peru_dnie/commands/certificate.py`)
- Hash Functions → Card and Hash Constants: uses DER encodings (evidence: `src/peru_dnie/hashes.py`)
- Operation Context → CLI Configuration: uses CLI settings (evidence: `src/peru_dnie/context.py`)
- APDU Encoding → Localization: uses error messages (evidence: `src/peru_dnie/apdu.py`)
- PC/SC Adapter → Card and Hash Constants: matches card ATR (evidence: `src/peru_dnie/pyscard.py`)
- PC/SC Adapter → Card Errors: raises card error (evidence: `src/peru_dnie/pyscard.py`)
