pkgs.ml
Activity Stats For agents Log in with GitHub

krasny

v0.0.43

Document layout and OCaml formatter

Repository Open docs Open in playground
Install
riot add krasny
riot.toml
krasny = "0.0.43"
Last release
May 15, 2026
License
Apache-2.0
Dependencies
2
Dependents
1
Installs
1
Published versions
33
Owner
@leostera@leostera
Examples (1)
format_source
README Expand

krasny

Riot's OCaml formatter.

Most users will interact with krasny through riot fmt, but the package is also usable as a library when you want to parse OCaml source, render it into Riot's canonical layout, or inspect formatter failures programmatically.

Install

riot add krasny

When to use krasny

Use krasny when you want:

  • Riot's canonical formatting rules in-process;
  • a formatter that works from syn's typed CST instead of replaying raw text;
  • explicit failure when the source cannot be lifted cleanly enough to format.

That last point matters: krasny does not try to pretty-print broken files. If parsing or CST construction fails, formatting fails too.

Example

open Std

let source = "let  add  x   y= x+y" in
let parsed = Syn.parse ~filename:(Path.v "sample.ml") source in

match Krasny.format parsed with
| Ok formatted -> println formatted
| Error err -> eprintln (Krasny.format_error_to_string err)

A runnable example is included:

riot run -p krasny format_source

Library surface

The package is intentionally small:

  • Krasny.format formats a parsed file to a string.
  • Krasny.write streams formatted output into a writer.
  • Krasny.syntax_hash computes a normalized syntax hash.
  • Krasny.Runner and Krasny.Report power file-oriented formatting flows.

Related packages

  • syn provides the lossless lexer/parser and typed CST that krasny renders.
  • riot fmt is the normal end-user entry point if you just want to format a project.
Installs
Downloads over the last 30 days, stacked by release.
Total installs
1
Downloads over the last 30 days
v0.0.430
v0.0.420
v0.0.410
v0.0.400
v0.0.390
Package status
Submission, indexing, and post-publish processing milestones for this release.
Submitted
May 15, 08:09 PM
Indexed
May 15, 08:09 PM
Searchable
May 15, 08:09 PM
Docs ready
May 15, 08:23 PM
Completed
Pending
Dependencies
Dependencies declared for this release.
Show 2 dependencies Expand
Dependents
Packages that currently depend on krasny.
Show 1 dependents Expand
Recent activity
Latest publication, indexing, and post-publish pipeline events recorded for this package.
Open full activity
Show 12 recent events Expand
  • Blocked
    krasny 0.0.43 attempt 3 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:42:09 PM
    Event
    Blocked
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 3 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "blocked",
  "attempt_count": 3,
  "error": "error: Unknown argument: krasny"
}
  • Build failed
    krasny 0.0.43 build · exit 1 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:42:08 PM
    Event
    Build failed
    Package
    krasny
    Version
    0.0.43
    Summary
    error: Unknown argument: krasny
    Facts
    build exit 1 artifact 7a08e3515e56
    Artifacts
    Result key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json
    Logs key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "run_kind": "build",
  "result_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json",
  "logs_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 49,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: krasny",
  "stdout_excerpt": "error: Unknown argument: krasny"
}
  • Processing
    krasny 0.0.43 attempt 3 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:42:03 PM
    Event
    Processing
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 3 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "processing",
  "attempt_count": 3
}
  • Requeued
    krasny 0.0.43 attempt 2 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:36:38 PM
    Event
    Requeued
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 2 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "pending",
  "attempt_count": 2,
  "next_attempt_at": "2026-05-15T20:41:38.686Z",
  "error": "error: Unknown argument: krasny"
}
  • Build failed
    krasny 0.0.43 build · exit 1 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:36:37 PM
    Event
    Build failed
    Package
    krasny
    Version
    0.0.43
    Summary
    error: Unknown argument: krasny
    Facts
    build exit 1 artifact 7a08e3515e56
    Artifacts
    Result key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json
    Logs key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "run_kind": "build",
  "result_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json",
  "logs_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 110,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: krasny",
  "stdout_excerpt": "error: Unknown argument: krasny"
}
  • Processing
    krasny 0.0.43 attempt 2 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:36:30 PM
    Event
    Processing
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 2 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "processing",
  "attempt_count": 2
}
  • Requeued
    krasny 0.0.43 attempt 1 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:23:56 PM
    Event
    Requeued
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 1 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "pending",
  "attempt_count": 1,
  "next_attempt_at": "2026-05-15T20:28:56.175Z",
  "error": "error: Unknown argument: krasny"
}
  • Docs ready
    krasny 0.0.43 docs · 2 json · doc.package_generation_completed · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:23:47 PM
    Event
    Docs ready
    Package
    krasny
    Version
    0.0.43
    Facts
    docs 2 json doc.package_generation_completed artifact 7a08e3515e56
    Artifacts
    Result key
    pipelines/docs/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json
    Logs key
    pipelines/docs/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/command.log
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "run_kind": "docs",
  "output_prefix": "docs/krasny/0.0.43/",
  "public_docs_url": "https://docs.pkgs.ml/p/krasny/0.0.43/",
  "result_key": "pipelines/docs/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json",
  "logs_key": "pipelines/docs/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/command.log",
  "json_event_count": 2,
  "non_json_stdout_count": 0,
  "last_json_event_type": "doc.package_generation_completed"
}
  • Build failed
    krasny 0.0.43 build · exit 1 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:23:45 PM
    Event
    Build failed
    Package
    krasny
    Version
    0.0.43
    Summary
    error: Unknown argument: krasny
    Facts
    build exit 1 artifact 7a08e3515e56
    Artifacts
    Result key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json
    Logs key
    pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "run_kind": "build",
  "result_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/result.json",
  "logs_key": "pipelines/builds/krasny/0.0.43/7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 131,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: krasny",
  "stdout_excerpt": "error: Unknown argument: krasny"
}
  • Processing
    krasny 0.0.43 attempt 1 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:23:35 PM
    Event
    Processing
    Package
    krasny
    Version
    0.0.43
    Facts
    attempt 1 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "processing",
  "attempt_count": 1
}
  • Queued
    krasny 0.0.43 artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:09:31 PM
    Event
    Queued
    Package
    krasny
    Version
    0.0.43
    Facts
    artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "status": "pending"
}
  • Indexed
    krasny 0.0.43 latest 0.0.43 · artifact 7a08e3515e56
    Details
    When
    May 15, 2026, 08:09:27 PM
    Event
    Indexed
    Package
    krasny
    Version
    0.0.43
    Facts
    latest 0.0.43 artifact 7a08e3515e56
    Payload
    {
  "artifact_sha256": "7a08e3515e569d84f304b5f571fed5454494fbef8ecd5b9f8c879b8253a26d9e",
  "latest": "0.0.43",
  "package_index_key": "index/v1/kr/as/krasny.json",
  "package_index_url": "https://cdn.pkgs.ml/index/v1/kr/as/krasny.json",
  "changed": true
}