-
Notifications
You must be signed in to change notification settings - Fork 16.4k
Add D400 pydocstyle check - core Airflow only #31297
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
3f1f7d7 to
62dfa88
Compare
uranusjr
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should probably be reworded a bit, the new format is even more wrong.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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.