net::sieve::script::condition(3pm) [debian man page]

Net::Sieve::Script::Condition(3pm)			User Contributed Perl Documentation			Net::Sieve::Script::Condition(3pm)

NAME

       Net::Sieve::Script::Condition - parse and write conditions in sieve scripts

SYNOPSIS

	 use Net::Sieve::Script::Condition;

	 my $cond = Net::Sieve::Script::Condition->new('header');
	   $cond->match_type(':contains');
	   $cond->key_list('"[Test4]"');
	   $cond->header_list('"Subject"');

	  print $cond->write();

       or

	  my $cond = Net::Sieve::Script::Condition->new(
	    'anyof (
	      header :contains "Subject" "[Test]",
		  header :contains "Subject" "[Test2]")'
		);

	  print $cond->write();

DESCRIPTION

       Parse and write condition part of Sieve rules, see Net::Sieve::Script.

       Support RFC 5228, 5231 (relationnal) and regex draft

CONSTRUCTOR

   new
       Match and set accessors for each condition object in conditions tree, "test" is mandatory

       Internal

	 id :	     id for condition, set by creation order
	 condition : array of sub conditions
	 parent :    parent of sub condition
	 AllConds :  array of pointers for all conditions

       Condition parts
	 not	      : 'not' or nothing
	 test	      : 'header', 'address', 'exists', ...
	 key_list     : "subject" or ["To", "Cc"]
	 header_list  : "text" or ["text1", "text2"]
	 address_part : ':all ', ':localpart ', ...
	 match_type   : ':is ', ':contains ', ...
	 comparator   : string part

METHODS

   equals
	Purpose  : test conditions
	Return	 : 1 on equals conditions

   write
	Purpose  : write rule conditions in text format
	Return	 : multi-line formated text

AUTHOR

	   Yves Agostini
	   CPAN ID: YVESAGO
	   Univ Metz
	   agostini@univ-metz.fr
	   http://www.crium.univ-metz.fr

COPYRIGHT

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

       The full text of the license can be found in the LICENSE file included with this module.

perl v5.10.0							    2008-09-15					Net::Sieve::Script::Condition(3pm)

Net::Sieve::Script::Rule(3pm)				User Contributed Perl Documentation			     Net::Sieve::Script::Rule(3pm)

NAME

       Net::Sieve::Script::Rule - parse and write rules in sieve scripts

SYNOPSIS

	 use Net::Sieve::Script::Rule;
	       my $pRule = Net::Sieve::Script::Rule->new (
		   ctrl => $ctrl,
		   test_list => $test_list,
		   block => $block,
		   order => $order
		   );

       or
	   my $rule =  Net::Sieve::Script::Rule->new();
	   my $cond = Net::Sieve::Script::Condition->new('header');
	      $cond->match_type(':contains');
	      $cond->header_list('"Subject"');
	      $cond->key_list('"Re: Test2"');
	   my $actions = 'fileinto "INBOX.test"; stop;';

	     $rule->add_condition($cond);
	     $rule->add_action($actions);

	     print $rule->write;

DESCRIPTION

CONSTRUCTOR

   new
	   Arguments :
	       order =>     : optionnal set priority for rule
	       ctrl  =>     : optionnal default 'if', else could be 'else', 'elsif'
			      or 'vacation'
	       test_list => : optionnal conditions by string or by Condition Object
	       block =>     : optionnal block of commands
	   Returns   :	 Net::Sieve::Script::Rule object

       Set accessors

	 alternate  : as param ctrl
	 conditions : first condition in tree
	 actions    : array of actions objects
	 priority   : rule order in script, main id for rule
	 require    :

METHODS

   equals
       return 1 if rules are equals

   write
	Return rule in text format

   write_condition
	set require for used conditions
	return conditions in text format

   write_action
	set require for used actions
	return actions in text format

   delete_condition
	Purpose   : delete condition by rule, delete all block on delete anyof/allof
		    delete single anyof/allof block : single condition move up
	Arguments : condition id
	Returns   : 1 on success, 0 on error

   add_condition
	Purpose   : add condition to rule, add 'allof' group on second rule
	Arguments : string or Condition object
	Returns   : new condition id or 0 on error

   swap_actions
	swap actions by order
	return 1 on succes, 0 on failure

   find_action
	find action by order
	Returns:  Net::Sieve::Script::Action object, 0 on error

   delete_action
       delete action by order, first is 1;

   add_action
	Purpose   : add action at end of block
	Arguments : command line
		    or command line list with ; separator
		    or Net::Sieve::Script::Action object
	Return	  : 1 on success

AUTHOR

	   Yves Agostini
	   CPAN ID: YVESAGO
	   Univ Metz
	   agostini@univ-metz.fr
	   http://www.crium.univ-metz.fr

COPYRIGHT

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

       The full text of the license can be found in the LICENSE file included with this module.

perl v5.10.0							    2008-09-15					     Net::Sieve::Script::Rule(3pm)