poka.sh

 Docs

PUML

Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.

PlantUML Preview.

At a glance
Purpose A PlantUML source: a text description of UML and other diagrams between @startuml and @enduml.
Extensions .puml
Poka parser poka-plantuml
Viewer poka-metadata-card-viewer
Depth tier Metadata card (see Depth tiers)
Breadth tier B4 Summary (see Breadth tiers)

How much Poka reads

B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.

Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-plantuml/src/main.rs (258 lines) and plugin.json in full. The crate has no unit tests and no tests/samples.rs, and the corpus has no .puml, .plantuml and .iuml sample, so the tier rests on reading the code. Covers .puml, .plantuml and .iuml. The output is a metadata card of counts found by matching text line by line: start and end tags, the diagram kind, participant and entity kinds, arrows, group blocks, notes, titles and captions, header, footer and legend, skinparam, !theme, preprocessor directives and activate and deactivate. Judgement: B4, because the structure is summarised but the source itself is never shown.

What Poka does not read

  • The source text is not shown: the card carries only counts and a few sample names, with no code view or highlighting
  • Constructs are found by matching text line by line, not by parsing, so multi-line declarations, nested or indented definitions and keywords inside strings or comments can be miscounted
  • Files over 32 MiB are cut to the first 32 MiB (the card says so)
  • Text that is not UTF-8 is decoded with replacement characters; no other encoding is tried
  • The diagram is not drawn
  • !include files are not followed

Libraries

Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.

  • plantuml-parser (candidate; Apache-2.0; JavaScript/TypeScript; https://github.com/Enteee/plantuml-parser) — PEG grammar; class, component, use case, sequence, activity, state, etc.; author states it is not feature-complete
  • puml (candidate; MIT; Rust; https://github.com/alliecatowo/puml) — Fast, no-Java PlantUML-compatible diagram rendering as a Rust CLI and library.; v0.2.6, updated 2026-10-04; matched on lib.rs, not tested

Sources

  • parsers/poka-plantuml/src/main.rs
  • parsers/poka-plantuml/plugin.json