Metadata-Version: 2.1
Name: flake8-balanced-wrapping
Version: 0.1.0
Summary: A flake8 plugin that helps you wrap code with visual balance.
Home-page: https://github.com/PeterJCLaw/flake8-balanced-wrapping
Author: Peter Law
Author-email: PeterJCLaw@gmail.com
License: Apache 2.0
Project-URL: Issue tracker, https://github.com/PeterJCLaw/flake8-balanced-wrapping/issues
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown
License-File: LICENSE

# flake8-balanced-wrapping

[![CircleCI](https://circleci.com/gh/PeterJCLaw/flake8-balanced-wrapping/tree/main.svg?style=svg)](https://circleci.com/gh/PeterJCLaw/flake8-balanced-wrapping/tree/main)

A flake8 plugin that helps you wrap code with visual balance.

The aim of this tool is to build up developer-assistance tooling for python
formatting. In general it will only format things when it needs to or when
directly instructed to.

## Style

The style which this linter checks for is one which aims for clarity and visual
balance while reducing diff noise, without concern for vertical space. This is
similar to the [`tuck`](https://pypi.org/project/tuck/) wrapping tool.

As much as possible this linter will not duplicate checks provided by other
plugins where they are are in agreement.

**Example**: Function definitions


``` python
# Unwrapped
def foo(bar: str, quox: int = 0) -> float:
    return 4.2

# Wrapped
def foo(
    bar: str,
    quox: int = 0,
) -> float:
    return 4.2
```

**Example**: List comprehension

``` python
# Unwrapped
[x for x in 'aBcD' if x.isupper()]

# Wrapped
[
    x
    for x in 'aBcD'
    if x.isupper()
]
```


