nixsearch / pkg / python311Packages.yapf

python311Packages.yapf

Yet Another Python Formatter

Apache-2.0 github.com python311Packages.yapf 3 releases newest changed 22 months ago

version0.40.2 attributepython311Packages.yapf rev566e53c2ad750c84f6d31f9ccb9d00f823165550 2024-12-03 · one commit for every system systems✓ aarch64-darwin✓ aarch64-linux✓ x86_64-darwin✓ x86_64-linux

$ devbox add python311Packages.yapf@0.40.2

$ nix shell github:NixOS/nixpkgs/566e53c2ad750c84f6d31f9ccb9d00f823165550#python311Packages.yapf

JSON: /v2/resolve?name=python311Packages.yapf&version=latest

Releases

newest first, as /v2/pkg orders them

Version	arm mac	arm linux	x86 mac	x86 linux	Attribute	Commit	Date	Outputs
0.40.2resolved	✓	✓	✓	✓	`python311Packages.yapf`	566e53c2ad	2024-12-03	out, dist
0.40.1	✓	✓	✓	✓	`python311Packages.yapf`	fd04bea4cb	2023-12-13	out, dist
0.32.0	✓	✓	✓	✓	`python311Packages.yapf`	29bcead840	2023-07-15	out, dist

Prereleases are listed but latest never picks one. “varies” means each system last changed at a different nixpkgs commit — the release page lists them.

Description

Most of the current formatters for Python --- e.g., autopep8, and pep8ify --- are made to remove lint errors from code. This has some obvious limitations. For instance, code that conforms to the PEP 8 guidelines may not be reformatted. But it doesn't mean that the code looks good. YAPF takes a different approach. It's based off of 'clang-format', developed by Daniel Jasper. In essence, the algorithm takes the code and reformats it to the best formatting that conforms to the style guide, even if the original code didn't violate the style guide. The idea is also similar to the 'gofmt' tool for the Go programming language: end all holy wars about formatting - if the whole codebase of a project is simply piped through YAPF whenever modifications are made, the style remains consistent throughout the project and there's no point arguing about style in every code review. The ultimate goal is that the code YAPF produces is as good as the code that a programmer would write if they were following the style guide. It takes away some of the drudgery of maintaining your code.