Changeset 1584:589885ddb72e


Ignore:
Timestamp:
Oct 4, 2014, 7:12:28 PM (7 years ago)
Author:
Stefan Schwarzer <sschwarzer@…>
Branch:
default
Message:
Added announcement for next version, 3.2.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/announcements.txt

    r1537 r1584  
     1ftputil 3.2 is now available from
     2http://ftputil.sschwarzer.net/download .
     3
     4Changes since version 3.1
     5-------------------------
     6
     7- For some platforms (notably Windows) modification datetimes before
     8  the epoch would cause an `OverflowError` [1]. Other platforms could
     9  return negative values. Since the Python documentation for the
     10  `time` module [2] points out that values before the epoch might
     11  cause problems, ftputil now sets the float value for such datetimes
     12  to 0.0.
     13
     14  In theory, this might cause backward compatibility problems, but
     15  it's very unlikely since pre-epoch timestamps in directory listings
     16  should be very rare.
     17
     18- On some platforms, the `time.mktime` implementation could behave
     19  strange and accept invalid date/time values. For example, a day
     20  value of 32 would be accepted and implicitly cause a "wrap" to the
     21  next month. Such invalid values now result in a `ParserError`.
     22
     23- Make error handling more robust where the underlying FTP session
     24  factory (for example, `ftplib.FTP`) uses byte strings for exception
     25  messages. [3]
     26
     27- Improved error handling for directory listings. As just one example,
     28  previously a non-integer value for a day would unintentionally cause
     29  a `ValueError`. Now this causes a `ParserError`.
     30
     31Note that ftputil 3.0 broke backward compatibility with ftputil 2.8
     32and before. The differences are described here:
     33http://ftputil.sschwarzer.net/trac/wiki/WhatsNewInFtputil3.0
     34
     35What is ftputil?
     36----------------
     37
     38ftputil is a high-level FTP client library for the Python programming
     39language. ftputil implements a virtual file system for accessing FTP
     40servers, that is, it can generate file-like objects for remote files.
     41The library supports many functions similar to those in the os,
     42os.path and shutil modules. ftputil has convenience functions for
     43conditional uploads and downloads, and handles FTP clients and servers
     44in different timezones.
     45
     46See the documentation for details:
     47http://ftputil.sschwarzer.net/trac/wiki/Documentation
     48
     49License
     50-------
     51
     52ftputil is open source software, released under the revised BSD
     53license (see http://opensource.org/licenses/BSD-3-Clause ).
     54
     55[1] http://ftputil.sschwarzer.net/trac/ticket/83
     56[2] https://docs.python.org/3/library/time.html
     57[3] http://ftputil.sschwarzer.net/trac/ticket/85
     58
     59Have fun! :-)
     60
     61Stefan
     62
     63----------------------------------------------------------------------
    164ftputil 3.1 is now available from
    265http://ftputil.sschwarzer.net/download .
Note: See TracChangeset for help on using the changeset viewer.