~sschwarzer/ftputil

ref: c6d0136bf66260c302304a9c53848e08337d405d ftputil/doc/announcements.txt -rw-r--r-- 35.9 KiB
c6d0136bStefan Schwarzer Mention that `account` and `session_factory` normally aren't needed 6 years ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
ftputil 3.2 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 3.1
-------------------------

- For some platforms (notably Windows) modification datetimes before
  the epoch would cause an `OverflowError` [1]. Other platforms could
  return negative values. Since the Python documentation for the
  `time` module [2] points out that values before the epoch might
  cause problems, ftputil now sets the float value for such datetimes
  to 0.0.

  In theory, this might cause backward compatibility problems, but
  it's very unlikely since pre-epoch timestamps in directory listings
  should be very rare.

- On some platforms, the `time.mktime` implementation could behave
  strange and accept invalid date/time values. For example, a day
  value of 32 would be accepted and implicitly cause a "wrap" to the
  next month. Such invalid values now result in a `ParserError`.

- Make error handling more robust where the underlying FTP session
  factory (for example, `ftplib.FTP`) uses byte strings for exception
  messages. [3]

- Improved error handling for directory listings. As just one example,
  previously a non-integer value for a day would unintentionally cause
  a `ValueError`. Now this causes a `ParserError`.

- Extracted socket file adapter module [4] so that it can be used
  by other projects.

Note that ftputil 3.0 broke backward compatibility with ftputil 2.8
and before. The differences are described here:
http://ftputil.sschwarzer.net/trac/wiki/WhatsNewInFtputil3.0

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

See the documentation for details:
http://ftputil.sschwarzer.net/trac/wiki/Documentation

License
-------

ftputil is open source software, released under the revised BSD
license (see http://opensource.org/licenses/BSD-3-Clause ).

[1] http://ftputil.sschwarzer.net/trac/ticket/83
[2] https://docs.python.org/3/library/time.html
[3] http://ftputil.sschwarzer.net/trac/ticket/85
[4] http://ftputil.sschwarzer.net/trac/wiki/SocketFileAdapter

Have fun! :-)

Stefan

----------------------------------------------------------------------
ftputil 3.1 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 3.0
-------------------------

- Added support for `followlinks` parameter in `FTPHost.walk`. [1]

- Trying to pickle `FTPHost` and `FTPFile` objects now raises explicit
  `TypeError`s to make clear that not being able to pickle these
  objects is intentional. [2]

- Improved exception messages for socket errors [3].

- Fixed handling of server error messages with non-ASCII characters
  when running under Python 2.x. [4]

- Added a generic "session factory factory" to make creation of
  session factories easier for common use cases (encrypted
  connections, non-default port, active/passive mode, FTP session
  debug level and combination of these). [5] This includes a
  workaround for `M2Crypto.ftpslib.FTP_TLS`; this class won't be
  usable with ftputil 3.0 and up with just the session factory recipe
  described in the documentation. [6]

- Don't assume time zone differences to always be full hours, but
  rather 15-minute units. [7] For example, according to [8], Nepal's
  time zone is UTC+05:45.

- Improved documentation on timeout handling. This includes
  information on internal creation of additional FTP connections (for
  remote files, including uploads and downloads). This may help
  understand better why the `keep_alive` method is limited.

Note that ftputil 3.0 broke backward compatibility with ftputil 2.8
and before. The differences are described here:
http://ftputil.sschwarzer.net/trac/wiki/WhatsNewInFtputil3.0

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

See the documentation for details:
http://ftputil.sschwarzer.net/trac/wiki/Documentation

License
-------

ftputil is open source software, released under the revised BSD
license (see http://opensource.org/licenses/BSD-3-Clause ).

[1] http://ftputil.sschwarzer.net/trac/ticket/73
[2] http://ftputil.sschwarzer.net/trac/ticket/75
[3] http://ftputil.sschwarzer.net/trac/ticket/76
[4] http://ftputil.sschwarzer.net/trac/ticket/77
[5] http://ftputil.sschwarzer.net/trac/ticket/78
[6] http://ftputil.sschwarzer.net/trac/wiki/Documentation#session-factories
[7] http://ftputil.sschwarzer.net/trac/ticket/81
[8] http://en.wikipedia.org/wiki/Timezone#List_of_UTC_offsets

Have fun! :-)

Stefan

----------------------------------------------------------------------
ftputil 3.0 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.8
-------------------------

Note: This version of ftputil is _not_ backward-compatible
with earlier versions.See the links below for information
on adapting existing client code.

- This version adds Python 3 compatibility! :-)

  The same source is used for Python 2.x and Python 3.x.

  I had to change the API to find a good compromise for
  both Python versions.

