Add D400 pydocstyle check - core Airflow only#31297
Conversation
3f1f7d7 to
62dfa88
Compare
uranusjr
left a comment
There was a problem hiding this comment.
Nice! Just a few things I think would be best addressed in this PR. I have some other quasi-related improvements locally that can be submitted separately after this one is merged.
airflow/utils/sqlalchemy.py
Outdated
| Almost equivalent to :class:`~sqlalchemy.types.TIMESTAMP` with | ||
| ``timezone=True`` option, but it differs from that by: | ||
|
|
||
| - Never silently take naive :class:`~datetime.datetime`, instead it | ||
| always raise :exc:`ValueError` unless time zone aware value. | ||
| - :class:`~datetime.datetime` value's :attr:`~datetime.datetime.tzinfo` | ||
| is always converted to UTC. | ||
| - Unlike SQLAlchemy's built-in :class:`~sqlalchemy.types.TIMESTAMP`, | ||
| it never return naive :class:`~datetime.datetime`, but time zone | ||
| aware value, even with SQLite or MySQL. | ||
| - Always returns TIMESTAMP in UTC | ||
| - Always returns TIMESTAMP in UTC. | ||
|
|
There was a problem hiding this comment.
This should probably be reworded a bit, the new format is even more wrong.
There was a problem hiding this comment.
To be honest I dont understand the previous 2 level lists. To me the new format makes more sense but I must miss something
Co-authored-by: Tzu-ping Chung <uranusjr@gmail.com>
Co-authored-by: Tzu-ping Chung <uranusjr@gmail.com>
Thanks for the review! I applied all your suggestion but one :) See my comment |
This PR is a follow up of #31135. It had been decided to split #31135 in multiple PRs to make it easier to review. This PR's scope is core Airflow only.
Part of #10742.
^ Add meaningful description above
Read the Pull Request Guidelines for more information.
In case of fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in a newsfragment file, named
{pr_number}.significant.rstor{issue_number}.significant.rst, in newsfragments.