ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Convert-UUlib/UUlib.pm
(Generate patch)

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.1 by root, Mon Jun 11 19:48:55 2001 UTC vs.
Revision 1.17 by root, Mon Nov 24 16:10:22 2003 UTC

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

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines