ftputil 4.0.0 is now available from https://ftputil.sschwarzer.net/download and https://pypi.org/project/ftputil/ Changes since the last stable release 3.4 ----------------------------------------- Backward-incompatible changes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This ftputil version isn't fully backward-compatible with the previous version. The backward-incompatible changes are: - Python 2 is no longer supported. - The minimum supported Python 3 version is 3.6. - By default, time stamps in directory listings coming from the server are now assumed to be in UTC. Previously, listings were assumed to use the local time of the client. [1] Correspondingly, the definition of "time shift" has changed. The time shift is now defined as the time zone used in server listings (say, UTC+02:00) and UTC, in other words, the time shift now is the time zone offset applied in the server listings. In earlier ftputil versions, the time shift was defined as "time used in server listings" minus "local client time." - The flag `use_list_a_option` of `FTPHost` instances is now set to `False` by default. This option was intended to make life easier for users, but turned out to be problematic [2]. - As in `os.makedirs`, `FTPHost.makedirs` now supports the `exist_ok` flag and uses the default of `False`. You can get the behavior of ftputil 3.x by passing `exist_ok=True`. [3] If you need to use Python versions before 3.6, please use the previous stable ftputil version 3.4. Other changes ~~~~~~~~~~~~~ - Functions and methods which used to accept only `str` or `bytes` paths now _also_ accept `PathLike` objects [4, 5]. - Clear the stat cache when setting a new time shift value. [6] - ftputil now officially follows semantic versioning (SemVer) [7]. Actually ftputil has been following semantic versioning since a long time (probably since version 2.0 in 2004), but it was never explicitly guaranteed and new major versions were named x.0 instead of x.0.0 and new minor versions x.y instead of x.y.0. - Internal changes: The tests were moved to pytest. The old mocking approach was replaced by a "scripted session" approach. 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: https://ftputil.sschwarzer.net/trac/wiki/Documentation https://ftputil.sschwarzer.net/trac/wiki/WhatsNewInFtputil4.0.0 License ------- ftputil is open source software, released under the 3-clause BSD license (see https://opensource.org/licenses/BSD-3-Clause ). [1] https://ftputil.sschwarzer.net/trac/ticket/134 [2] https://ftputil.sschwarzer.net/trac/ticket/110 [3] https://ftputil.sschwarzer.net/trac/ticket/117 [4] https://docs.python.org/3/library/os.html#os.PathLike [5] https://ftputil.sschwarzer.net/trac/ticket/119 [6] https://ftputil.sschwarzer.net/trac/ticket/136 [7] https://semver.org/ Best regards, Stefan