Releases: patrickjuchli/basic-ftp
Releases · patrickjuchli/basic-ftp
4.3.2
4.3.1
- Fixed: When downloading to a local file and an error occurs, only remove it if no data has been downloaded so far.
4.3.0
- Added: More explicit API
uploadFrom
,appendFrom
anddownloadTo
.upload
anddownload
are still available but deprecated. - Added: Handle file downloads and uploads directly by supporting local file paths in
uploadFrom
anddownloadTo
. - Added: Make it easier to resume a download of a partially downloaded file. See documentation of
downloadTo
for more details.
4.2.1
4.2.0
- Added: Support uploading a local directory to any specific remote directory instead of just the working directory.
4.1.0
- Added: Support symbolic links in MLSD listings.
4.0.2
4.0.1
4.0.0
This release contains the following breaking changes:
- Changed: The
permissions
property ofFileInfo
is now undefined if no Unix permissions are present. This is the case if for example the FTP server does not actually run on Unix. Before, permissions would have been set to 000. If permissions are present there is a good chance that a command likeSITE CHMOD
will work for the current server. - Changed: MLSD is now the default directory listing command. If the connected server doesn't support it, the library will continue using the LIST command. This might have an impact on reported permissions for a file. It is possible although rare that a server running on Unix would have reported permissions with LIST but doesn't do so with MLSD.
- Changed: If you've been parsing
date
ofFileInfo
, you might have to consider a new ISO format coming with MLSD listings, e.g.2018-10-25T12:04:59.000Z
. Better yet, use the parsed date directly withmodifiedAt
and only usedate
if it is undefined. Be aware that parsing dates reported by the LIST command is likely unreliable.
Non-breaking changes:
- Added: Support for MLSD directory listing. This is a machine-readable directory listing format that provides modification dates that can be reliably parsed. Listings by the older command LIST have not been designed to be machine-readable and are notoriously hard to parse.
- Added: The property
modifiedAt
of FileInfo may hold a parsed date if the FTP server supports the MLSD command. Note that the propertydate
is not parsed but only a human-readable string coming directly from the original listing response. - Added: New API
sendIgnoringError
to send an FTP command and ignoring a resulting FTP error. Using the boolean flag as the second argument ofsend
has been deprecated. - Added: Sending
OPTS UTF8 ON
when accessing a server.