Alien::Build::Plugin::Download::Negotiate(3pm)

1Alien::Build::Plugin::DUoswenrloCaodn:t:rNiebguAotlteiideantP:ee:(rB3lu)iDlodc:u:mPelnutgaitni:o:nDownload::Negotiate(3)
2
3
4

NAME

6       Alien::Build::Plugin::Download::Negotiate - Download negotiation plugin
7

VERSION

9       version 1.55
10

SYNOPSIS

12        use alienfile;
13        share {
14          start_url 'http://ftp.gnu.org/gnu/make';
15          plugin 'Download' => (
16            filter => qr/^make-.*\.tar.\gz$/,
17            version => qr/([0-9\.]+)/,
18          );
19        };
20

DESCRIPTION

22       This is a negotiator plugin for downloading packages from the internet.
23       This plugin picks the best Fetch, Decode and Prefer plugins to do the
24       actual work.  Which plugins are picked depend on the properties you
25       specify, your platform and environment.  It is usually preferable to
26       use a negotiator plugin rather than the Fetch, Decode and Prefer
27       plugins directly from your alienfile.
28

PROPERTIES

30   url
31       [DEPRECATED] use "start_url" instead.
32
33       The Initial URL for your package.  This may be a directory listing
34       (either in HTML or ftp listing format) or the final tarball intended to
35       be downloaded.
36
37   filter
38       This is a regular expression that lets you filter out files that you do
39       not want to consider downloading.  For example, if the directory
40       listing contained tarballs and readme files like this:
41
42        foo-1.0.0.tar.gz
43        foo-1.0.0.readme
44
45       You could specify a filter of "qr/\.tar\.gz$/" to make sure only
46       tarballs are considered for download.
47
48   version
49       Regular expression to parse out the version from a filename.  The
50       regular expression should store the result in $1.
51
52   ssl
53       If your initial URL does not need SSL, but you know ahead of time that
54       a subsequent request will need it (for example, if your directory
55       listing is on "http", but includes links to "https" URLs), then you can
56       set this property to true, and the appropriate Perl SSL modules will be
57       loaded.
58
59   passive
60       If using FTP, attempt a passive mode transfer first, before trying an
61       active mode transfer.
62
63   bootstrap_ssl
64       If set to true, then the download negotiator will avoid using plugins
65       that have a dependency on Net::SSLeay, or other Perl SSL modules.  The
66       intent for this option is to allow OpenSSL to be alienized and be a
67       useful optional dependency for Net::SSLeay.
68
69       The implementation may improve over time, but as of this writing, this
70       option relies on you having a working "curl" or "wget" with SSL support
71       in your "PATH".
72
73   prefer
74       How to sort candidates for selection.  This should be one of three
75       types of values:
76
77       code reference
78           This will be used as the prefer hook.
79
80       true value
81           Use Alien::Build::Plugin::Prefer::SortVersions.
82
83       false value
84           Don't set any preference at all.  A hook must be installed, or
85           another prefer plugin specified.
86

METHODS

88   pick
89        my($fetch, @decoders) = $plugin->pick;
90
91       Returns the fetch plugin and any optional decoders that should be used.
92

AUTHOR

97       Author: Graham Ollis <plicease@cpan.org>
98
99       Contributors:
100
101       Diab Jerius (DJERIUS)
102
103       Roy Storey
104
105       Ilya Pavlov
106
107       David Mertens (run4flat)
108
109       Mark Nunberg (mordy, mnunberg)
110
111       Christian Walde (Mithaldu)
112
113       Brian Wightman (MidLifeXis)
114
115       Zaki Mughal (zmughal)
116
117       mohawk (mohawk2, ETJ)
118
119       Vikas N Kumar (vikasnkumar)
120
121       Flavio Poletti (polettix)
122
123       Salvador Fandiño (salva)
124
125       Gianni Ceccarelli (dakkar)
126
127       Pavel Shaydo (zwon, trinitum)
128
129       Kang-min Liu (劉康民, gugod)
130
131       Nicholas Shipp (nshp)
132
133       Juan Julián Merelo Guervós (JJ)
134
135       Joel Berger (JBERGER)
136
137       Petr Pisar (ppisar)
138
139       Lance Wicks (LANCEW)
140
141       Ahmad Fatoum (a3f, ATHREEF)
142
143       José Joaquín Atria (JJATRIA)
144
145       Duke Leto (LETO)
146
147       Shoichi Kaji (SKAJI)
148
149       Shawn Laffan (SLAFFAN)
150
151       Paul Evans (leonerd, PEVANS)
152

COPYRIGHT AND LICENSE

154       This software is copyright (c) 2011-2018 by Graham Ollis.
155
156       This is free software; you can redistribute it and/or modify it under
157       the same terms as the Perl 5 programming language system itself.
158
159
160
161perl v5.28.1                      2A0l1i9e-n0:2:-B2u4ild::Plugin::Download::Negotiate(3)