The following handles basic maths. It should be fairly obvious how to extend it to cover other mathematical operations.
lib/Scalar/Annotated.pm
package Scalar::Annotated;
use 5.010;
use strict;
use utf8;
use Carp;
use Scalar::Util qw/looks_like_number blessed/;
sub _swap
{
my ($sub, $x, $y, $swap) = @_;
$swap ? $sub>($y, $x) : $sub>($x, $y);
}
sub _promote
{
map {
blessed($_) && $_>isa(__PACKAGE__)
? $_
: an($_)
} @_
}
use namespace::clean;
use parent qw/Exporter/;
use Object::AUTHORITY;
use Object::DOES;
use Object::Stash type => 'object';
our ($AUTHORITY, $VERSION, @EXPORT);
BEGIN {
$AUTHORITY = 'cpan:TOBYINK';
$VERSION = '0.001';
@EXPORT = qw/an/;
}
sub new
{
my ($class, $value, $derivation) = @_;
croak "Needs to be a simple scalar" if ref $value;
$derivation //= looks_like_number($value) ? $value : "q{$value}";
my $self = bless \$value, $class;
$self>derivation = $derivation;
return $self;
}
sub an
{
return __PACKAGE__>new(@_);
}
sub derivation :lvalue
{
my $self = shift;
$self>stash>derivation(@_)
}
use overload
'+0' => sub { ${ $_[0] } },
q{""} => sub { ${ $_[0] } },
'+' => sub { _swap(\&add, @_) },
'' => sub { _swap(\&subtract, @_) },
'*' => sub { _swap(\&multiply, @_) },
'/' => sub { _swap(\÷, @_) },
'%' => sub { _swap(\&modulus, @_) },
;
sub add
{
my ($x, $y) = _promote(@_);
return an(
$$x + $$y,
sprintf('(%s + %s)', $x>derivation, $y>derivation),
);
}
sub subtract
{
my ($x, $y) = _promote(@_);
return an(
$$x  $$y,
sprintf('(%s  %s)', $x>derivation, $y>derivation),
);
}
sub multiply
{
my ($x, $y) = _promote(@_);
return an(
$$x * $$y,
sprintf('(%s × %s)', $x>derivation, $y>derivation),
);
}
sub divide
{
my ($x, $y) = _promote(@_);
return an(
$$x / $$y,
sprintf('(%s ÷ %s)', $x>derivation, $y>derivation),
);
}
sub modulus
{
my ($x, $y) = _promote(@_);
return an(
$$x % $$y,
sprintf('(%s mod %s)', $x>derivation, $y>derivation),
);
}
__PACKAGE__
example.pl
use 5.010;
use strict;
use utf8::all;
use lib "lib";
use Scalar::Annotated;
my $foo = an(5, '$foo');
my $bar = an(2, '$bar');
my $baz = 2 * ($foo + $bar  1);
my $quux = $baz % $foo;
say '$quux is ', $quux;
say '$quux was calculated as ', $quux>derivation;
# Reset the derivation of $quux, because we are no longer
# interested in how it was derived.
$quux>derivation = '$quux';
$quux *= 2;
say '$quux is now ', $quux;
say '$quux was calculated as ', $quux>derivation;
Output
$quux is 2
$quux was calculated as ((2 × (($foo + $bar)  1)) mod $foo)
$quux is now 4
$quux was calculated as ($quux × 2)
Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
Read Where should I post X? if you're not absolutely sure you're posting in the right place.
Please read these before you post! —
Posts may use any of the Perl Monks Approved HTML tags:
 a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

For: 

Use: 
 &   & 
 <   < 
 >   > 
 [   [ 
 ]   ] 
Link using PerlMonks shortcuts! What shortcuts can I use for linking?
See Writeup Formatting Tips and other pages linked from there for more info.