Python Linting and Code Formatting (#298)

* Create common print_diff function

* Add pylint and black

* Fix linting, move classes to utils

* Add black/pylint to github actions

* Fix linting

* Move Bin and SymInfo into their own files

* Split out format

* Tidy up workdlows and pip, add readme

* Lint tests, add tests to readme

tools/isledecomp/tests/test_parser.py

@@ -1,17 +1,16 @@
 import os
-import pytest
 from typing import List, TextIO
 from isledecomp.parser import find_code_blocks
 from isledecomp.parser.util import CodeBlock
 
-SAMPLE_DIR = os.path.join(os.path.dirname(__file__), 'samples')
+SAMPLE_DIR = os.path.join(os.path.dirname(__file__), "samples")
 
 
 def sample_file(filename: str) -> TextIO:
     """Wrapper for opening the samples from the directory that does not
-       depend on the cwd where we run the test"""
+    depend on the cwd where we run the test"""
     full_path = os.path.join(SAMPLE_DIR, filename)
-    return open(full_path, 'r')
+    return open(full_path, "r", encoding="utf-8")
 
 
 def code_blocks_are_sorted(blocks: List[CodeBlock]) -> bool:
@@ -25,7 +24,7 @@ def code_blocks_are_sorted(blocks: List[CodeBlock]) -> bool:
 
 def test_sanity():
     """Read a very basic file"""
-    with sample_file('basic_file.cpp') as f:
+    with sample_file("basic_file.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 3
@@ -39,7 +38,7 @@ def test_sanity():
 def test_oneline():
     """(Assuming clang-format permits this) This sample has a function
     on a single line. This will test the end-of-function detection"""
-    with sample_file('oneline_function.cpp') as f:
+    with sample_file("oneline_function.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 2
@@ -49,7 +48,7 @@ def test_oneline():
 
 def test_missing_offset():
     """What if the function doesn't have an offset comment?"""
-    with sample_file('missing_offset.cpp') as f:
+    with sample_file("missing_offset.cpp") as f:
         blocks = find_code_blocks(f)
 
     # TODO: For now, the function without the offset will just be ignored.
@@ -60,9 +59,9 @@ def test_missing_offset():
 
 def test_jumbled_case():
     """The parser just reports what it sees. It is the responsibility of
-       the downstream tools to do something about a jumbled file.
-       Just verify that we are reading it correctly."""
-    with sample_file('out_of_order.cpp') as f:
+    the downstream tools to do something about a jumbled file.
+    Just verify that we are reading it correctly."""
+    with sample_file("out_of_order.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 3
@@ -70,7 +69,7 @@ def test_jumbled_case():
 
 
 def test_bad_file():
-    with sample_file('poorly_formatted.cpp') as f:
+    with sample_file("poorly_formatted.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 3
@@ -78,7 +77,7 @@ def test_bad_file():
 
 def test_indented():
     """Offsets for functions inside of a class will probably be indented."""
-    with sample_file('basic_class.cpp') as f:
+    with sample_file("basic_class.cpp") as f:
         blocks = find_code_blocks(f)
 
     # TODO: We don't properly detect the end of these functions
@@ -87,17 +86,17 @@ def test_indented():
     # all the functions that are there.
 
     assert len(blocks) == 2
-    assert blocks[0].offset == int('0x12345678', 16)
+    assert blocks[0].offset == int("0x12345678", 16)
     assert blocks[0].start_line == 15
     # assert blocks[0].end_line == 18
 
-    assert blocks[1].offset == int('0xdeadbeef', 16)
+    assert blocks[1].offset == int("0xdeadbeef", 16)
     assert blocks[1].start_line == 22
     # assert blocks[1].end_line == 24
 
 
 def test_inline():
-    with sample_file('inline.cpp') as f:
+    with sample_file("inline.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 2
@@ -108,21 +107,21 @@ def test_inline():
 
 def test_multiple_offsets():
     """If multiple offset marks appear before for a code block, take them
-       all but ensure module name (case-insensitive) is distinct.
-       Use first module occurrence in case of duplicates."""
-    with sample_file('multiple_offsets.cpp') as f:
+    all but ensure module name (case-insensitive) is distinct.
+    Use first module occurrence in case of duplicates."""
+    with sample_file("multiple_offsets.cpp") as f:
         blocks = find_code_blocks(f)
 
     assert len(blocks) == 4
-    assert blocks[0].module == 'TEST'
+    assert blocks[0].module == "TEST"
     assert blocks[0].start_line == 9
 
-    assert blocks[1].module == 'HELLO'
+    assert blocks[1].module == "HELLO"
     assert blocks[1].start_line == 9
 
     # Duplicate modules are ignored
     assert blocks[2].start_line == 16
     assert blocks[2].offset == 0x2345
 
-    assert blocks[3].module == 'TEST'
+    assert blocks[3].module == "TEST"
     assert blocks[3].offset == 0x2002