SVN::W...vision(3pm)

💅 SVN::Web::Revision — the manual, but make it cute

okay bestie, welcome to the User Contributed Perl Documentation section, where the real ones live. This page is about SVN::Web::Revision, and yes the title up top gets truncated all dramatic like SVN::W...vision(3pm) but we all know the whole name. It's an SVN::Web action, it's here to show you a repository revision, and it absolutely ate. 🎀

---

✨ NAME ✨

SVN::Web::Revision — the SVN::Web action that lets you look at a repository revision. that's the whole job. iconic.

---

🌸 SYNOPSIS 🌸

in your config.yaml, you set it up like this:

actions:
  ...
  revision:
    class: SVN::Web::Revision
    opts:
      max_diff_size: 200_000
      show_diff: 1 # or 0
  ...

that's it. that's the config. no cap.

---

🦋 DESCRIPTION 🦋

It shows information about a specific revision in a Subversion repository. that's literally the vibe. you point it at a revision, it spills the tea about that revision. 💖

---

💅 CONFIGURATION 💅

These config options can go in your config.yaml. put them under opts, you know the drill.

• max_diff_size — okay so if you're showing the diff (peep show_diff below 👇), this is the max size of diff that will actually get shown. If the generated diff is bigger than this (measured in bytes), then nope, it's not shown. bye. Defaults to 200,000 bytes.
• show_diff — a boolean, honey. saying whether or not a diff of every single file that got changed in the revision should be shown. Defaults to 1.

---

👑 OPTIONS 👑

• rev — the revision you want to see. If you don't pass one? It just uses the repository's youngest revision. slay, defaults.

---

🌈 TEMPLATE VARIABLES 🌈

these are the variables your template gets to play with. so many. obsessed.

• context — always the string "revision". always. no surprises here.
• rev — the revision that's being shown.
• youngest_rev — the repository's youngest revision. super useful when you're constructing your "next revision" and "previous revision" links. girl math for navigation. 🧚
• date — the date the revision was committed, formatted according to "Time and date formatting" in SVN::Web.
• author — the revision's author. who did this 💀
• msg — the log message associated with this revision. the commit message. the note. the essay, sometimes.
• paths — a hash of hash refs. Each key is a path name. The value is another hash ref, and it has these keys:
  • isdir — a boolean, true if the path is a directory.
  • diff — an SVN::Web::DiffParser object representing the diff. This may be undef — if the generated diff was larger than max_diff_size, or if show_diff is false. so check before you use it bestie.
  • diff_size — the size of the generated diff, before parsing.
  • max_diff_size — the configured maximum diff size.
  • action — a single letter showing what happened to the path. A file was either added A, modified M, replaced R, or deleted D. one letter, four moods.
  • copyfrom — if the file was copied from another file, this is the path of the source of the copy.
  • copyfromrev — if the file was copied from another file, this is the revision of the file that it was copied from.

---

🔥 EXCEPTIONS 🔥

• (revision %1 does not exist) — the given revision does not exist in the repository. it's giving nonexistent. it's giving not found. 🙈

---

💖 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>

---

aaaand that's the page bestie! 🌟 this was perl v5.40.1, dated 2025-04-09, and it came to you straight from the User Contributed Perl Documentation section of SVN::W...vision(3pm). go forth and view your revisions. mwah. 💅✨🫶