- ftputil now requires at least Python 2.6.

- Remote file-like objects use the same semantics as Python's
  `io` module. (This is the same as for the built-in `open`
  function in Python 3.)

- `ftputil.ftp_error` was renamed to `ftputil.error`.

- For custom parsers, import `ftputil.parser` instead of
  `ftputil.stat`.

For more information please read
http://ftputil.sschwarzer.net/trac/wiki/Documentation
http://ftputil.sschwarzer.net/trac/wiki/WhatsNewInFtputil3.0

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://opensource.org/licenses/BSD-3-Clause ).

Stefan

----------------------------------------------------------------------
ftputil 2.8 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.7.1
---------------------------

- After some discussion [1] I decided to remove the auto-probing
  before using the `-a` option for `LIST` [2] to find "hidden" files
  and directories. The option is used by default now, without probing
  for exceptions. If this new approach causes problems, you can use

    ftp_host = ftputil.FTPHost(...)
    ftp_host.use_list_a_option = False

- Several bugs were fixed. [3]

- The mailing lists have moved to

    ftputil@lists.sschwarzer.net
    ftputil-tickets@lists.sschwarzer.net

  The ftputil list [4] requires a subscription before you can post.
  The ftputil-tickets list [5] is read-only anyway.

  Thanks to Codespeak.net for having hosted the lists for almost
  ten years. :-)

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://opensource.org/licenses/BSD-3-Clause ).

[1] http://ftputil.sschwarzer.net/trac/ticket/65
[2] http://lists.sschwarzer.net/pipermail/ftputil/2012q3/000350.html
[3] http://ftputil.sschwarzer.net/trac/ticket/39
    http://ftputil.sschwarzer.net/trac/ticket/65
    http://ftputil.sschwarzer.net/trac/ticket/66
    http://ftputil.sschwarzer.net/trac/ticket/67
    http://ftputil.sschwarzer.net/trac/ticket/69
[4] http://lists.sschwarzer.net/listinfo/ftputil
    http://lists.sschwarzer.net/listinfo/ftputil-tickets

Stefan

----------------------------------------------------------------------
ftputil 2.7 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.6
-------------------------

- ftputil now explicitly tries to get hidden directory and file
  names (names starting with a dot) from the FTP server. [1]

  Before, ftputil used a `LIST` command to get directory listings, now
  it uses `LIST -a` if the server doesn't explicitly reject its usage
  upon login. Note that the server is free to ignore the `-a` option,
  so "hidden" directories and files may still not be visible. Please
  see [2] for details.

  If you have code that _relies_ on "hidden" directory or file names
  _not_ being visible, please update the code as necessary. If that's
  presumably not possible, please send feedback to the mailing list [3]
  or in private mail [4].

- A bug in the experimental synchronization code was fixed [5]. Thanks
  to Zhuo Qiang for his help. :-)

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

[1] http://ftputil.sschwarzer.net/trac/ticket/23
[2] http://ftputil.sschwarzer.net/trac/ticket/23#comment:4
[3] http://codespeak.net/mailman/listinfo/ftputil
    (note that you need to subscribe to the list to be able to post there)
[4] sschwarzer@sschwarzer.net
[5] http://ftputil.sschwarzer.net/trac/ticket/62

Stefan

----------------------------------------------------------------------
ftputil 2.6 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.5
-------------------------

- The stat caching has been improved. There's now an "auto-grow"
  feature for `FTPHost.listdir` which in turn applies to
  `FTPHost.walk`. Moreover, there were several performance
  optimizations.

- A few bugs were fixed [1-3].

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

[1] http://ftputil.sschwarzer.net/trac/ticket/53
[2] http://ftputil.sschwarzer.net/trac/ticket/55
[3] http://ftputil.sschwarzer.net/trac/ticket/56

Stefan

----------------------------------------------------------------------
ftputil 2.5 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.4.2
---------------------------

- As announced over a year ago [1], the `xreadlines` method for
  FTP file objects has been removed, and exceptions can no longer be
  accessed via the `ftputil` namespace. Only use `ftp_error` to access
  the exceptions.

  The distribution contains a small tool `find_deprecated_code.py` to
  scan a directory tree for the deprecated uses. Invoke the program
  with the `--help` option to see a description.

- Upload and download methods now accept a `callback` argument to do
  things during a transfer. Modification time comparisons in
  `upload_if_newer` and `download_if_newer` now consider the timestamp
  precision of the remote file which may lead to some unnecessary
  transfers. These can be avoided by waiting at least a minute between
  calls of `upload_if_newer` (or `download_if_newer`) for the same
  file. See the documentation for details [2].

