apache-airflow-providers-sftp

Changelog¶

5.4.0¶

Release Date: 2025-09-09

Features¶

Feature: add optional managed connection (#52700)
Add file_pattern to template fields (#54562)

Bug Fixes¶

Fix sftp async hoook (#54763)

5.3.4¶

Release Date: 2025-08-11

Bug Fixes¶

Fix missing prefetch arg to SFTPOperator (#53906)

Misc¶

Limit paramiko to '< 4.0.0' till we remove DSS support (#54078)

5.3.3¶

Release Date: 2025-08-02

Bug Fixes¶

Updating SSH dependency for SFTP provider (#53100)
Fix BlobWriter (GCS) support for SFTP Streaming (#52850)

Misc¶

Add Python 3.13 support for Airflow. (#46891)
Cleanup type ignores in sftp provider where possible (#53266)
Remove type ignore across codebase after mypy upgrade (#53243)
Remove upper-binding for "python-requires" (#52980)
Temporarily switch to use >=,< pattern instead of '~=' (#52967)
Move all BaseHook usages to version_compat in SFTP (#52894)

Doc-only¶

docs: Correct TaskFlow capitalization in documentation (#51794)

5.3.2¶

Release Date: 2025-07-06

Bug Fixes¶

bugfix: removed cache for proxycommand in SFTPHook (#52641)

Misc¶

Move 'BaseHook' implementation to task SDK (#51873)
Replace 'models.BaseOperator' to Task SDK one for SFTP (#52435)
Drop support for Python 3.9 (#52072)
Use BaseSensorOperator from task sdk in providers (#52296)

5.3.1¶

Release Date: 2025-06-18

Bug Fixes¶

Updating SFTPSensor to properly handle scenario where file is missing (#51167)

5.3.0¶

Release Date: 2025-05-18

Note

This release of provider is only available for Airflow 2.10+ as explained in the Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.

Misc¶

Remove AIRFLOW_2_10_PLUS conditions (#49877)
Bump min Airflow version in providers to 2.10 (#49843)

5.2.1¶

Release Date: 2025-04-19

Misc¶

remove superfluous else block (#49199)

5.2.0¶

Release Date: 2025-04-14

Features¶

Implement concurrent directory transfer in SFTPOperator (#47533)

Misc¶

Make '@task' import from airflow.sdk (#48896)

5.1.2¶

Release Date: 2025-04-09

Bug Fixes¶

Checking modification timestamps only when newer_than parameter is present (#48063)

5.1.1¶

Release Date: 2025-03-13

Bug Fixes¶

Re-added close_conn connection on SFTPHook and get_conn should return SFTPClient instead of context managed connection (#47217)

Misc¶

Change get_conn to get_managed_conn in direcotry transfer (#47248)
Improve SFTP hook's directory transfer to use a single connection for multiple files (#46582)
Upgrade flit to 3.11.0 (#46938)

5.1.0¶

Release Date: 2025-02-26

Features¶

Add DELETE operation in SFTPOperator (#46233)
Also allow passing buffer instead of path for retrieve_file and store_file methods in SFTPHook (#44247)
Add directory transfer support for SFTPOperator (#44126)

Bug Fixes¶

Make sure the SSHClient is also closed when using connection in context manager from SFTPHook (#46716)

Misc¶

AIP-72: Support better type-hinting for Context dict in SDK (#45583)

5.0.0¶

Release Date: 2024-12-26

Note

This release of provider is only available for Airflow 2.9+ as explained in the Apache Airflow providers support policy.

Breaking changes¶

Warning

All deprecated classes, parameters and features have been removed from the sftp provider package. The following breaking changes were introduced:

Removed deprecated ssh_hook parameter from SFTPOperator. Use sftp_hook instead.
Removed deprecated ssh_hook parameter from SFTPHook.
Removed deprecated ftp_conn_id parameter from SFTPHook. Use ssh_conn_id instead.

Remove deprecations from SFTP Provider (#44740)

Features¶

feat: retrieve sftp file attrs once instead multiple time (#44625)
Add host_proxy_cmd parameter to SSHHook and SFTPHook (#44565)

Misc¶

Bump minimum Airflow version in providers to Airflow 2.9.0 (#44956)

4.11.1¶

Release Date: 2024-09-24

Misc¶

remove deprecated soft_fail from providers (#41710)

4.11.0¶

Release Date: 2024-08-22

Note

This release of provider is only available for Airflow 2.8+ as explained in the Apache Airflow providers support policy.

Misc¶

Bump minimum Airflow version in providers to Airflow 2.8.0 (#41396)

4.10.3¶

Release Date: 2024-08-06

Misc¶

openlineage: migrate OpenLineage provider to V2 facets. (#39530)

4.10.2¶

Release Date: 2024-06-27

Bug Fixes¶

Fix resource management in SFTPSensor (#40022)

Misc¶

implement per-provider tests with lowest-direct dependency resolution (#39946)

4.10.1¶

Release Date: 2024-05-30

Bug Fixes¶

Fix SFTPSensor.newer_than not working with jinja logical ds/ts expression (#39056)

Misc¶

Faster 'airflow_version' imports (#39552)
Simplify 'airflow_version' imports (#39497)

4.10.0¶

Release Date: 2024-05-06

Note

This release of provider is only available for Airflow 2.7+ as explained in the Apache Airflow providers support policy.

Misc¶

Bump minimum Airflow version in providers to Airflow 2.7.0 (#39240)

4.9.1¶

Release Date: 2024-04-13

Bug Fixes¶

fix(sftp): add return statement to yield within a while loop in triggers (#38391)
Close open connections for deferrable SFTPSensor (#38881)

4.9.0¶

Release Date: 2024-02-15

Features¶

Add deferrable param in SFTPSensor (#37117)

4.8.1¶

Release Date: 2023-12-27

Bug Fixes¶

change warning message (#36148)
Follow BaseHook connection fields method signature in child classes (#36086)

Misc¶

Add code snippet formatting in docstrings via Ruff (#36262)

4.8.0¶

Release Date: 2023-12-12

Note

This release of provider is only available for Airflow 2.6+ as explained in the Apache Airflow providers support policy.

Misc¶

Bump minimum Airflow version in providers to Airflow 2.6.0 (#36017)

4.7.0¶

Release Date: 2023-10-17

Note

This release of provider is only available for Airflow 2.5+ as explained in the Apache Airflow providers support policy.

Misc¶

Bump min airflow version of providers (#34728)

4.6.1¶

Release Date: 2023-09-12

Bug Fixes¶

fix(providers/sftp): respect soft_fail argument when exception is raised (#34169)

Misc¶

Improve modules import in Airflow providers by some of them into a type-checking block (#33754)

4.6.0¶

Release Date: 2023-08-29

Features¶

Add parameter sftp_prefetch to SFTPToGCSOperator (#33274)

Misc¶

Refactor: Remove useless str() calls (#33629)

4.5.0¶

Release Date: 2023-08-01

Features¶

openlineage, sftp: add OpenLineage support for sftp provider (#31360)

4.4.0¶

Release Date: 2023-07-16

Features¶

Adds sftp_sensor decorator (#32457)

4.3.1¶

Release Date: 2023-06-23

Note

This release dropped support for Python 3.7

Misc¶

Add note about dropping Python 3.7 for providers (#32015)

4.3.0¶

Release Date: 2023-05-22

Note

This release of provider is only available for Airflow 2.4+ as explained in the Apache Airflow providers support policy.

Misc¶

Bump minimum Airflow version in providers (#30917)

4.2.4¶

Release Date: 2023-03-06

Bug Fixes¶

Fix SFTPSensor when using newer_than and there are multiple matched files (#29794)

4.2.3¶

Release Date: 2023-02-21

Bug Fixes¶

Fix sftp sensor with pattern (#29467)

4.2.2¶

Release Date: 2023-02-11

Bug Fixes¶

Fix SFTP operator's template fields processing (#29068)
FTP operator has logic in __init__ (#29073)

4.2.1¶

Release Date: 2023-01-05

Misc¶

Update codespell and fix typos (#28568)
[misc] Get rid of 'pass' statement in conditions (#27775)

4.2.0¶

Release Date: 2022-11-18

Note

This release of provider is only available for Airflow 2.3+ as explained in the Apache Airflow providers support policy.

Misc¶

Move min airflow version to 2.3.0 for all providers (#27196)

Bug Fixes¶

SFTP Provider: Fix default folder permissions (#26593)

4.1.0¶

Release Date: 2022-10-01

Features¶

SFTPOperator - add support for list of file paths (#26666)

4.0.0¶

Release Date: 2022-07-20

Breaking changes¶

Convert sftp hook to use paramiko instead of pysftp (#24512)

Features¶

Update 'actual_file_to_check' with rendered 'path' (#24451)

3.0.0¶

Release Date: 2022-06-13

Breaking changes¶

Note

This release of provider is only available for Airflow 2.2+ as explained in the Apache Airflow providers support policy.

Features¶

Adding fnmatch type regex to SFTPSensor (#24084)

2.6.0¶

Release Date: 2022-04-11

Features¶

add newer_than parameter to SFTP sensor (#21655) (#22377)

2.5.2¶

Release Date: 2022-03-26

Bug Fixes¶

Fix mistakenly added install_requires for all providers (#22382)

2.5.1¶

Release Date: 2022-03-19

Misc¶

Add Trove classifiers in PyPI (Framework :: Apache Airflow :: Provider)

2.5.0¶

Release Date: 2022-03-10

Features¶

Updates FTPHook provider to have test_connection (#21997)

Misc¶

Support for Python 3.10
Add optional features in providers. (#21074)

2.4.1¶

Release Date: 2022-01-12

Bug Fixes¶

Bugfix: ''SFTPHook'' does not respect ''ssh_conn_id'' arg (#20756)
fix deprecation messages for SFTPHook (#20692)

2.4.0 (YANKED)¶

Warning

This release has been yanked with a reason: Breaking change found with ssh_conn_id

Features¶

Making SFTPHook's constructor consistent with its superclass SSHHook (#20164)

2.3.0¶

Release Date: 2021-12-06

Features¶

Add test_connection method for sftp hook (#19609)

2.2.0¶

Release Date: 2021-11-04

Features¶

SFTP hook to prefer the SSH paramiko key over the key file path (#18988)

2.1.1¶

Release Date: 2021-09-03

Misc¶

Optimise connection importing for Airflow 2.2.0

2.1.0¶

Release Date: 2021-08-02

Features¶

Add support for non-RSA type key for SFTP hook (#16314)

2.0.0¶

Release Date: 2021-06-23

Breaking changes¶

Auto-apply apply_default decorator (#15667)

Warning

Due to apply_default decorator removal, this version of the provider requires Airflow 2.1.0+. If your Airflow version is < 2.1.0, and you want to install this provider version, first upgrade Airflow to at least version 2.1.0. Otherwise your Airflow package version will be upgraded automatically and you will have to manually run airflow upgrade db to complete the migration.

Features¶

Depreciate private_key_pass in SFTPHook conn extra and rename to private_key_passphrase (#14028)

1.2.0¶

Release Date: 2021-05-06

Features¶

Undeprecate private_key option in SFTPHook (#15348)
Add logs to show last modified in SFTP, FTP and Filesystem sensor (#15134)

1.1.1¶

Release Date: 2021-03-07

Features¶

SFTPHook private_key_pass extra param is deprecated and renamed to private_key_passphrase, for consistency with arguments' naming in SSHHook

Bug fixes¶

Corrections in docs and tools after releasing provider RCs (#14082)

1.1.0¶

Release Date: 2021-02-08

Updated documentation and readme files.

Features¶

Add retryer to SFTP hook connection (#13065)

1.0.0¶

Release Date: 2020-12-14

Initial version of the provider.