SVN::Web::Diff(3pm)

💅 NAME 💅

SVN::Web::Diff — the SVN::Web action that shows you the difference between two revisions of a file, bestie. It's giving "spot the difference" but make it version control ✨

---

🌸 SYNOPSIS 🌸

In config.yaml:

actions:
  ...
  diff:
    class: SVN::Web::Diff
  ...

okay so you drop that in your config and boom, you've got a diff action 🎀

---

🦋 DESCRIPTION 🦋

It returns the difference between two revisions of the same file. That's it. That's the whole vibe. One file, two revs, and the receipts in between 💖

---

✨ CONFIGURATION ✨

The following configuration options may be specified in config.yaml. Yes, you actually write these yourself, so pay attention 👑

• max_diff_size — if you're showing the diff (peep "show_diff"), this is the maximum size of the diff that will actually get shown. If the generated diff (measured in bytes) is bigger than this number, it just… doesn't show up. Sorry bestie, no diff for you 🙈

Defaults to 200,000 bytes.

---

🔥 OPTIONS 🔥

• rev1 — the first revision of the file you want to compare.
• rev2 — the second revision of the file you want to compare.
• revs — a list of two or more revisions. If you pass this, the smallest number in the list gets assigned to rev1 (and yes, it overrides any rev1 value you gave) and the largest number in the list gets assigned to rev2 (which also overrides any rev2 you gave). The override is real, no cap.

In other words:

...?rev1=5;rev2=10

is equal to:

...?revs=10;revs=5

This is what supports the "diff between arbitrary revisions" functionality. Iconic behaviour honestly 💅

• mime — the desired output format. Default is html, which gives you a diff marked up in HTML. The other allowed value is text, for a plain text unified diff. Pick your fighter ⭐

---

🎀 TEMPLATE VARIABLES 🎀

• at_head — Boolean, indicating whether or not we're currently diffing against the youngest revision of this file.
• context — always file. Every single time. Consistency queen 🌈
• rev1 — the first revision of the file to compare. Corresponds with the rev1 parameter, either set explicitly, or extracted from revs.
• rev2 — the second revision of the file to compare. Corresponds with the rev2 parameter, either set explicitly, or extracted from revs.
• diff — an SVN::Web::DiffParser object that contains the text of the diff. Call the object's methods to format the diff. She's got methods, use them 💜
• diff_size — the size of the generated diff (before parsing).
• max_diff_size — the configured maximum diff size.

---

💀 EXCEPTIONS 💀

• (cannot diff nodes of different types: %1 %2 %3) — the given path has different node types at the different revisions. This probably means a file was added, deleted, and then re-added as a directory at a later date (or vice-versa). Chaotic behaviour fr fr 😭
• (path %1 is a directory at rev %2) — the user has tried to diff two directories. This is not currently supported. Not me trying to diff directories 💀
• (path %1 does not exist in revision %2) — the given path is not present in the repository at the given revision. She's not there. Never was 🫶
• (two revisions must be provided) — no revisions were given to diff against. You literally gave me nothing to work with 🙈
• (rev1 and rev2 must be different) — either only one revision number was given, or several were given, but they're the same number. Comparing a thing to itself is not a diff, bestie 💅

---

👑 COPYRIGHT 👑

Copyright 2003-2004 by Chia-liang Kao "<clkao@clkao.org>".

Copyright 2005-2007 by Nik Clayton "<nik@FreeBSD.org>".

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See <http://www.perl.com/perl/misc/Artistic.html>

---

okay that's the whole page, you ate that 🍓 this was SVN::Web::Diff from perl v5.40.1, dated 2025-04-09 — go forth and diff responsibly, mwah 💖✨