Add better VSCode support. Fix several warnings and some documentation.

Author: HexDecimal

.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+    "editor.rulers": [
+        79,
+        120
+    ],
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+        "source.organizeImports": true
+    },
+    "python.linting.enabled": true,
+    "python.linting.flake8Enabled": true,
+    "python.linting.mypyEnabled": true,
+    "python.linting.mypyArgs": [
+        "--ignore-missing-imports",
+        "--follow-imports=silent",
+        "--show-column-numbers"
+    ],
+    "python.formatting.provider": "black"
+}

examples/cavegen.py

@@ -6,11 +6,11 @@
 This will print the result to the console, so be sure to run this from the
 command line.
 """
-import numpy as np  # type: ignore
-import scipy.signal  # type: ignore
+import numpy as np
+import scipy.signal
 
 
-def convolve(tiles: np.array, wall_rule: int = 5) -> np.array:
+def convolve(tiles: np.ndarray, wall_rule: int = 5) -> np.ndarray:
     """Return the next step of the cave generation algorithm.
 
     `tiles` is the input array. (0: wall, 1: floor)
@@ -25,7 +25,7 @@ def convolve(tiles: np.array, wall_rule: int = 5) -> np.array:
     return neighbors < wall_rule  # Apply the wall rule.
 
 
-def show(tiles: np.array) -> None:
+def show(tiles: np.ndarray) -> None:
     """Print out the tiles of an array."""
     for line in tiles:
         print("".join("# "[int(cell)] for cell in line))

examples/framerate.py

@@ -8,7 +8,7 @@
 import statistics
 import time
 from collections import deque
-from typing import Deque, List, Optional, Tuple
+from typing import Deque, Optional
 
 import tcod
 

tcod/console.py

@@ -1257,8 +1257,8 @@ def load_xp(
 
     Example::
 
+        import numpy as np
         import tcod
-        from numpy import np
 
         path = "example.xp"  # REXPaint file with one layer.
 
@@ -1311,8 +1311,8 @@ def save_xp(
 
     Example::
 
+        import numpy as np
         import tcod
-        from numpy import np
 
         console = tcod.Console(80, 24)  # Example console.