- The `FTPHost` class got a `keep_alive` method. It should be used
  carefully though, not routinely. Please read the description [3] in
  the documentation.

- Several bugs were fixed [4-7].

- The source code was restructured. The tests are now in a `test`
  subdirectory and are no longer part of the release archive. You can
  still get them via the source repository. Licensing matters have
  been moved to a common `LICENSE` file.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

[1] http://codespeak.net/pipermail/ftputil/2009q1/000256.html
[2] http://ftputil.sschwarzer.net/trac/wiki/Documentation#uploading-and-downloading-files
[3] http://ftputil.sschwarzer.net/trac/wiki/Documentation#keep-alive
[4] http://ftputil.sschwarzer.net/trac/ticket/44
[5] http://ftputil.sschwarzer.net/trac/ticket/46
[6] http://ftputil.sschwarzer.net/trac/ticket/47
[7] http://ftputil.sschwarzer.net/trac/ticket/51

Stefan

----------------------------------------------------------------------
ftputil 2.4.2 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.4.1
---------------------------

- Some FTP servers seem to have problems using *any* directory
  argument which contains slashes. The new default for FTP commands
  now is to change into the directory before actually invoking the
  command on a relative path (report and fix suggestion by Nicola
  Murino).

- Calling the method ``FTPHost.stat_cache.resize`` with an argument 0
  caused an exception. This has been fixed; a zero cache size now
  of course doesn't cache anything but doesn't lead to a traceback
  either.

- The installation script ``setup.py`` didn't work with the ``--home``
  option because it still tried to install the documentation in a
  system directory (report by Albrecht Mühlenschulte).

  As a side effect, when using the *global* installation, the
  documentation is no longer installed in the ftputil package
  directory but in a subdirectory ``doc`` of a directory determined by
  Distutils. For example, on my system (Ubuntu 9.04) the documentation
  files are put into ``/usr/local/doc``.

Upgrading is recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.4.1 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.4
-------------------------

Several bugs were fixed:

- On Windows, some accesses to the stat cache caused it to become
  inconsistent, which could also trigger exceptions (report and patch
  by Peter Stirling).

- In ftputil 2.4, the use of ``super`` in the exception base class
  caused ftputil to fail on Python <2.5 (reported by Nicola Murino).
  ftputil is supposed to run with Python 2.3+.

- The conversion of 12-hour clock times to 24-hour clock in the MS
  format parser was wrong for 12 AM and 12 PM.

Upgrading is strongly recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.4 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.3
-------------------------

The ``FTPHost`` class got a new method ``chmod``, similar to
``os.chmod``, to act on remote files. Thanks go to Tom Parker for
the review.

There's a new exception ``CommandNotImplementedError``, derived from
``PermanentError``, to denote commands not implemented by the FTP
server or disabled by its administrator.

Using the ``xreadlines`` method of FTP file objects causes a warning
through Python's warnings framework.

Upgrading is recommended.

Incompatibility notice
----------------------

The ``xreadlines`` method will be removed in ftputil *2.5* as well as
the direct access of exception classes via the ftputil module (e. g.
``ftputil.PermanentError``). However, the deprecated access causes no
warning because that would be rather difficult to implement.

The distribution contains a small tool find_deprecated_code.py to scan
a directory tree for the deprecated uses. Invoke the program with the
``--help`` option to see a description.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.3 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.2.4
---------------------------

ftputil has got support for the ``with`` statement which was introduced
by Python 2.5. You can now construct host and remote file objects in
``with`` statements and have them closed automatically (contributed
by Roger Demetrescu). See the documentation for examples.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.2.4 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.2.3
---------------------------

This release fixes a bug in the ``makedirs`` call (report and fix by
Richard Holden). Upgrading is recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.2.3 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.2.2
---------------------------

