Mail::Addressbook::Convert::Juno - convert from Juno addressbooks.


Mail-Addressbook-Convert documentation  | view source Contained in the Mail-Addressbook-Convert distribution.

Index


NAME

Top

Mail::Addressbook::Convert::Juno -- convert from Juno addressbooks.

SYNOPSIS

Top

use strict;

use Mail::Addressbook::Convert::Juno;

my $Juno = new Mail::Addressbook::Convert::Juno();

my $JunoInFile ="junoSample.nv"; # name of the file containing the Juno data # it is found in the Spry folder

# Convert Juno to Standard Intermediate format

# see documentation for details on format.

my $raIntermediate = $Juno->scan(\$JunoInFile.nv);

# This will also work

#my @JunoInArray = @arrayContainingTheJunoData;

#my $raIntermediate = $Juno->scan(\@JunoInArray);

print join "", @$raIntermediate;

REQUIRES

Top

Perl, version 5.001 or higher

Carp

DESCRIPTION

Top

This module is meant to be used as part of the Mail::Addressbook::Convert distribution.

It can convert a Tsv addressbook to a Standard Intermediate format(STF) and a STF to TSV As part of the larger distribution, it will allow conversion between Spry and many other formats.

To use to convert between Juno and Eudora as an example, you would do the following

use Mail::Addressbook::Convert::Juno;

use Mail::Addressbook::Convert::Eudora;

my $Juno = new Mail::Addressbook::Convert::Juno();

my $Eudora = new Mail::Addressbook::Convert::Eudora();

my $junoInFile ="junoSampleFile.nv"; # name of the file containing the juno data

my $raIntermediate = $Juno->scan(\$junoInFile);

my $raEudora = $Eudora->output($raIntermediate); # reference to an array containing a Eudora addressbook

DEFINITIONS

Top

Standard Intermediate Format(STF) :

			The addressbook format that is used as an intermediate
			between conversions.  It is rfc822 compliant and can
			be used directly as a Eudora addressbook.  Do not use
			a Eudora addressbook as an STF. Some versions of 
			Eudora use a format, that while RFC822 compliant, will
			not work as an STF. Run the Eudora addressbook
			through $Eudora->scan()

Juno addressbook:

			use the file with a .nv extension as the input

			


------------------------------------------------------ =head1 METHODS

new

no arguments needed.

scan

Input : a reference to an array containing a Juno file or a reference to a scalar containing the file name with the Juno data. The file exists in the Juno folder with an ".nv" extension.

Returns: a reference to a STF ( see above).

output

There is no output method. That is you cannot convert to a Juno format.

LIMITATIONS

Top

This only converts email address, aliases, and mailing lists. Phone numbers, postal addresses and other such data are not converted.

REFERENCES

Top

HISTORY

Top

This code is derived from the code used on www.interguru.com/mailconv.htm . The site has been up since 1996 ( but ldif was only included on 1997, when Netscape 3 started using it.) The site gets about 8000 unique visitors a month, many of whom make addressbook conversions. The code has been well tested.

FUTURE DIRECTIONS

Top

SEE ALSO

Top

BUGS

Top

CHANGES

Top

Original Version 2001-Sept-09

COPYRIGHT

Top

AUTHOR

Top

Mail::Addressbook::Convert was written by Joe Davidson <jdavidson@interguru.com> in 2001.


Mail-Addressbook-Convert documentation  | view source Contained in the Mail-Addressbook-Convert distribution.