1Test::Smoke::Syncer(3)User Contributed Perl DocumentationTest::Smoke::Syncer(3)
2
3
4
6 Test::Smoke::Syncer - Factory for syncer objects.
7
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
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
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
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.36.0 2023-01-20 Test::Smoke::Syncer(3)