This release fixes a bug in the ``makedirs`` call (report and fix by
Julian, whose last name I don't know ;-) ). Upgrading is recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.2.2 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.2.1
---------------------------

This bugfix release handles whitespace in path names more reliably
(thanks to Johannes Strömberg). Upgrading is recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.2.1 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.2
-------------------------

This bugfix release checks (and ignores) status code 451 when FTPFiles
are closed (thanks go to Alexander Holyapin). Upgrading is recommended.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

Read the documentation at
http://ftputil.sschwarzer.net/trac/wiki/Documentation .

License
-------

ftputil is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.2 is now available from
http://ftputil.sschwarzer.net/download .

Changes since version 2.1
-------------------------

- Results of stat calls (also indirect calls, i. e. listdir,
  isdir/isfile/islink, exists, getmtime etc.) are now cached and
  reused. This results in remarkable speedups for many use cases.
  Thanks to Evan Prodromou for his permission to add his lrucache
  module under ftputil's license.

- The current directory is also locally cached, resulting in further
  speedups.

- It's now possible to write and plug in custom parsers for directory
  formats which ftputil doesn't support natively.

- File-like objects generated via ``FTPHost.file`` now support the
  iterator protocol (for line in some_file: ...).

- The documentation has been updated accordingly. Read it under
  http://ftputil.sschwarzer.net/trac/wiki/Documentation .

Possible incompatibilities:

- This release requires at least Python 2.3. (Previous releases
  worked with Python versions from 2.1 up.)

- The method ``FTPHost.set_directory_format`` has been removed,
  since the directory format (Unix or MS) is set automatically. (The
  new method ``set_parser`` is a different animal since it takes
  a parser object to parse "foreign" formats, not a string.)

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

License
-------

ftputil 2.2 is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
The second beta version of ftputil 2.2 is available. You can download
it from http://ftputil.sschwarzer.net/download .

With respect to the first beta release, it's now possible to write
and plug in custom parsers for FTP directory formats that ftputil
doesn't know natively. The documentation has been updated accordingly.

The documentation for this release is online at
http://ftputil.sschwarzer.net/trac/wiki/Documentation#Documentationforftputil2.2b2 ,
so you can read about the extensions in more detail.

Please download and test the release. Do you miss something which
should be in this release? Are there any bugs?

Stefan

----------------------------------------------------------------------
The first beta version of ftputil 2.2 is available. You can download
it from http://ftputil.sschwarzer.net/download .

With respect to the previous alpha release, the cache now uses the
lrucache module by Evan Prodromou which is bundled with the ftputil
distribution. (Evan also gave his permission to include the module
under ftputil's modified BSD license instead of the Academic License.)
The documentation for the cache and its control have been added to
ftputil.txt / ftputil.html .

File objects generated with FTPHost.file now support the iterator
protocol (for line in some_file: ...).

Please download and test the release. Do you miss something which
should be in this release? Are there any bugs?

Stefan

----------------------------------------------------------------------
Welcome to the first alpha release of ftputil 2.2, ftputil 2.2a1.
Please download it from http://ftputil.sschwarzer.net/download .

This version adds caching of stat results to ftputil. This also
affects indirect calls via FTPHost.path, e. g. methods isfile,
exists, getmtime, getsize. The test script at
http://ftputil.sschwarzer.net/trac/browser/tags/release2_2a1/sandbox/list_dir_test.py
runs about 20 times as fast as before adding caching! :-)

As the "alpha" part implies, this release is not production-ready,
it's even kind of experimental: The caching works but there's no
cache entry expiration yet. (I plan to implement an LRU expiration
strategy or something similar.) Apart from that, the release is
tested as any production release. I suggest using the --prefix
option for installing alpha releases.

That said, it would be helpful if you tested this release and
report your findings. When testing the code, please make sure
that your code uses the ftputil version you intend (alpha vs.
production version), e. g. by setting the PYTHONPATH environment
variable. I'm very interested in the speedups - and any problems
you encounter.

Stefan

----------------------------------------------------------------------
ftputil 2.1.1 is now available from
http://ftputil.sschwarzer.net/download .

This release fixes a bug which happened when a client opened
a large file on the server as a file-like object and read
only a part of it. For details, see
http://ftputil.sschwarzer.net/trac/ticket/17 .

Stefan

----------------------------------------------------------------------
Changes since version 2.0
-------------------------

- Added new methods to the FTPHost class, namely makedirs, walk,
  rmtree.

- The FTP server directory format ("Unix" vs. "Windows") is now set
  automatically (thanks to Andrew Ittner for testing it).

- Border cases like inaccessible login directories and whitespace in
  directory names, are now handled more gracefully (based on input
  from Valeriy Pogrebitskiy, Tommy Sundström and H. Y. Chu).

- The documentation was updated.

- A Russian translation of the documentation (currently slightly
  behind) was contributed by Anton Stepanov. It's also on the website
  at http://ftputil.sschwarzer.net/trac/wiki/RussianDocumentation .

- New website, http://ftputil.sschwarzer.net/ with wiki, issue tracker
  and Subversion repository (thanks to Trac!)

  Please enter not only bugs but also enhancement request into
  the issue tracker!

Possible incompatibilities:

- The exception hierarchy was changed slightly, which might break
  client code. See http://ftputil.sschwarzer.net/trac/changeset/489
  for the change details and the possibly necessary code changes.

- FTPHost.rmdir no longer removes non-empty directories. Use the new
  method FTPHost.rmtree for this.

What is ftputil?
----------------

ftputil is a high-level FTP client library for the Python programming
language. ftputil implements a virtual file system for accessing FTP
servers, that is, it can generate file-like objects for remote files.
The library supports many functions similar to those in the os,
os.path and shutil modules. ftputil has convenience functions for
conditional uploads and downloads, and handles FTP clients and servers
in different timezones.

License
-------

ftputil 2.1 is Open Source software, released under the revised BSD
license (see http://www.opensource.org/licenses/bsd-license.php ).

Stefan

----------------------------------------------------------------------
ftputil 2.0.3 is now available at
http://www.sschwarzer.net/python/python_software.html#ftputil .

This release fixes (for most cases) some problems when logging into an
FTP server with an inaccessible login directory, i. e. `getcwd()`
returns "/some/login/dir" but `chdir("/some/login/dir")` fails.

Thanks go to Valeriy Pogrebitskiy for investigating and reporting
these problems.

Stefan

----------------------------------------------------------------------
Here's ftputil 2.0 !

ftputil is a high-level alternative to Python's ftplib module. With
ftputil, you can access directories and files on remote FTP servers
almost as if they were in your local file system. This includes using
file-like objects representing remote files.

For future releases see
http://www.sschwarzer.net/python/python_software.html
or subscribe to the mailing list at
http://codespeak.net/mailman/listinfo/ftputil

What's new?
-----------

From version 1.1 to 2.0, the following has changed:

- ftputil has been re-organized and is now a Python package (the
  import statement is still the same)

- installation via Python distutils

- stat, upload_if_newer, download_if_newer etc. work correctly if the
  server is in another time zone than the client running ftputil (with
  help from Andrew Ittner); see section "Time zone correction" in the
  documentation

- it's possible to set the directory listing format "manually" (though
  in most cases it's recognized automatically); see section "Stat'ing
  files and directories"

- added a workaround regarding whitespace in directory names (thanks
  to Tommy Sundström and H. Y. Chu)

- extended documentation and converted it to HTML format (now
  generated from reStructured Text)

- several bugfixes

- there's now a mailing list at http://codespeak.net/mailman/listinfo/ftputil
  (thanks to Holger Krekel)

Documentation
-------------

The documentation for ftputil can be found in the file ftputil.txt
(reStructured Text format) or ftputil.html (recommended, generated
from ftputil.txt).

License
-------

ftputil is Open Source Software. It is distributed under a BSD-style
license (see the top of ftputil.py).

Stefan

----------------------------------------------------------------------
ftputil 1.1 is released. You can find it at
http://www.ndh.net/home/sschwarzer/python/python_software.html .

ftputil provides a higher-level interface for FTP sessions than the
ftplib module. FTP servers can be accessed via an interface similar to
os and os.path. Remote files are accessible as file-like objects.

New since version 1.0:

- ftputil now runs under Python 2.1+ (not only 2.2+).
- documentation
- conditional upload/download (depending on local and remote file
  timestamps)
- FTPHost.stat follows links
- a session factory other than the default, ftplib.FTP, can be given
  in the FTPHost constructor; this allows to use classes derived from
  ftplib.FTP (like ftpslib.FTP_TLS from the M2Crypto package)
- several bugfixes (mostly regarding byte count in text mode
  transfers)
- unit test

Stefan
----------------------------------------------------------------------
Hello Pythoneers :)

I would like to announce ftputil.py, a module which provides a
more friendly interface for FTP sessions than the ftplib module.

The FTPHost objects generated from it allow many operations similar
to those of os and os.path. Examples:

  # download some files from the login directory
  import ftputil
  host = ftputil.FTPHost('ftp.domain.com', 'user', 'secret')
  names = host.listdir(host.curdir)
  for name in names:
      if host.path.isreg(name):
          host.download(name, name, 'b')  # remote, local, binary mode

  # make a new directory and copy a remote file into it
  host.mkdir('newdir')
  source = host.file('index.html', 'r')  # file-like object
  target = host.file('newdir/index.html', 'w')  # file-like object
  host.copyfileobj(source, target)  # mimics shutil.copyfileobj
  source.close()
  target.close()

Even host.path.walk works. :-) But slow. ;-)

ftputil.py can be downloaded from
http://www.ndh.net/home/sschwarzer/download/ftputil.py

I would like to get your suggestions and comments. :-)

Stefan


P.S.: Thanks to Pedro Rodriguez for his helpful answer to my question
in comp.lang.python :-)
----------------------------------------------------------------------