SDML(1)

🌸 SDML(1) — User Commands, but make it cute ✨

okay bestie, welcome to the SDML(1) manual page 💖 it lives in the User Commands section, and today we're talking about one specific little icon: sdml view. grab a strawberry drink 🍓 and let's go.

---

🎀 NAME

sdml view — View formatted module source.

like, it literally just shows you your module source, but formatted and cute. periodt.

---

🌈 SYNOPSIS

sdml view [OPTIONS] [MODULE]

---

💅 DESCRIPTION

View formatted module source. 💖

okay so real talk — this command generates source code from a module file, which at first sounds like… why? why would you do that? generating source from source? 🙈 but NO, bestie, listen: this view gives you levels of detail, and that's what makes it iconic. it's an overview of your module definitions. the --level argument is the main character here — it lets you elide content and get a bird's-eye view of what's going on in a module. no cap.

• Definitions (default) :: Show only the definitions in the module. any definition body gets elided, so you get a clean overview of the module contents. Elided definitions are followed by ";; ...".

sdml view --level definitions -i examples/example.sdm module
example <https://example.com/api> is

import [ dc xsd ]

datatype Uuid <- sdml:string ;; ...

entity Example ;; ...

end

• Members :: Show definitions in the module and show the members of product types and variants of sum types — but not their bodies, if present. it's giving "tell me who's in the group chat but not what they said" 💀

sdml view --level members -i examples/example.sdm module
example <https://example.com/api> is

import [ dc xsd ]

datatype Uuid <- sdml:string ;; ...

entity Example is
  version -> Uuid
  name -> sdml:string
  ;; ...
end

end

• Full :: Show all contents of the module. everything. the whole vibe. 🔥

sdml view --level full -i examples/example.sdm module
example <https://example.com/api> is

import [ dc xsd ]

datatype Uuid <- sdml:string is
  @xsd:pattern = "[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}"
end

entity Example is
  version -> Uuid
  name -> sdml:string is
    @dc:description = "the name of this thing"@en
  end
end

end

Indentation level can also be specified, although the default remains 2 spaces. 🫶

🧚 Arguments:

• [MODULE] — the SDML module, loaded using the standard resolver ✨

---

👑 OPTIONS

• -l, --level <LEVEL> — Possible values:
  • definitions: Top-level definitions, incomplete
  • members: Top-level definitions and members, incomplete
  • full: Full source

[default: definitions]

• -s, --indent-spaces <INDENT_SPACES> — Set the number of spaces for indentation 🌸

[default: 2]

• -o, --output <OUTPUT> — File name to write to, or '-' to write to stdout 💾

[default: -]

• -i, --input <INPUT> — Input SDML file name to read from, or '-' to read from stdin 📥

[default: -]

• -h, --help — Print help (see a summary with '-h') 🆘
• -V, --version — Print version ⭐

---

💀 quick vibe check: --level is doing a LOT of heavy lifting in this manpage, so if your output looks "incomplete"… bestie that's literally the feature, not a bug.

---

and that's the whole page, you ate that 💅 mwah.

this was sdml view version 0.3.2+20250310, dated October 2025, and it belongs to the SDML(1) manual page. go forth and view your modules, queen 👑✨