# acms2345/geradorabntpy architecture

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

- Interactive diagram: https://gitdiagram.com/acms2345/geradorabntpy
- Repository: https://github.com/acms2345/geradorabntpy

## Overview

GeradorABNTPy turns a webpage into ABNT citations for online sources: the example fetches and parses a URL, then calls the library to extract bibliographic details and render inline and reference citations. The core also organizes bibliography data by named folders in memory; the README explicitly says local saving is not implemented. The graph separates extraction, citation data, and formatting responsibilities, though these share one source file. Evidence is limited to the README and shown excerpts; unsampled implementation details are not inferred.

Main entry points: [`geradorabnt/core.py`](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py) (Citation API), [`play.py`](https://github.com/acms2345/geradorabntpy/blob/main/play.py) (Interactive example), [`geradorabnt/ibict-abnt.csl`](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/ibict-abnt.csl) (Ibict ABNT style)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_example["Example workflow"]
  node_play["Interactive example<br/>[play.py]"]
end

subgraph group_core["Citation core"]
  node_core_api["Citation API<br/>[core.py]"]
  node_metadata["Metadata extraction<br/>[core.py]"]
  node_folder_data["Folder bibliography data<br/>[core.py]"]
end

subgraph group_format["Citation formatting"]
  node_csl_engine["CSL rendering<br/>[core.py]"]
  node_csl_style["Ibict ABNT style<br/>[ibict-abnt.csl]"]
end

node_user(("URL user"))
node_web(("Web source"))
node_citeproc["citeproc-py"]

node_user -->|"enters URL"| node_play
node_play -->|"fetches page"| node_web
node_play -->|"requests citations"| node_core_api
node_core_api -->|"extracts details"| node_metadata
node_core_api -->|"groups references"| node_folder_data
node_core_api -->|"formats citations"| node_csl_engine
node_csl_engine -->|"loads style"| node_csl_style
node_csl_engine -->|"uses renderer"| node_citeproc

click node_play "https://github.com/acms2345/geradorabntpy/blob/main/play.py"
click node_core_api "https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py"
click node_metadata "https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py"
click node_folder_data "https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py"
click node_csl_engine "https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py"
click node_csl_style "https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/ibict-abnt.csl"

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_play,node_user toneBlue
class node_core_api,node_metadata,node_folder_data toneAmber
class node_csl_engine,node_csl_style toneMint
class node_web,node_citeproc toneIndigo
```

## Components

### Example workflow

- [Interactive example](https://github.com/acms2345/geradorabntpy/blob/main/play.py): `play.py`

### Citation core

- [Citation API](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py): `geradorabnt/core.py`
- [Metadata extraction](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py): `geradorabnt/core.py`
- [Folder bibliography data](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py): `geradorabnt/core.py`

### Citation formatting

- [CSL rendering](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/core.py): `geradorabnt/core.py`
- [Ibict ABNT style](https://github.com/acms2345/geradorabntpy/blob/main/geradorabnt/ibict-abnt.csl): `geradorabnt/ibict-abnt.csl`

### Other components

- **URL user**
- **Web source**
- **citeproc-py**

## Connections

- URL user → Interactive example: enters URL (evidence: `play.py`)
- Interactive example → Web source: fetches page (evidence: `play.py`)
- Interactive example → Citation API: requests citations (evidence: `play.py`)
- Citation API → Metadata extraction: extracts details (evidence: `geradorabnt/core.py`)
- Citation API → Folder bibliography data: groups references (evidence: `geradorabnt/core.py`)
- Citation API → CSL rendering: formats citations (evidence: `geradorabnt/core.py`)
- CSL rendering → Ibict ABNT style: loads style (evidence: `geradorabnt/core.py`)
- CSL rendering → citeproc-py: uses renderer (evidence: `geradorabnt/core.py`)
