Skip to content

0.16.0 (2026-05-12)

Breaking Changes

New .Extra classes for file connectors

#484 #485 #486 #487 #488 #489

Now all FileConnection classes have .Extra classes like this:

  • FTP.Extra(encoding=, use_passive_mode=, ...)
  • FTPS.Extra(encoding=, use_passive_mode=, ...)
  • HDFS.Extra(timeout=, retry=)
  • S3.Extra(timeout=, retry=, ssl_verify=, ...)
  • Samba.Extra(connection_timeout=, ...)
  • SFTP.Extra(timeout=, host_key_check=, ...)
  • WebDAV.Extra(timeout=, retry=, ssl_verify=, ...)

These new classes allow passing additional params directly to underlying clients: 

HDFS(
  ...,
  extra=HDFS.Extra(timeout=..., retry=...),
)

Previously some FileConnection classes defined parameters directly in the constructor, e.g.:

  • HDFS(timeout=..., retry=...)
  • S3(ssl_verify=...)
  • SFTP(timeout=..., host_key_check=..., compress=...)
  • WebDAV(ssl_verify=...)

This is now deprecated.

Allow passing timeouts to file connectors

#476

Now developers can pass timeout options directly to underlying client. This is a bit different for each connectors - some accept urllib3.Timeout object (HDFS, S3, WebDAV), some have explicit attributes for each timeout type (SFTP, Samba).

Thanks to @NaxNax666!

Allow passing retries for file connectors

#476

Now developers can pass retry option directly to underlying client of HDFS, S3 and WebDAV connectors, overriding default values.

Thanks to @NaxNax666!

Change default encoding for FTP & FTPS

#488

Previously these connectors used operation system encoding (e.g. cp1252 on Windows), now its utf-8 by default.

Dependencies

Update JDBC connections:

  • MongoDB 10.5.0 → 10.6.1
  • MySQL 9.5.0 → 9.7.0
  • MSSQL 13.2.1 → 13.4.0
  • Oracle 23.26.0.0.0 → 23.26.1.0.0
  • Postgres 42.7.8 → 42.7.11

Documentation

#455 #466 #473 #474 #479 #480

Switched from sphinx documentation to mkdocs. This implies new docstring style & theming.

Thanks to @wm-wm-wm and @annamikhailovapsk!