Document try complexity computation

[HarrySky]

Hi, thanks for this great tool 😄 I was scratching my head when adding/removing any lines from try block was influencing cognitive complexity and searched in your documentation and then code why is that and found this line in code:

cognitive_complexity/cognitive_complexity/utils/ast.py

Line 40 in 1df07df

# add +1 for all try nodes except body

It means that any line added inside try block will increment complexity (code below gives complexity 4)

def a(b, c):
    try:
        print(1)
        print(2)
        print(3)
        print(4)
    except Exception:
        raise

This behavior is unexpected as it was not mentioned in SonarSource links provided, can we document it here or in flake8 extension? Thanks

[AndersSteenNilsen]

This is not a documentation fault but a bug.
I think I fixed the issue.

def a(b, c):
    try:
        print(1)
        print(2)
        print(3)
        print(4)
    except Exception:  # +1 (nesting 0)
        raise                  # +0 (nesting 1)