incubator-airflow/UPDATING.md

# Updating Airflow

This file documents any backwards-incompatible changes in Airflow and
assists people when migrating to a new version.


## Airflow 1.8

### Changes to Behavior

#### New DAGs are paused by default

Previously, new DAGs would be scheduled immediately. To retain the old behavior, add this to airflow.cfg:

```
[core]
dags_are_paused_at_creation = False
```

### Deprecated Features
These features are marked for deprecation. They may still work (and raise a `DeprecationWarning`), but are no longer supported and will be removed entirely in Airflow 2.0

#### Operators no longer accept arbitrary arguments
Previously, `Operator.__init__()` accepted any arguments (either positional `*args` or keyword `**kwargs`) without complaint. Now, invalid arguments will be rejected.
Set dags_are_paused_at_creation's default value to True 2016-03-31 00:32:18 +03:00			`# Updating Airflow`

Deprecate args and *kwargs in BaseOperator BaseOperator silently accepts any arguments. This deprecates the behavior with a warning that says it will be forbidden in Airflow 2.0. This PR also turns on DeprecationWarnings by default, which in turn revealed that inspect.getargspec is deprecated. Here it is replaced by `inspect.signature` (Python 3) or `funcsigs.signature` (Python 2). Lastly, this brought to attention that example_http_operator was passing an illegal argument. 2016-04-05 11:04:55 +03:00			`This file documents any backwards-incompatible changes in Airflow and`
			`assists people when migrating to a new version.`
Set dags_are_paused_at_creation's default value to True 2016-03-31 00:32:18 +03:00

Deprecate args and *kwargs in BaseOperator BaseOperator silently accepts any arguments. This deprecates the behavior with a warning that says it will be forbidden in Airflow 2.0. This PR also turns on DeprecationWarnings by default, which in turn revealed that inspect.getargspec is deprecated. Here it is replaced by `inspect.signature` (Python 3) or `funcsigs.signature` (Python 2). Lastly, this brought to attention that example_http_operator was passing an illegal argument. 2016-04-05 11:04:55 +03:00			`## Airflow 1.8`
Set dags_are_paused_at_creation's default value to True 2016-03-31 00:32:18 +03:00
Deprecate args and *kwargs in BaseOperator BaseOperator silently accepts any arguments. This deprecates the behavior with a warning that says it will be forbidden in Airflow 2.0. This PR also turns on DeprecationWarnings by default, which in turn revealed that inspect.getargspec is deprecated. Here it is replaced by `inspect.signature` (Python 3) or `funcsigs.signature` (Python 2). Lastly, this brought to attention that example_http_operator was passing an illegal argument. 2016-04-05 11:04:55 +03:00			`### Changes to Behavior`

			`#### New DAGs are paused by default`

			`Previously, new DAGs would be scheduled immediately. To retain the old behavior, add this to airflow.cfg:`
Set dags_are_paused_at_creation's default value to True 2016-03-31 00:32:18 +03:00
			```
Deprecate args and *kwargs in BaseOperator BaseOperator silently accepts any arguments. This deprecates the behavior with a warning that says it will be forbidden in Airflow 2.0. This PR also turns on DeprecationWarnings by default, which in turn revealed that inspect.getargspec is deprecated. Here it is replaced by `inspect.signature` (Python 3) or `funcsigs.signature` (Python 2). Lastly, this brought to attention that example_http_operator was passing an illegal argument. 2016-04-05 11:04:55 +03:00			`[core]`
Set dags_are_paused_at_creation's default value to True 2016-03-31 00:32:18 +03:00			`dags_are_paused_at_creation = False`
			```

Deprecate args and *kwargs in BaseOperator BaseOperator silently accepts any arguments. This deprecates the behavior with a warning that says it will be forbidden in Airflow 2.0. This PR also turns on DeprecationWarnings by default, which in turn revealed that inspect.getargspec is deprecated. Here it is replaced by `inspect.signature` (Python 3) or `funcsigs.signature` (Python 2). Lastly, this brought to attention that example_http_operator was passing an illegal argument. 2016-04-05 11:04:55 +03:00			`### Deprecated Features`
			These features are marked for deprecation. They may still work (and raise a `DeprecationWarning`), but are no longer supported and will be removed entirely in Airflow 2.0

			`#### Operators no longer accept arbitrary arguments`
			Previously, `Operator.__init__()` accepted any arguments (either positional `args` or keyword `*kwargs`) without complaint. Now, invalid arguments will be rejected.