Update code to modern python

Author: vemel

.pylintrc

@@ -19,7 +19,7 @@ Full list of [Handsdown](README.md#-handsdown---python-documentation-generator)
     - [PEP 484 - type annotations examples](examples/typed.md#pep-484---type-annotations-examples)
 - [Handsdown](handsdown/index.md#handsdown)
     - [Module](handsdown/module.md#module)
-    - [AST Parser](handsdown/ast_parser/index.md#ast-parser)
+    - [AST Parser.](handsdown/ast_parser/index.md#ast-parser)
         - [Analyzers](handsdown/ast_parser/analyzers/index.md#analyzers)
             - [BaseAnalyzer](handsdown/ast_parser/analyzers/base_analyzer.md#baseanalyzer)
             - [ClassAnalyzer](handsdown/ast_parser/analyzers/class_analyzer.md#classanalyzer)
@@ -38,24 +38,23 @@ Full list of [Handsdown](README.md#-handsdown---python-documentation-generator)
             - [ModuleRecord](handsdown/ast_parser/node_records/module_record.md#modulerecord)
             - [NodeRecord](handsdown/ast_parser/node_records/node_record.md#noderecord)
             - [TextRecord](handsdown/ast_parser/node_records/text_record.md#textrecord)
-        - [Smart AST](handsdown/ast_parser/smart_ast.md#smart-ast)
+        - [Smart Ast](handsdown/ast_parser/smart_ast.md#smart-ast)
         - [Type Defs](handsdown/ast_parser/type_defs.md#type-defs)
-    - [CLI Parser](handsdown/cli_parser.md#cli-parser)
+    - [Cli Parser](handsdown/cli_parser.md#cli-parser)
     - [Generator](handsdown/generator.md#generator)
     - [Loader](handsdown/loader.md#loader)
     - [Main](handsdown/main.md#main)
     - [MDDocument](handsdown/md_document.md#mddocument)
     - [Processors](handsdown/processors/index.md#processors)
-        - [Base Docstring Processor](handsdown/processors/base.md#base-docstring-processor)
-        - [PEP 257 Docstring Processor](handsdown/processors/pep257.md#pep-257-docstring-processor)
-        - [reStructuredText Docstring Processor](handsdown/processors/rst.md#restructuredtext-docstring-processor)
+        - [Base Docstring Processor.](handsdown/processors/base.md#base-docstring-processor)
+        - [PEP 257 Docstring Processor.](handsdown/processors/pep257.md#pep-257-docstring-processor)
+        - [reStructuredText Docstring Processor.](handsdown/processors/rst.md#restructuredtext-docstring-processor)
         - [SectionMap](handsdown/processors/section_map.md#sectionmap)
-        - [Smart Docstring Processor](handsdown/processors/smart.md#smart-docstring-processor)
+        - [Smart](handsdown/processors/smart.md#smart)
     - [Settings](handsdown/settings.md#settings)
     - [Utils](handsdown/utils/index.md#utils)
         - [DocstringFormatter](handsdown/utils/docstring_formatter.md#docstringformatter)
         - [ImportString](handsdown/utils/import_string.md#importstring)
         - [IndentTrimmer](handsdown/utils/indent_trimmer.md#indenttrimmer)
         - [Logger](handsdown/utils/logger.md#logger)
         - [PathFinder](handsdown/utils/path_finder.md#pathfinder)
-    - [Version](handsdown/version.md#version)

docs/MODULES.md

@@ -20,21 +20,22 @@
 
 ```python
 class MyValue():
+    def __init__(*args, **kwargs) -> None:
 ```
 
 ## Typed
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/comment_typed.py#L16)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/comment_typed.py#L18)
 
 ```python
 class Typed():
     def __init__(
         my_bool: bool = one & ~two == 'three' and not -4,
         my_lambda=lambda x, y, *args, **kwargs: x + y,
         my_set: Set = {1, 2, [3, 4], {5: 6}, (7, 8)},
-        _value: Union[List[Text], Text, MyValue] = MyValue('asd', *args, kwarg=123, **extras),
-        _name: Text = 'default',
-    ) -> Dict[Text, MyValue]:
+        _value: Union[List[str], str, MyValue] = MyValue('asd', *args, kwarg=123, **extras),
+        _name: str = 'default',
+    ) -> None:
 ```
 
 #### Attributes
@@ -51,7 +52,7 @@ class Typed():
 
 ```python
 @classmethod
-def classmethod(_my_value: MyValue, *_args: Text, **_kwargs: Any) -> Typed:
+def classmethod(_my_value: MyValue, *_args: str, **_kwargs: Any) -> Typed:
 ```
 
 #### See also
@@ -64,7 +65,7 @@ def classmethod(_my_value: MyValue, *_args: Text, **_kwargs: Any) -> Typed:
 
 ```python
 def func(
-    _list: Tuple[List[Text], ...],
+    _list: Tuple[List[str], ...],
     _my_value_cls: Type[MyValue] = MyValue,
     **_kwargs: None,
 ) -> Any:
@@ -80,7 +81,7 @@ def func(
 
 ```python
 def func_any(
-    _list: Tuple[List[Text], ...],
+    _list: Tuple[List[str], ...],
     _my_value_cls: Any = MyValue,
     **_kwargs: None,
 ) -> Any:

docs/examples/comment_typed.md

@@ -11,11 +11,13 @@
 
 ## Links
 
-[Google Python Style Guide](http://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings)
+[Google Python Style Guide](
+    http://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
+)
 
 ## ClassExample
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L12)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L13)
 
 ```python
 class ClassExample():
@@ -30,10 +32,10 @@ Google-style class example
 
 ### ClassExample().method_example
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L21)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L22)
 
 ```python
-def method_example(text: Text = 'hello') -> int:
+def method_example(text: str = 'hello') -> int:
 ```
 
 Summary line.
@@ -74,7 +76,7 @@ to use the function
 
 ## function_example
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L55)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L56)
 
 ```python
 def function_example(arg1, arg2, arg3=None):
@@ -114,7 +116,7 @@ print result
 
 ## function_with_pep484_type_annotations
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L86)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/google_docstrings.py#L87)
 
 ```python
 def function_with_pep484_type_annotations(param1: int, param2: str) -> bool:

docs/examples/google_docstrings.md

@@ -99,7 +99,7 @@ Changed in version 1.4
 [[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/main_example.py#L27)
 
 ```python
-def hello(name: Text) -> Text:
+def hello(name: str) -> str:
 ```
 
 This is module function and it is added to documentation even if it does

docs/examples/main_example.md

@@ -14,7 +14,7 @@
 
 ## ClassExample
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L12)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L11)
 
 ```python
 class ClassExample():
@@ -43,10 +43,10 @@ This is not a codeblock, test inside tildes rendered as it is
 
 ### ClassExample().method_example
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L35)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L34)
 
 ```python
-def method_example(text: Text = 'hello') -> int:
+def method_example(text: str = 'hello') -> int:
 ```
 
 Summary line.
@@ -87,7 +87,7 @@ Description of return value
 
 ## function_example
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L68)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/pep257_docstrings.py#L67)
 
 ```python
 def function_example(real=0.0, imag=0.0):

docs/examples/pep257_docstrings.md

@@ -30,7 +30,7 @@ class MyValue():
 ```python
 class Typed():
     def __init__(
-        _value: Union[List[Text], Text, MyValue] = MyValue(
+        _value: Union[(List[str], str, MyValue)] = MyValue(
             {
                 'key1': 'value1',
                 'key2': 'value2',
@@ -40,16 +40,16 @@ class Typed():
                 'key6': 'value6',
             },
         ),
-        _name: Text = 'default',
-    ) -> Dict[Text, MyValue]:
+        _name: str = 'default',
+    ) -> Dict[(str, MyValue)]:
 ```
 
 ### Typed().async_method
 
 [[find in source code]](https://github.com/vemel/handsdown/blob/master/examples/typed.py#L38)
 
 ```python
-async def async_method(_value: Text) -> Text:
+async def async_method(_value: str) -> str:
 ```
 
 ### Typed.classmethod
@@ -58,7 +58,7 @@ async def async_method(_value: Text) -> Text:
 
 ```python
 @classmethod
-def classmethod(_my_value: MyValue, *_args: Text, **_kwargs: Any) -> None:
+def classmethod(_my_value: MyValue, *_args: str, **_kwargs: Any) -> None:
 ```
 
 #### See also
@@ -72,7 +72,7 @@ def classmethod(_my_value: MyValue, *_args: Text, **_kwargs: Any) -> None:
 ```python
 @my_deco(key='value')
 def func(
-    _list: Tuple[List[Text], ...],
+    _list: Tuple[(List[str], ...)],
     _my_value_cls: Type[MyValue] = MyValue,
     **_kwargs: None,
 ) -> Any:

docs/examples/typed.md

@@ -4,12 +4,12 @@
 
 Base AST analyzer.
 
-- [Handsdown](../../../README.md#-handsdown---python-documentation-generator) / [Modules](../../../MODULES.md#modules) / [Handsdown](../../index.md#handsdown) / [AST Parser](../index.md#ast-parser) / [Analyzers](index.md#analyzers) / BaseAnalyzer
+- [Handsdown](../../../README.md#-handsdown---python-documentation-generator) / [Modules](../../../MODULES.md#modules) / [Handsdown](../../index.md#handsdown) / [AST Parser.](../index.md#ast-parser) / [Analyzers](index.md#analyzers) / BaseAnalyzer
     - [BaseAnalyzer](#baseanalyzer)
 
 ## BaseAnalyzer
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/base_analyzer.py#L17)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/base_analyzer.py#L9)
 
 ```python
 class BaseAnalyzer(ast.NodeVisitor):

docs/handsdown/ast_parser/analyzers/base_analyzer.md

@@ -4,7 +4,7 @@
 
 AST analyzer for `ast.ClassDef` records.
 
-- [Handsdown](../../../README.md#-handsdown---python-documentation-generator) / [Modules](../../../MODULES.md#modules) / [Handsdown](../../index.md#handsdown) / [AST Parser](../index.md#ast-parser) / [Analyzers](index.md#analyzers) / ClassAnalyzer
+- [Handsdown](../../../README.md#-handsdown---python-documentation-generator) / [Modules](../../../MODULES.md#modules) / [Handsdown](../../index.md#handsdown) / [AST Parser.](../index.md#ast-parser) / [Analyzers](index.md#analyzers) / ClassAnalyzer
     - [ClassAnalyzer](#classanalyzer)
         - [ClassAnalyzer().generic_visit](#classanalyzergeneric_visit)
         - [ClassAnalyzer().visit_Assign](#classanalyzervisit_assign)
@@ -14,7 +14,7 @@ AST analyzer for `ast.ClassDef` records.
 
 ## ClassAnalyzer
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L13)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L11)
 
 ```python
 class ClassAnalyzer(BaseAnalyzer):
@@ -29,10 +29,10 @@ AST analyzer for `ast.ClassDef` records.
 
 ### ClassAnalyzer().generic_visit
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L143)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L138)
 
 ```python
-def generic_visit(_node: ast.AST) -> None:
+def generic_visit(node: ast.AST) -> None:
 ```
 
 Do nothing for unknown `ast.AST` nodes.
@@ -43,7 +43,7 @@ Do nothing for unknown `ast.AST` nodes.
 
 ### ClassAnalyzer().visit_Assign
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L103)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L98)
 
 ```python
 def visit_Assign(node: ast.Assign) -> None:
@@ -75,7 +75,7 @@ class MyClass:
 
 ### ClassAnalyzer().visit_AsyncFunctionDef
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L85)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L80)
 
 ```python
 def visit_AsyncFunctionDef(node: ast.AsyncFunctionDef) -> None:
@@ -87,17 +87,19 @@ Adds new `FunctionRecord` entry to `method_records`.
 
 #### Examples
 
+```python
 class MyClass:
     async def my_method(self, arg):
         return await arg
+```
 
 #### Arguments
 
 - `node` - AST node.
 
 ### ClassAnalyzer().visit_ClassDef
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L26)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L23)
 
 ```python
 def visit_ClassDef(node: ast.ClassDef) -> None:
@@ -124,7 +126,7 @@ def my_func():
 
 ### ClassAnalyzer().visit_FunctionDef
 
-[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L67)
+[[find in source code]](https://github.com/vemel/handsdown/blob/master/handsdown/ast_parser/analyzers/class_analyzer.py#L62)
 
 ```python
 def visit_FunctionDef(node: ast.FunctionDef) -> None:
@@ -136,9 +138,11 @@ Adds new `FunctionRecord` entry to `method_records`.
 
 #### Examples
 
+```python
 class MyClass:
     def my_method(self, arg):
         return arg
+```
 
 #### Arguments