1 | package Convert::UUlib; |
1 | package Convert::UUlib; |
|
|
2 | |
|
|
3 | no warnings; |
|
|
4 | use strict; |
2 | |
5 | |
3 | use Carp; |
6 | use Carp; |
4 | |
7 | |
5 | require Exporter; |
8 | require Exporter; |
6 | require DynaLoader; |
9 | require DynaLoader; |
7 | use AutoLoader; |
|
|
8 | |
10 | |
9 | $VERSION = 0.21; |
11 | our $VERSION = '1.12'; |
10 | |
12 | |
11 | @ISA = qw(Exporter DynaLoader); |
13 | our @ISA = qw(Exporter DynaLoader); |
12 | |
14 | |
13 | @_consts = qw( |
15 | our @_consts = qw( |
14 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
16 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
15 | |
17 | |
16 | FILE_DECODED FILE_ERROR FILE_MISPART FILE_NOBEGIN FILE_NODATA |
18 | FILE_DECODED FILE_ERROR FILE_MISPART FILE_NOBEGIN FILE_NODATA |
17 | FILE_NOEND FILE_OK FILE_READ FILE_TMPFILE |
19 | FILE_NOEND FILE_OK FILE_READ FILE_TMPFILE |
18 | |
20 | |
19 | MSG_ERROR MSG_FATAL MSG_MESSAGE MSG_NOTE MSG_PANIC MSG_WARNING |
21 | MSG_ERROR MSG_FATAL MSG_MESSAGE MSG_NOTE MSG_PANIC MSG_WARNING |
20 | |
22 | |
|
|
23 | OPT_RBUF OPT_WBUF |
21 | OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT |
24 | OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT |
22 | OPT_ERRNO OPT_FAST OPT_IGNMODE OPT_IGNREPLY OPT_OVERWRITE OPT_PREAMB |
25 | OPT_ERRNO OPT_FAST OPT_IGNMODE OPT_IGNREPLY OPT_OVERWRITE OPT_PREAMB |
23 | OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE |
26 | OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE |
24 | OPT_VERSION OPT_REMOVE OPT_MOREMIME |
27 | OPT_VERSION OPT_REMOVE OPT_MOREMIME OPT_DOTDOT |
25 | |
28 | |
26 | RET_CANCEL RET_CONT RET_EXISTS RET_ILLVAL RET_IOERR RET_NODATA |
29 | RET_CANCEL RET_CONT RET_EXISTS RET_ILLVAL RET_IOERR RET_NODATA |
27 | RET_NOEND RET_NOMEM RET_OK RET_UNSUP |
30 | RET_NOEND RET_NOMEM RET_OK RET_UNSUP |
28 | |
31 | |
29 | B64ENCODED BH_ENCODED PT_ENCODED QP_ENCODED |
32 | B64_ENCODED BH_ENCODED PT_ENCODED QP_ENCODED |
30 | XX_ENCODED UU_ENCODED YENC_ENCODED |
33 | XX_ENCODED UU_ENCODED YENC_ENCODED |
31 | ); |
34 | ); |
32 | |
35 | |
33 | @_funcs = qw( |
36 | our @_funcs = qw( |
34 | Initialize CleanUp GetOption SetOption strerror |
37 | Initialize CleanUp GetOption SetOption strerror SetMsgCallback |
35 | SetMsgCallback SetBusyCallback SetFileCallback |
38 | SetBusyCallback SetFileCallback SetFNameFilter SetFileNameCallback |
36 | SetFNameFilter FNameFilter LoadFile GetFileListItem |
39 | FNameFilter LoadFile GetFileListItem RenameFile DecodeToTemp |
37 | RenameFile DecodeToTemp RemoveTemp DecodeFile |
40 | RemoveTemp DecodeFile InfoFile Smerge QuickDecode EncodeMulti |
38 | InfoFile Smerge QuickDecode EncodeMulti EncodePartial |
41 | EncodePartial EncodeToStream EncodeToFile E_PrepSingle |
39 | EncodeToStream EncodeToFile E_PrepSingle E_PrepPartial |
42 | E_PrepPartial |
40 | |
43 | |
41 | straction strencoding strmsglevel |
44 | straction strencoding strmsglevel |
42 | ); |
45 | ); |
43 | |
46 | |
44 | @EXPORT = @_consts; |
47 | our @EXPORT = @_consts; |
45 | @EXPORT_OK = @_funcs; |
48 | our @EXPORT_OK = @_funcs; |
46 | %EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts); |
49 | our %EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts); |
47 | |
50 | |
48 | bootstrap Convert::UUlib $VERSION; |
51 | bootstrap Convert::UUlib $VERSION; |
49 | |
52 | |
50 | Initialize(); |
53 | Initialize(); |
51 | |
54 | |
52 | # not when < 5.005_6x |
55 | # not when < 5.005_6x |
53 | # END { CleanUp() } |
56 | # END { CleanUp() } |
54 | |
57 | |
55 | for (@_consts) { |
58 | for (@_consts) { |
56 | my $constant = constant($_); |
59 | my $constant = constant($_); |
|
|
60 | no strict 'refs'; |
57 | *$_ = sub () { $constant }; |
61 | *$_ = sub () { $constant }; |
58 | } |
62 | } |
59 | |
63 | |
60 | # action code -> string mapping |
64 | # action code -> string mapping |
61 | sub straction($) { |
65 | sub straction($) { |
… | |
… | |
68 | } |
72 | } |
69 | |
73 | |
70 | # encoding type -> string mapping |
74 | # encoding type -> string mapping |
71 | sub strencoding($) { |
75 | sub strencoding($) { |
72 | return 'uuencode' if $_[0] == &UU_ENCODED; |
76 | return 'uuencode' if $_[0] == &UU_ENCODED; |
73 | return 'base64' if $_[0] == &B64ENCODED; |
77 | return 'base64' if $_[0] == &B64_ENCODED; |
74 | return 'yenc' if $_[0] == &YENC_ENCODED; |
78 | return 'yenc' if $_[0] == &YENC_ENCODED; |
75 | return 'binhex' if $_[0] == &BH_ENCODED; |
79 | return 'binhex' if $_[0] == &BH_ENCODED; |
76 | return 'plaintext' if $_[0] == &PT_ENCODED; |
80 | return 'plaintext' if $_[0] == &PT_ENCODED; |
77 | return 'quoted-printable' if $_[0] == &QP_ENCODED; |
81 | return 'quoted-printable' if $_[0] == &QP_ENCODED; |
78 | return 'xxencode' if $_[0] == &XX_ENCODED; |
82 | return 'xxencode' if $_[0] == &XX_ENCODED; |
… | |
… | |
96 | |
100 | |
97 | Convert::UUlib - Perl interface to the uulib library (a.k.a. uudeview/uuenview). |
101 | Convert::UUlib - Perl interface to the uulib library (a.k.a. uudeview/uuenview). |
98 | |
102 | |
99 | =head1 SYNOPSIS |
103 | =head1 SYNOPSIS |
100 | |
104 | |
101 | use Convert::UUlib; |
|
|
102 | |
|
|
103 | =head1 DESCRIPTION |
|
|
104 | |
|
|
105 | Read the file uulibdoc.dvi.gz and the example-decoder source. Sorry - more |
|
|
106 | to come once people use me ;) |
|
|
107 | |
|
|
108 | =head1 SMALL EXAMPLE DECODER |
|
|
109 | |
|
|
110 | The following code excerpt is a minimal decoder program. It reads all |
|
|
111 | files given on the commandline and decodes any files in it. |
|
|
112 | |
|
|
113 | use Convert::UUlib ':all'; |
105 | use Convert::UUlib ':all'; |
114 | |
106 | |
|
|
107 | # read all the files named on the commandline and decode them |
|
|
108 | # into the CURRENT directory. See below for a longer example. |
115 | LoadFile($_) for @ARGV; |
109 | LoadFile $_ for @ARGV; |
116 | |
|
|
117 | for($i=0; $uu=GetFileListItem($i); $i++) { |
110 | for (my $i = 0; my $uu = GetFileListItem $i; $i++) { |
118 | $uu->decode if $uu->state & FILE_OK; |
111 | if ($uu->state & FILE_OK) { |
|
|
112 | $uu->decode; |
|
|
113 | print $uu->filename, "\n"; |
|
|
114 | } |
119 | } |
115 | } |
|
|
116 | |
|
|
117 | =head1 DESCRIPTION |
|
|
118 | |
|
|
119 | Read the file doc/library.pdf from the distribution for in-depth |
|
|
120 | information about the C-library used in this interface, and the rest of |
|
|
121 | this document and especially the non-trivial decoder program at the end. |
|
|
122 | |
|
|
123 | =head1 EXPORTED CONSTANTS |
|
|
124 | |
|
|
125 | =head2 Action code constants |
|
|
126 | |
|
|
127 | ACT_IDLE we don't do anything |
|
|
128 | ACT_SCANNING scanning an input file |
|
|
129 | ACT_DECODING decoding into a temp file |
|
|
130 | ACT_COPYING copying temp to target |
|
|
131 | ACT_ENCODING encoding a file |
|
|
132 | |
|
|
133 | =head2 Message severity levels |
|
|
134 | |
|
|
135 | MSG_MESSAGE just a message, nothing important |
|
|
136 | MSG_NOTE something that should be noticed |
|
|
137 | MSG_WARNING important msg, processing continues |
|
|
138 | MSG_ERROR processing has been terminated |
|
|
139 | MSG_FATAL decoder cannot process further requests |
|
|
140 | MSG_PANIC recovery impossible, app must terminate |
|
|
141 | |
|
|
142 | =head2 Options |
|
|
143 | |
|
|
144 | OPT_VERSION version number MAJOR.MINORplPATCH (ro) |
|
|
145 | OPT_FAST assumes only one part per file |
|
|
146 | OPT_DUMBNESS switch off the program's intelligence |
|
|
147 | OPT_BRACKPOL give numbers in [] higher precendence |
|
|
148 | OPT_VERBOSE generate informative messages |
|
|
149 | OPT_DESPERATE try to decode incomplete files |
|
|
150 | OPT_IGNREPLY ignore RE:plies (off by default) |
|
|
151 | OPT_OVERWRITE whether it's OK to overwrite ex. files |
|
|
152 | OPT_SAVEPATH prefix to save-files on disk |
|
|
153 | OPT_IGNMODE ignore the original file mode |
|
|
154 | OPT_DEBUG print messages with FILE/LINE info |
|
|
155 | OPT_ERRNO get last error code for RET_IOERR (ro) |
|
|
156 | OPT_PROGRESS retrieve progress information |
|
|
157 | OPT_USETEXT handle text messages |
|
|
158 | OPT_PREAMB handle Mime preambles/epilogues |
|
|
159 | OPT_TINYB64 detect short B64 outside of Mime |
|
|
160 | OPT_ENCEXT extension for single-part encoded files |
|
|
161 | OPT_REMOVE remove input files after decoding (dangerous) |
|
|
162 | OPT_MOREMIME strict MIME adherence |
|
|
163 | OPT_DOTDOT ".."-unescaping has not yet been done on input files |
|
|
164 | OPT_RBUF set default read I/O buffer size in bytes *EXPERIMENTAL* |
|
|
165 | OPT_WBUF set default write I/O buffer size in bytes *EXPERIMENTAL* |
|
|
166 | |
|
|
167 | =head2 Result/Error codes |
|
|
168 | |
|
|
169 | RET_OK everything went fine |
|
|
170 | RET_IOERR I/O Error - examine errno |
|
|
171 | RET_NOMEM not enough memory |
|
|
172 | RET_ILLVAL illegal value for operation |
|
|
173 | RET_NODATA decoder didn't find any data |
|
|
174 | RET_NOEND encoded data wasn't ended properly |
|
|
175 | RET_UNSUP unsupported function (encoding) |
|
|
176 | RET_EXISTS file exists (decoding) |
|
|
177 | RET_CONT continue -- special from ScanPart |
|
|
178 | RET_CANCEL operation canceled |
|
|
179 | |
|
|
180 | =head2 File States |
|
|
181 | |
|
|
182 | This code is zero, i.e. "false": |
|
|
183 | |
|
|
184 | UUFILE_READ Read in, but not further processed |
|
|
185 | |
|
|
186 | The following state codes are or'ed together: |
|
|
187 | |
|
|
188 | FILE_MISPART Missing Part(s) detected |
|
|
189 | FILE_NOBEGIN No 'begin' found |
|
|
190 | FILE_NOEND No 'end' found |
|
|
191 | FILE_NODATA File does not contain valid uudata |
|
|
192 | FILE_OK All Parts found, ready to decode |
|
|
193 | FILE_ERROR Error while decoding |
|
|
194 | FILE_DECODED Successfully decoded |
|
|
195 | FILE_TMPFILE Temporary decoded file exists |
|
|
196 | |
|
|
197 | =head2 Encoding types |
|
|
198 | |
|
|
199 | UU_ENCODED UUencoded data |
|
|
200 | B64_ENCODED Mime-Base64 data |
|
|
201 | XX_ENCODED XXencoded data |
|
|
202 | BH_ENCODED Binhex encoded |
|
|
203 | PT_ENCODED Plain-Text encoded (MIME) |
|
|
204 | QP_ENCODED Quoted-Printable (MIME) |
|
|
205 | YENC_ENCODED yEnc encoded (non-MIME) |
|
|
206 | |
|
|
207 | =head1 EXPORTED FUNCTIONS |
|
|
208 | |
|
|
209 | =head2 Initializing and cleanup |
|
|
210 | |
|
|
211 | Initialize is automatically called when the module is loaded and allocates |
|
|
212 | quite a small amount of memory for todays machines ;) CleanUp releases that |
|
|
213 | again. |
|
|
214 | |
|
|
215 | On my machine, a fairly complete decode with DBI backend needs about 10MB |
|
|
216 | RSS to decode 20000 files. |
|
|
217 | |
|
|
218 | =over 4 |
|
|
219 | |
|
|
220 | =item Initialize |
|
|
221 | |
|
|
222 | Not normally necessary, (re-)initializes the library. |
|
|
223 | |
|
|
224 | =item CleanUp |
|
|
225 | |
|
|
226 | Not normally necessary, could be called at the end to release memory |
|
|
227 | before starting a new decoding round. |
|
|
228 | |
|
|
229 | =back |
|
|
230 | |
|
|
231 | =head2 Setting and querying options |
|
|
232 | |
|
|
233 | =over 4 |
|
|
234 | |
|
|
235 | =item $option = GetOption OPT_xxx |
|
|
236 | |
|
|
237 | =item SetOption OPT_xxx, opt-value |
|
|
238 | |
|
|
239 | =back |
|
|
240 | |
|
|
241 | See the C<OPT_xxx> constants above to see which options exist. |
|
|
242 | |
|
|
243 | =head2 Setting various callbacks |
|
|
244 | |
|
|
245 | =over 4 |
|
|
246 | |
|
|
247 | =item SetMsgCallback [callback-function] |
|
|
248 | |
|
|
249 | =item SetBusyCallback [callback-function] |
|
|
250 | |
|
|
251 | =item SetFileCallback [callback-function] |
|
|
252 | |
|
|
253 | =item SetFNameFilter [callback-function] |
|
|
254 | |
|
|
255 | =back |
|
|
256 | |
|
|
257 | =head2 Call the currently selected FNameFilter |
|
|
258 | |
|
|
259 | =over 4 |
|
|
260 | |
|
|
261 | =item $file = FNameFilter $file |
|
|
262 | |
|
|
263 | =back |
|
|
264 | |
|
|
265 | =head2 Loading sourcefiles, optionally fuzzy merge and start decoding |
|
|
266 | |
|
|
267 | =over 4 |
|
|
268 | |
|
|
269 | =item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]] |
|
|
270 | |
|
|
271 | Load the given file and scan it for encoded contents. Optionally tag it |
|
|
272 | with the given id, and if C<$delflag> is true, delete the file after it |
|
|
273 | is no longer necessary. If you are certain of the part number, you can |
|
|
274 | specify it as the last argument. |
|
|
275 | |
|
|
276 | A better (usually faster) way of doing this is using the C<SetFNameFilter> |
|
|
277 | functionality. |
|
|
278 | |
|
|
279 | =item $retval = Smerge $pass |
|
|
280 | |
|
|
281 | If you are desperate, try to call C<Smerge> with increasing C<$pass> |
|
|
282 | values, beginning at C<0>, to try to merge parts that usually would not |
|
|
283 | have been merged. |
|
|
284 | |
|
|
285 | Most probably this will result in garbled files, so never do this by |
|
|
286 | default. |
|
|
287 | |
|
|
288 | =item $item = GetFileListItem $item_number |
|
|
289 | |
|
|
290 | Return the C<$item> structure for the C<$item_number>'th found file, or |
|
|
291 | C<undef> of no file with that number exists. |
|
|
292 | |
|
|
293 | The first file has number C<0>, and the series has no holes, so you can |
|
|
294 | iterate over all files by starting with zero and incrementing until you |
|
|
295 | hit C<undef>. |
|
|
296 | |
|
|
297 | =back |
|
|
298 | |
|
|
299 | =head2 Decoding files |
|
|
300 | |
|
|
301 | =over 4 |
|
|
302 | |
|
|
303 | =item $retval = $item->rename($newname) |
|
|
304 | |
|
|
305 | Change the ondisk filename where the decoded file will be saved. |
|
|
306 | |
|
|
307 | =item $retval = $item->decode_temp |
|
|
308 | |
|
|
309 | Decode the file into a temporary location, use C<< $item->infile >> to |
|
|
310 | retrieve the temporary filename. |
|
|
311 | |
|
|
312 | =item $retval = $item->remove_temp |
|
|
313 | |
|
|
314 | Remove the temporarily decoded file again. |
|
|
315 | |
|
|
316 | =item $retval = $item->decode([$target_path]) |
|
|
317 | |
|
|
318 | Decode the file to it's destination, or the given target path. |
|
|
319 | |
|
|
320 | =item $retval = $item->info(callback-function) |
|
|
321 | |
|
|
322 | =back |
|
|
323 | |
|
|
324 | =head2 Querying (and setting) item attributes |
|
|
325 | |
|
|
326 | =over 4 |
|
|
327 | |
|
|
328 | =item $state = $item->state |
|
|
329 | |
|
|
330 | =item $mode = $item->mode([newmode]) |
|
|
331 | |
|
|
332 | =item $uudet = $item->uudet |
|
|
333 | |
|
|
334 | =item $size = $item->size |
|
|
335 | |
|
|
336 | =item $filename = $item->filename([newfilename}) |
|
|
337 | |
|
|
338 | =item $subfname = $item->subfname |
|
|
339 | |
|
|
340 | =item $mimeid = $item->mimeid |
|
|
341 | |
|
|
342 | =item $mimetype = $item->mimetype |
|
|
343 | |
|
|
344 | =item $binfile = $item->binfile |
|
|
345 | |
|
|
346 | =back |
|
|
347 | |
|
|
348 | =head2 Information about source parts |
|
|
349 | |
|
|
350 | =over 4 |
|
|
351 | |
|
|
352 | =item $parts = $item->parts |
|
|
353 | |
|
|
354 | Return information about all parts (source files) used to decode the file |
|
|
355 | as a list of hashrefs with the following structure: |
|
|
356 | |
|
|
357 | { |
|
|
358 | partno => <integer describing the part number, starting with 1>, |
|
|
359 | # the following member sonly exist when they contain useful information |
|
|
360 | sfname => <local pathname of the file where this part is from>, |
|
|
361 | filename => <the ondisk filename of the decoded file>, |
|
|
362 | subfname => <used to cluster postings, possibly the posting filename>, |
|
|
363 | subject => <the subject of the posting/mail>, |
|
|
364 | origin => <the possible source (From) address>, |
|
|
365 | mimetype => <the possible mimetype of the decoded file>, |
|
|
366 | mimeid => <the id part of the Content-Type>, |
|
|
367 | } |
|
|
368 | |
|
|
369 | Usually you are interested mostly the C<sfname> and possibly the C<partno> |
|
|
370 | and C<filename> members. |
|
|
371 | |
|
|
372 | =back |
|
|
373 | |
|
|
374 | =head2 Functions below not documented and not very well tested |
|
|
375 | |
|
|
376 | QuickDecode |
|
|
377 | EncodeMulti |
|
|
378 | EncodePartial |
|
|
379 | EncodeToStream |
|
|
380 | EncodeToFile |
|
|
381 | E_PrepSingle |
|
|
382 | E_PrepPartial |
|
|
383 | |
|
|
384 | =head2 EXTENSION FUNCTIONS |
|
|
385 | |
|
|
386 | Functions found in this module but not documented in the uulib documentation: |
|
|
387 | |
|
|
388 | =over 4 |
|
|
389 | |
|
|
390 | =item $msg = straction ACT_xxx |
|
|
391 | |
|
|
392 | Return a human readable string representing the given action code. |
|
|
393 | |
|
|
394 | =item $msg = strerror RET_xxx |
|
|
395 | |
|
|
396 | Return a human readable string representing the given error code. |
|
|
397 | |
|
|
398 | =item $str = strencoding xxx_ENCODED |
|
|
399 | |
|
|
400 | Return the name of the encoding type as a string. |
|
|
401 | |
|
|
402 | =item $str = strmsglevel MSG_xxx |
|
|
403 | |
|
|
404 | Returns the message level as a string. |
|
|
405 | |
|
|
406 | =item SetFileNameCallback $cb |
|
|
407 | |
|
|
408 | Sets (or queries) the FileNameCallback, which is called whenever the |
|
|
409 | decoding library can't find a filename and wants to extract a filename |
|
|
410 | from the subject line of a posting. The callback will be called with |
|
|
411 | two arguments, the subject line and the current candidate for the |
|
|
412 | filename. The latter argument can be C<undef>, which means that no |
|
|
413 | filename could be found (and likely no one exists, so it is safe to also |
|
|
414 | return C<undef> in this case). If it doesn't return anything (not even |
|
|
415 | C<undef>!), then nothing happens, so this is a no-op callback: |
|
|
416 | |
|
|
417 | sub cb { |
|
|
418 | return (); |
|
|
419 | } |
|
|
420 | |
|
|
421 | If it returns C<undef>, then this indicates that no filename could be |
|
|
422 | found. In all other cases, the return value is taken to be the filename. |
|
|
423 | |
|
|
424 | This is a slightly more useful callback: |
|
|
425 | |
|
|
426 | sub cb { |
|
|
427 | return unless $_[1]; # skip "Re:"-plies et al. |
|
|
428 | my ($subject, $filename) = @_; |
|
|
429 | # if we find some *.rar, take it |
|
|
430 | return $1 if $subject =~ /(\w+\.rar)/; |
|
|
431 | # otherwise just pass what we have |
|
|
432 | return (); |
|
|
433 | } |
|
|
434 | |
|
|
435 | =back |
120 | |
436 | |
121 | =head1 LARGE EXAMPLE DECODER |
437 | =head1 LARGE EXAMPLE DECODER |
122 | |
438 | |
123 | This is the file C<example-decoder> from the distribution, put here |
439 | This is the file C<example-decoder> from the distribution, put here |
124 | instead of more thorough documentation. |
440 | instead of more thorough documentation. |
125 | |
441 | |
|
|
442 | #!/usr/bin/perl |
|
|
443 | |
126 | # decode all the files in the directory uusrc/ and copy |
444 | # decode all the files in the directory uusrc/ and copy |
127 | # the resulting files to uudst/ |
445 | # the resulting files to uudst/ |
128 | |
446 | |
129 | use Convert::UUlib ':all'; |
447 | use Convert::UUlib ':all'; |
130 | |
448 | |
131 | sub namefilter { |
449 | sub namefilter { |
132 | my($path)=@_; |
450 | my ($path) = @_; |
|
|
451 | |
133 | $path=~s/^.*[\/\\]//; |
452 | $path=~s/^.*[\/\\]//; |
|
|
453 | |
134 | $path; |
454 | $path |
135 | } |
455 | } |
136 | |
456 | |
137 | sub busycb { |
457 | sub busycb { |
138 | my($action,$curfile,$partno,$numparts,$percent,$fsize)=@_; |
458 | my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_; |
139 | $_[0]=straction($action); |
459 | $_[0]=straction($action); |
140 | print "busy_callback(",join(",",@_),")\n"; |
460 | print "busy_callback(", (join ",",@_), ")\n"; |
141 | 0; |
461 | 0 |
142 | } |
462 | } |
143 | |
463 | |
|
|
464 | SetOption OPT_RBUF, 128*1024; |
|
|
465 | SetOption OPT_WBUF, 1024*1024; |
144 | SetOption (OPT_IGNMODE, 1); |
466 | SetOption OPT_IGNMODE, 1; |
|
|
467 | SetOption OPT_IGNMODE, 1; |
145 | SetOption (OPT_VERBOSE, 1); |
468 | SetOption OPT_VERBOSE, 1; |
146 | |
469 | |
147 | # show the three ways you can set callback functions |
470 | # show the three ways you can set callback functions. I normally |
|
|
471 | # prefer the one with the sub inplace. |
148 | SetFNameFilter (\&namefilter); |
472 | SetFNameFilter \&namefilter; |
149 | |
473 | |
150 | SetBusyCallback ("busycb",333); |
474 | SetBusyCallback "busycb", 333; |
151 | |
475 | |
152 | SetMsgCallback (sub { |
476 | SetMsgCallback sub { |
153 | my($msg,$level)=@_; |
477 | my ($msg, $level) = @_; |
154 | print uc(strmsglevel($_[1])),": $msg\n"; |
478 | print uc strmsglevel $_[1], ": $msg\n"; |
155 | }); |
479 | }; |
156 | |
480 | |
|
|
481 | # the following non-trivial FileNameCallback takes care |
|
|
482 | # of some subject lines not detected properly by uulib: |
|
|
483 | SetFileNameCallback sub { |
|
|
484 | return unless $_[1]; # skip "Re:"-plies et al. |
|
|
485 | local $_ = $_[0]; |
|
|
486 | |
|
|
487 | return $1 if /(\S+\s+IMG_\d+.jpg)/i; |
|
|
488 | |
|
|
489 | # the following rules are rather effective on some newsgroups, |
|
|
490 | # like alt.binaries.games.anime, where non-mime, uuencoded data |
|
|
491 | # is very common |
|
|
492 | |
|
|
493 | # if we find some *.rar, take it as the filename |
|
|
494 | return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d|rar))\s/i; |
|
|
495 | |
|
|
496 | # one common subject format |
|
|
497 | return $1 if /- "(.{2,}?\..+?)" (?:yenc )?\(\d+\/\d+\)/i; |
|
|
498 | |
|
|
499 | # - filename.par (04/55) |
|
|
500 | return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?\(\d+\/\d+\)/i; |
|
|
501 | |
|
|
502 | # - (xxx) No. 1 sayuri81.jpg 756565 bytes |
|
|
503 | # - (20 files) No.17 Roseanne.jpg [2/2] |
|
|
504 | return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/; |
|
|
505 | |
|
|
506 | # try to detect some common forms of filenames |
|
|
507 | return $1 if /([a-z0-9_\-+.]{3,}\.[a-z]{3,4}(?:.\d+))/i; |
|
|
508 | |
|
|
509 | # otherwise just pass what we have |
|
|
510 | () |
|
|
511 | }; |
|
|
512 | |
|
|
513 | # now read all files in the directory uusrc/* |
157 | for(<uusrc/*>) { |
514 | for(<uusrc/*>) { |
158 | my($retval,$count)=LoadFile ($_,$_,1); |
515 | my ($retval, $count) = LoadFile ($_, $_, 1); |
159 | print "file($_), status(",strerror($retval),") parts($count)\n"; |
516 | print "file($_), status(", strerror $retval, ") parts($count)\n"; |
160 | } |
517 | } |
161 | |
518 | |
162 | SetOption (OPT_SAVEPATH, "uudst/"); |
519 | SetOption OPT_SAVEPATH, "uudst/"; |
163 | |
520 | |
|
|
521 | # now wade through all files and their source parts |
164 | $i=0; |
522 | $i = 0; |
165 | while($uu=GetFileListItem($i)) { |
523 | while ($uu = GetFileListItem $i) { |
166 | $i++; |
524 | $i++; |
167 | print "file nr. $i"; |
525 | print "file nr. $i"; |
168 | print " state ",$uu->state; |
526 | print " state ", $uu->state; |
169 | print " mode ",$uu->mode; |
527 | print " mode ", $uu->mode; |
170 | print " uudet ",strencoding($uu->uudet); |
528 | print " uudet ", strencoding $uu->uudet; |
171 | print " size ",$uu->size; |
529 | print " size ", $uu->size; |
172 | print " filename ",$uu->filename; |
530 | print " filename ", $uu->filename; |
173 | print " subfname ",$uu->subfname; |
531 | print " subfname ", $uu->subfname; |
174 | print " mimeid ",$uu->mimeid; |
532 | print " mimeid ", $uu->mimeid; |
175 | print " mimetype ",$uu->mimetype; |
533 | print " mimetype ", $uu->mimetype; |
176 | print "\n"; |
534 | print "\n"; |
177 | |
535 | |
178 | # print additional info about all parts |
536 | # print additional info about all parts |
179 | for($uu->parts) { |
537 | for ($uu->parts) { |
180 | while(my($k,$v)=each(%$_)) { |
538 | while (my ($k, $v) = each %$_) { |
181 | print "$k > $v, "; |
539 | print "$k > $v, "; |
182 | } |
540 | } |
183 | print "\n"; |
541 | print "\n"; |
184 | } |
542 | } |
185 | |
543 | |
186 | $uu->decode_temp; |
544 | print $uu->filename; |
187 | print " temporarily decoded to ",$uu->binfile,"\n"; |
545 | |
188 | $uu->remove_temp; |
546 | $uu->remove_temp; |
189 | |
547 | |
190 | print strerror($uu->decode); |
548 | if (my $err = $uu->decode ()) { |
|
|
549 | print ", ", strerror $err, "\n"; |
|
|
550 | } else { |
191 | print " saved as uudst/",$uu->filename,"\n"; |
551 | print ", saved as uudst/", $uu->filename, "\n"; |
192 | } |
552 | } |
|
|
553 | } |
193 | |
554 | |
194 | print "cleanup...\n"; |
555 | print "cleanup...\n"; |
195 | |
556 | |
196 | CleanUp(); |
557 | CleanUp; |
197 | |
|
|
198 | =head1 Exported constants |
|
|
199 | |
|
|
200 | Action code constants: |
|
|
201 | |
|
|
202 | ACT_COPYING ACT_DECODING ACT_ENCODING |
|
|
203 | ACT_IDLE ACT_SCANNING |
|
|
204 | |
|
|
205 | File status flags: |
|
|
206 | |
|
|
207 | FILE_DECODED FILE_ERROR FILE_MISPART |
|
|
208 | FILE_NOBEGIN FILE_NODATA FILE_NOEND |
|
|
209 | FILE_OK FILE_READ FILE_TMPFILE |
|
|
210 | |
|
|
211 | Message severity levels: |
|
|
212 | |
|
|
213 | MSG_ERROR MSG_FATAL MSG_MESSAGE |
|
|
214 | MSG_NOTE MSG_PANIC MSG_WARNING |
|
|
215 | |
|
|
216 | Options: |
|
|
217 | |
|
|
218 | OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS |
|
|
219 | OPT_ENCEXT OPT_ERRNO OPT_FAST OPT_IGNMODE |
|
|
220 | OPT_IGNREPLY OPT_OVERWRITE OPT_PREAMB OPT_PROGRESS |
|
|
221 | OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE |
|
|
222 | OPT_VERSION OPT_REMOVE OPT_MOREMIME |
|
|
223 | |
|
|
224 | Error/Result codes: |
|
|
225 | |
|
|
226 | RET_CANCEL RET_CONT RET_EXISTS RET_ILLVAL RET_IOERR |
|
|
227 | RET_NODATA RET_NOEND RET_NOMEM RET_OK RET_UNSUP |
|
|
228 | |
|
|
229 | Encoding types: |
|
|
230 | |
|
|
231 | B64ENCODED BH_ENCODED PT_ENCODED |
|
|
232 | QP_ENCODED XX_ENCODED UU_ENCODED |
|
|
233 | |
|
|
234 | =head1 Exported functions |
|
|
235 | |
|
|
236 | Initializing and cleanup (Initialize is automatically called when the |
|
|
237 | module is loaded and allocates quite a bit of memory. CleanUp releases |
|
|
238 | that again). |
|
|
239 | |
|
|
240 | Initialize; # not normally necessary |
|
|
241 | CleanUp; # could be called at the end to release memory |
|
|
242 | |
|
|
243 | Setting and querying options: |
|
|
244 | |
|
|
245 | $option = GetOption OPT_xxx; |
|
|
246 | SetOption OPT_xxx, opt-value; |
|
|
247 | |
|
|
248 | Error and action values => stringified: |
|
|
249 | |
|
|
250 | $msg = straction ACT_xxx; |
|
|
251 | $msg = strerror RET_xxx; |
|
|
252 | |
|
|
253 | Setting various callbacks: |
|
|
254 | |
|
|
255 | SetMsgCallback [callback-function]; |
|
|
256 | SetBusyCallback [callback-function]; |
|
|
257 | SetFileCallback [callback-function]; |
|
|
258 | SetFNameFilter [callback-function]; |
|
|
259 | |
|
|
260 | Call the currently selected FNameFilter: |
|
|
261 | |
|
|
262 | $file = FNameFilter $file; |
|
|
263 | |
|
|
264 | Loading sourcefiles, optionally fuzzy merge and start decoding: |
|
|
265 | |
|
|
266 | ($retval, $count) = LoadFile $fname, [$id, [$delflag]]; |
|
|
267 | $retval = Smerge $pass; |
|
|
268 | $item = GetFileListItem $item_number; |
|
|
269 | |
|
|
270 | The procedural interface is undocumented, use the following methods instead: |
|
|
271 | |
|
|
272 | $retval = $item->rename($newname); |
|
|
273 | $retval = $item->decode_temp; |
|
|
274 | $retval = $item->remove_temp; |
|
|
275 | $retval = $item->decode([$target_path]); |
|
|
276 | $retval = $item->info(callback-function); |
|
|
277 | |
|
|
278 | Querying (and setting) item attributes: |
|
|
279 | |
|
|
280 | $state = $item->state; |
|
|
281 | $mode = $item->mode([newmode]); |
|
|
282 | $uudet = $item->uudet; |
|
|
283 | $size = $item->size; |
|
|
284 | $filename = $item->filename([newfilename}); |
|
|
285 | $subfname = $item->subfname; |
|
|
286 | $mimeid = $item->mimeid; |
|
|
287 | $mimetype = $item->mimetype; |
|
|
288 | $binfile = $item->binfile; |
|
|
289 | |
|
|
290 | Totally undocumented and unsupported(!): |
|
|
291 | |
|
|
292 | $parts = $item->parts; |
|
|
293 | |
|
|
294 | Functions below not documented and not very well tested: |
|
|
295 | |
|
|
296 | int QuickDecode () ; |
|
|
297 | int EncodeMulti () ; |
|
|
298 | int EncodePartial () ; |
|
|
299 | int EncodeToStream () ; |
|
|
300 | int EncodeToFile () ; |
|
|
301 | int E_PrepSingle () ; |
|
|
302 | int E_PrepPartial () ; |
|
|
303 | |
558 | |
304 | =head1 AUTHOR |
559 | =head1 AUTHOR |
305 | |
560 | |
306 | Marc Lehmann <pcg@goof.com>, the original uulib library was written by |
561 | Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written |
307 | Frank Pilhofer <fp@informatik.uni-frankfurt.de>. |
562 | by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily |
|
|
563 | bugfixed by Marc Lehmann. |
308 | |
564 | |
309 | =head1 SEE ALSO |
565 | =head1 SEE ALSO |
310 | |
566 | |
311 | perl(1), uudeview homepage at http://www.uni-frankfurt.de/~fp/uudeview/. |
567 | perl(1), uudeview homepage at http://www.uni-frankfurt.de/~fp/uudeview/. |
312 | |
568 | |