1Test::Smoke::Syncer(3)User Contributed Perl DocumentationTest::Smoke::Syncer(3)
2
3
4

NAME

6       Test::Smoke::Syncer - Factory for syncer objects.
7

SYNOPSIS

9           use Test::Smoke::Syncer;
10
11           my $type = 'rsync'; # or 'snapshot' or 'copy'
12           my $syncer = Test::Smoke::Syncer->new( $type => \%sync_config );
13           my $patch_level = $syncer->sync;
14

DESCRIPTION

16       At this moment we support three basic types of syncing the perl source-
17       tree.
18
19       rsync
20           This method uses the rsync program with the "--delete" option to
21           get your perl source-tree up to date.
22
23       snapshot
24           This method uses the Net::FTP or the LWP module to get the latest
25           snapshot. When the server attribute starts with http:// the
26           fetching is done by LWP::Simple::mirror().  To emulate the "rsync
27           --delete" effect, the current source-tree is removed.
28
29           The snapshot tarball is handled by either tar/gzip or
30           Archive::Tar/Compress::Zlib.
31
32       copy
33           This method uses the File::Copy module to copy an existing source-
34           tree from somewhere on the system (in case rsync doesn't work),
35           this also removes the current source-tree first.
36
37       forest
38           This method will sync the source-tree in one of the above basic
39           methods.  After that, it will create an intermediate copy of the
40           master directory as hardlinks and run the regen_headers.pl script.
41           This should yield an up-to-date source-tree. The intermadite
42           directory is now copied as hardlinks to its final directory
43           ({ddir}).
44
45           This can be used to change the way make distclean is run from
46           mktest.pl (removes all files that are not in the intermediate
47           directory, which may prove faster than traditional make distclean).
48

METHODS

50   Test::Smoke::Syncer->new( $type, \%sync_config )
51       [ Constructor | Public ]
52
53       Initialise a new object and check all relevant arguments.  It returns
54       an object of the appropriate Test::Smoke::Syncer::* class.
55
56   Test::Smoke::Syncer->config( $key[, $value] )
57       [ Accessor | Public ]
58
59       config() is an interface to the package lexical %CONFIG, which holds
60       all the default values for the new() arguments.
61
62       With the special key all_defaults this returns a reference to a hash
63       holding all the default values.
64

SEE ALSO

66       rsync, gzip, tar, Archive::Tar, Compress::Zlib, File::Copy,
67       Test::Smoke::SourceTree
68

70       (c) 2002-2013, All rights reserved.
71
72         * Abe Timmerman <abeltje@cpan.org>
73
74       This library is free software; you can redistribute it and/or modify it
75       under the same terms as Perl itself.
76
77       See:
78
79         * <http://www.perl.com/perl/misc/Artistic.html>,
80         * <http://www.gnu.org/copyleft/gpl.html>
81
82       This program is distributed in the hope that it will be useful, but
83       WITHOUT ANY WARRANTY; without even the implied warranty of
84       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
85
86
87
88perl v5.38.0                      2023-07-21            Test::Smoke::Syncer(3)
Impressum