Skip to content
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

Enable black, isort, and doc formatters and checks #774

Merged
merged 57 commits into from
Jul 12, 2024

Conversation

bpkroth
Copy link
Contributor

@bpkroth bpkroth commented Jul 3, 2024

Follow on work to #766.

This enabled both formatters and applies their changes to the repo.

Additionally, since black does not make changes to comments nor docstrings, we also enable docformatter to reformat docstrings which better aligns with pydocstyle rules as well.
Without this additional change (and some manual fixups), pycodestyle and pylint would still complain about line lengths, for instance.

Finally, we make a minor adjustment to the max line length setting it to 99 (which is also accepted and mentioned in pep8) instead of 88 to avoid some comment (especially linter overrides) wrapping.

bpkroth added 30 commits July 3, 2024 21:05
This reverts commit 1b9843a.
…but still within the pep8 guidelines"

This reverts commit 857d694.
1. Temporarily avoid recent asyncssh version that breaks the tests
2. Workaround pylance issue with pyproject.toml related changes and pip
editable modules install format (microsoft#768)
   See Also:
   - microsoft/pylance-release#3473
   May also affect `mypy`:
   - python/mypy#16988
   - python/mypy#12313
@bpkroth bpkroth force-pushed the enable-black-isort-reformatting branch from 2ec2f39 to b17696b Compare July 10, 2024 21:00
@bpkroth bpkroth changed the title Enable black and isort formatters and checks Enable black, isort, and doc formatters and checks Jul 10, 2024
@bpkroth bpkroth marked this pull request as ready for review July 10, 2024 21:51
@bpkroth bpkroth requested a review from a team as a code owner July 10, 2024 21:51
@bpkroth bpkroth enabled auto-merge (squash) July 12, 2024 19:14
@bpkroth bpkroth merged commit e40ac28 into microsoft:main Jul 12, 2024
12 checks passed
@bpkroth bpkroth deleted the enable-black-isort-reformatting branch July 12, 2024 19:56
bpkroth added a commit that referenced this pull request Jul 15, 2024
Follow-on work to #774, this PR uses a [`.git-blame-ignore-revs`
file](https://docs.github.com/en/repositories/working-with-files/using-files/viewing-a-file#ignore-commits-in-the-blame-view)
to ignore revs that cause major reformatting changes in git blame view.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants