refactor(indent)!: Rework indent, aligned indent

indents now use @indent.X style captures, and indent.PROP for properties to set on those captures, as documented in the help.

Captures are:

indent.auto
indent.begin
indent.end
indent.dedent
indent.branch
indent.ignore
indent.align
indent.zero

Properties are:

indent.immediate
indent.start_at_same_line
indent.open_delimiter
indent.close_delimiter
indent.increment
indent.avoid_last_matching_next

Multiple opening delims on one line and multiple closing on a line are collapsed so as not to over indent,

The final line of @indent.align blocks which must in some cases be treated specially to avoid clashing with the next line is treated the same regardless of whether the @indent.align capture actually uses aligned indentation or just normal indentation. The indent.avoid_last_matching_next property controls this.

Adjust python to use these.

List, set, dict and tuple all use @indent.align which permits both hanging and aligned styles.

Finally, try: on it’s own will indent when typing live but make no guaranteeds about whole-file formatting.

Includes lucario387:fix-align-indent

tests/indent/python/aligned_indent_2.py

@@ -0,0 +1,12 @@
+if True:
+    print(1, 2, 3)
+
+if True:
+    print(
+        1,
+        2,
+        3
+    )
+    print(1,
+          2,
+          3)

tests/indent/python/control_flow.py

@@ -26,5 +26,3 @@ while (a > 4 and
     pass
 
 try:
-    pass
-

tests/indent/python/error_state_def.py

@@ -0,0 +1,6 @@
+def foo(a,
+        b,
+        c):
+    pass
+
+def foobar(a,

tests/indent/python/error_state_dict.py

@@ -0,0 +1,6 @@
+
+d = {1:4,
+     2:3,
+     4:5}
+
+d2 = {1:3,

tests/indent/python/error_state_funcall.py

@@ -0,0 +1,5 @@
+
+f(1,2,3,
+  4,5,6)
+
+g(1,2,3,

tests/indent/python/error_state_list.py

@@ -0,0 +1,5 @@
+l = [1,
+     2,
+     3]
+
+l2 = [1,

tests/indent/python/error_state_set.py

@@ -0,0 +1,5 @@
+s = {1,
+     2,
+     3}
+
+s2 = {1,

tests/indent/python/error_state_tuple.py

@@ -0,0 +1,7 @@
+(
+    a,
+    b,
+    c,
+)
+
+(a,

tests/indent/python/error_state_tuple_align.py

@@ -0,0 +1,7 @@
+(
+    a,
+    b,
+    c,
+)
+
+(a,

tests/indent/python/return_dedent.py

@@ -14,3 +14,26 @@ def a():
     return (
         1, 2, 3
     )
+
+def a():
+    return b(
+        1, 2, 3
+    )
+
+def a():
+    return [1, 2, 3]
+
+def a():
+    return {1, 2, 3}
+
+def a():
+    return {
+        "a": 1,
+        "b": 2,
+        "c": 3
+    }
+
+def a():
+    return [
+        a for a in range (1, 3)
+    ]