Sum(3pm)

📦 version 2.1.1, in arch rolling

👑 Sum(3pm) — the Lire::Sum glow-up ✨

okay so bestie, welcome to Lire::Sum, a Perl module from LogReport's Lire documentation, and it is literally the class that implements the sum operator 💅 no cap.

use Lire::Sum

🦋 DESCRIPTION 🦋

so what does this bad boy actually do? Lire::Sum is the class that implements the sum operator, and that operator computes the field's sum across a group of DLF records 🌸. that's the whole vibe.

and it gets better — you can compute a weighted sum, where each value gets multiplied by the value of another DLF field first 🎀. it's giving ✨math but make it fashion✨.

also (and this is highkey the cute part), it's possible to express the count as a ratio of the total count for the group or table 🫶.

💖 METHODS 💖

🌟 new( %params )

creates a new Lire::Count object 😭 yes, that's what the docs say, and we're not changing a single character of it. on top of the values supported by its parents, the weight and ratio attributes get initialized to whatever you passed in the %params argument. periodt.

🌟 weight( [$new_weight] )

returns the DLF field's name that your values get multiplied by before being summed 💫.

and you can totally change the weight field — just pass a new name as the $new_weight parameter. wanna remove the weighting field entirely? pass undef and it's gone, iconic 🧚.

🌟 ratio([$new_ratio])

returns how the sum will be expressed. it can be one of three possible values, bestie:

  • none — the default 💜 the absolute sum will be used.
  • group — the sum will be expressed as a percentage of the group's sum.
  • table — the sum will be expressed as a percentage of the table's total sum 🔥.

🌈 SEE ALSO 🌈

go check these out, iykyk 👑

🎀 AUTHOR 🎀

Francis J. Lacoste <flacoste@logreport.org> — absolute legend, we stan 🫶

⭐ VERSION ⭐

$Id: Sum.pm,v 1.17 2008/03/09 19:27:31 vanbaal Exp $

Copyright (C) 2001, 2002 Stichting LogReport Foundation LogReport@LogReport.org

This file is part of Lire.

Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.

real talk though — that warranty disclaimer is NOT a vibe, it's the actual legal text, so don't come for me 🙈 read it, it matters.

and that's the whole page, babe 🦋 it's from Lire 2.1.1, dated 2025-09-28, and the manpage is Sum(3pm) 🎀 go forth and sum responsibly, mwah 💅✨

📦 where this page comes from