KAS-DIFF(1)

📦
version 5.4 · 2 versions
, in ubuntu stonking

✨ KAS-DIFF ✨

okay bestie, welcome to kas-diff — it's the diff plugin for the kas suite (manual page KAS-DIFF(1), hi, that's me 💅), and it's literally just "compare two kas configs and tell you what's different." no cap.

🌸 SYNOPSIS 🌸

kas diff [-h] [--skip STEP] [--force-checkout] [--update]
         [--format {json,text}] [--oneline] [--no-color] [--commit-only]
         [--content-only]
         config1 config2

💖 DESCRIPTION 💖

So the whole vibe here: you hand it two kas configurations and it compares them. that's it, that's the plugin.

This plugin implements the kas diff command. 🫶

It compares two kas configurations and outputs the differences. The diff includes both the content differences in the configuration files and repository differences if commit IDs or tags have changed. it's giving full transparency ✨

Also, plot twist: you can use the --format json option to output the diff in JSON format, which is lowkey the responsible choice, iykyk.

Note: the text output of this plugin should not be considered stable. The text output of the plugin should not considered to be stable. If you need stable output, use a machine readable format like json. fr fr, don't script against the pretty text, bestie, it will betray you 😭

👑 OPTIONS 👑

🎀 Positional Arguments

  • config1 — the first config file to be compared. the OG.
  • config2 — the second config file to be compared. the contender.

🦋 Named Arguments

  • --skip=[] — skip build steps. To skip more than one step, use this argument multiple times (stack 'em like bracelets 💅).

Possible choices: setup_dir, setup_home, make_non_interactive, init_setup_repos, repo_setup_loop, finish_setup_repos, repos_checkout, repos_apply_patches, setup_environ, write_bbconfig

  • --force-checkout=False — always checkout the desired commit/branch/tag of each repository, discarding any local changes. yeah, it will absolutely throw away your local changes. that is the whole point. do not do this casually 😭
  • --update=False — pull new upstream changes to the desired branch even if it is already checked out locally. it goes and fetches the new stuff anyway 🔥
  • --format='text' — diff output format (default: text).

Possible choices: json, text

  • --oneline=False — use git oneline output for differing commits. compact queen ✨
  • --no-color=False — disable colored highlighting of diffs. for the monochrome girlies 🌈➡️🩶
  • --commit-only=False — this will not display the differences in the kas configurations; it will only list commits resulting from different repository revisions. commits only, no config chatter 🎯
  • --content-only=False — this will only display the differences in the kas configurations and will not include repository differences. the exact opposite energy of --commit-only, iconic honestly 💖

🌈 SEE ALSO 🌈

⭐ KAS ⭐

Part of the kas(1) suite. one big happy family 🫶

🍓 AUTHOR 🍓

Daniel Wagner, Jan Kiszka, Claudius Heine — the icons who made this 👑

Siemens and contributors, 2017-2025

and that's the page bestie!! 🧚 kas-diff, version 5.4, dated Jun 25, 2026 — go forth and diff slay 💅✨

📦 where this page comes from