RoPkg::Rsync::Atom(3pm) 				User Contributed Perl Documentation				   RoPkg::Rsync::Atom(3pm)

NAME

       RoPkg::Rsync::Atom - the smallest unit in a rsync configuration file

SYPONSIS

	#!/usr/bin/perl

	use strict;
	use warnings;

	use RoPkg::Rsync::Atom;

	sub main {
	  my $a = new RoPkg::Rsync::Atom(
			type  => 'param',
			name  => 'uid',
			value => 'nobody',
		      );

	  print $a->ToString(0),$/;

	  return 0;
	}

	main();

DESCRIPTION

       RoPkg::Rsync::Atom is a class used by RoPkg::Rsync modules. The Atom is considered the smallest part of any rsync configuration file. An
       atom can be (at this moment):

       param
       blank
       comment

METHODS

       All methods, throw the OutsideClass exception, if you use them as class methods.

       Example:

	perl -MRoPkg::Rsync::Atom -e 'RoPkg::Rsync::Atom->Type;'
	Called outside class instance

       Besides OutsideClass the methods are throwing other exceptions as well. Refer to each method documentation for more information.

       new()

       The constructor of the class. new accepts 3 parameters grouped inside a hash:

       *) type - type of the atom
       *) name - name of the atom
       *) value - value of the atom

       The type parameter must always be present. If the type parameter is not present, a Param::Missing exception is raised.  At this moment, the
       atoms have 3 types:

       *) param - a parameter in the standard form (name = value)
       *) comment - a comment
       *) blank - a blank line (or only with separators)

       If the value of the type parameter is not one of the ones specified a Param::Wrong exception is raised.

       Examples:

       example 1 (param):

	my $a = new RoPkg::Rsync::Atom(
		      type  => 'param',
		      name  => 'gid',
		      value => 'users',
		    );

       example 2 (param):

	my $a = new RoPkg::Rsync::Atom(type => 'param');
	$a->Name('gid');
	$a->Value('users');
	print 'Name of the atom is:',$a->Name,$/;

       example 3 (comment):

	my $a = new RoPkg::Rsync::Atom(
		      type  => 'comment',
		      value => '# this is the group id',
		    );

       example 4 (blank):

	my $a = new RoPkg::Rsync::Atom(
		      type  => 'blank',
		      value => q{ },
		    );

       Name($new_name)

       The Name method is a get/set method. If $new_name exists (and his value is defined) then the set behaviour is selected, otherwise the
       method acts as a get method.  Returns the name of the atom.

       Value($new_value)

       The Value method is a get/set method. If $new_value exists (and his value is defined) then the set behaviour is selected, otherwise the
       method acts as a get method.  Returns the value of the atom.

       ToString($indent, $spaces)

       Returns the string representation of the atom. Accepts 2 parameters: indent and spaces.	$indent is a true/false value specifing that the
       string representation should be prefixed with a tab character; $spaces is used to compute the number of spaces that should be added after
       the atom name, so that the total length of the parameter name to match the $spaces value.

       Example:

	my $a = new RoPkg::Rsync::Atom(
		      type  => 'param',
		      name  => 'gid',
		      value => 'users',
		    );

	print $a->ToString(0, 6),$/,
	      $a->ToString(0, 5),$/,
	      $a->ToString(0, 4),$/,
	      $a->ToString(0, 3),$/,
	      $a->ToString(1, 6),$/,
	      $a->ToString(1, 5),$/,
	      $a->ToString(1, 4),$/,
	      $a->ToString(1, 3),$/;

       The result is:
	gid    = users
	gid   = users
	gid  = users
	gid = users
	       gid    = users
	       gid   = users
	       gid  = users
	       gid = users

       Type

       Returns the type (string representation) of the atom.

PREREQUISITES

       perl 5.008 (or later) is required. Besides perl, you must have the following:

       RoPkg::Exceptions
       English
       Scalar::Util

SEE ALSO

       RoPkg::Rsync::Node RoPkg::Rsync::ConfFile RoPkg::Exceptions

AUTHOR

       Subredu Manuel <diablo@iasi.roedu.net>

LICENSE

       Copyright (C) 2005 Subredu Manuel.  All Rights Reserved.  This module is free software; you can redistribute it and/or modify it under the
       same terms as Perl itself.  The LICENSE file contains the full text of the license.

perl v5.8.8							    2006-06-09						   RoPkg::Rsync::Atom(3pm)