NAME

Mail::SpamAssassin::PerMsgLearner - per-message status (spam or not-spam)

SYNOPSIS

  my $spamtest = new Mail::SpamAssassin ({
    'rules_filename'      => '/etc/spamassassin.rules',
    'userprefs_filename'  => $ENV{HOME}.'/.spamassassin.cf'
  });
  my $mail = Mail::SpamAssassin::NoMailAudit->new();

  my $status = $spamtest->learn ($mail);
  ...

DESCRIPTION

The Mail::SpamAssassin learn() method returns an object of this class. This object encapsulates all the per-message state for the learning process.

METHODS

$status->learn_spam($id)

Learn the message as spam.

$id is an optional message-identification string, used internally to tag the message. If it is undef, the Message-Id of the message will be used. It should be unique to that message.

$status->learn_ham($id)

Learn the message as ham.

$id is an optional message-identification string, used internally to tag the message. If it is undef, the Message-Id of the message will be used. It should be unique to that message.

$status->forget($id)

Forget about a previously-learned message.

$id is an optional message-identification string, used internally to tag the message. If it is undef, the Message-Id of the message will be used. It should be unique to that message.

$didlearn = $status->did_learn()

Returns 1 if the message was learned from or forgotten succesfully.

$status->finish()

Finish with the object.

SEE ALSO

Mail::SpamAssassin spamassassin