Changeset 1583:83918d4f5088


Ignore:
Timestamp:
Oct 4, 2014, 7:07:49 PM (7 years ago)
Author:
Stefan Schwarzer <sschwarzer@…>
Branch:
default
Message:
Updated `README.txt` with changes for new release.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/README.txt

    r1552 r1583  
    1616-----------
    1717
    18 Since version 3.0 the following changed:
     18Since version 3.1 the following changed:
    1919
    20 - Added support for `followlinks` parameter in `FTPHost.walk`. [1]
     20- For some platforms (notably Windows) modification datetimes before
     21  the epoch would cause an `OverflowError` [1]. Other platforms could
     22  return negative values. Since the Python documentation for the
     23  `time` module [2] points out that values before the epoch might
     24  cause problems, ftputil now sets the float value for such datetimes
     25  to 0.0.
    2126
    22 - Trying to pickle `FTPHost` and `FTPFile` objects now raises explicit
    23   `TypeError`s to make clear that not being able to pickle these
    24   objects is intentional. [2]
     27  In theory, this might cause backward compatibility problems, but
     28  it's very unlikely since pre-epoch timestamps in directory listings
     29  should be very rare.
    2530
    26 - Improved exception messages for socket errors [3].
     31- On some platforms, the `time.mktime` implementation could behave
     32  strange and accept invalid date/time values. For example, a day
     33  value of 32 would be accepted and implicitly cause a "wrap" to the
     34  next month. Such invalid values now result in a `ParserError`.
    2735
    28 - Fixed handling of server error messages with non-ASCII characters
    29   when running under Python 2.x. [4]
     36- Make error handling more robust where the underlying FTP session
     37  factory (for example, `ftplib.FTP`) uses byte strings for exception
     38  messages. [3]
    3039
    31 - Added a generic "session factory factory" to make creation of
    32   session factories easier for common use cases (encrypted
    33   connections, non-default port, active/passive mode, FTP session
    34   debug level and combination of these). [5] This includes a
    35   workaround for `M2Crypto.ftpslib.FTP_TLS`; this class won't be
    36   usable with ftputil 3.0 and up with just the session factory recipe
    37   described in the documentation. [6]
    38 
    39 - Don't assume time zone differences to always be full hours, but
    40   rather 15-minute units. [8] For example, according to [9], Nepal's
    41   time zone is UTC+05:45.
    42 
    43 - Improved documentation on timeout handling. This includes
    44   information on internal creation of additional FTP connections (for
    45   remote files, including uploads and downloads). This may help
    46   understand better why the `keep_alive` method is limited.
     40- Improved error handling for directory listings. As just one example,
     41  previously a non-integer value for a day would unintentionally cause
     42  a `ValueError`. Now this causes a `ParserError`.
    4743
    4844Note that ftputil 3.0 broke backward compatibility with ftputil 2.8
     
    130126Evan Prodromou <evan@bad.dynu.ca> (lrucache module)
    131127
     128(Also see the file `doc/contributors.txt`.)
     129
    132130Please provide feedback! It's certainly appreciated. :-)
    133131
    134 [1] http://ftputil.sschwarzer.net/trac/ticket/73
    135 [2] http://ftputil.sschwarzer.net/trac/ticket/75
    136 [3] http://ftputil.sschwarzer.net/trac/ticket/76
    137 [4] http://ftputil.sschwarzer.net/trac/ticket/77
    138 [5] http://ftputil.sschwarzer.net/trac/ticket/78
    139 [6] http://ftputil.sschwarzer.net/trac/wiki/Documentation#session-factories
    140 [7] http://ftputil.sschwarzer.net/trac/ticket/79
    141 [8] http://ftputil.sschwarzer.net/trac/ticket/81
    142 [9] http://en.wikipedia.org/wiki/Timezone#List_of_UTC_offsets
     132[1] http://ftputil.sschwarzer.net/trac/ticket/83
     133[2] https://docs.python.org/3/library/time.html
     134[3] http://ftputil.sschwarzer.net/trac/ticket/85
Note: See TracChangeset for help on using the changeset viewer.