docs: fix some code examples

README.md

@@ -55,7 +55,7 @@ class Normaliser(BaseNormaliser):
         # if the input file was compressed, the "path" you recieve here will be decompressed
 
         # a temporary file we write 'normalised' data to, that can be easily diffed/compared
-        normalised = unique_file_in_tempdir(input_filepath=upath, dir=self.tmp_dir)
+        normalised = unique_file_in_tempdir(input_filepath=path, dir=self.tmp_dir)
 
         # some custom code here per-module that writes to 'normalised'
 
@@ -163,14 +163,14 @@ If you're not able to subclass one of the those, you might be able to subclass [
 ```python
 import json
 from pathlib import Path
-from typing import Iterator
+from typing import Iterator, Any
 
 from bleanser.core.modules.extract import ExtractObjectsNormaliser
 
 
 class Normaliser(ExtractObjectsNormaliser):
-    def extract_objects(self, path: Path):
-        data = json.loads(file_path.read_text())
+    def extract_objects(self, path: Path) -> Iterator[Any]:
+        data = json.loads(path.read_text())
         for blob in data:
             yield (blob["id"], blob["href"])
 

src/bleanser/core/main.py

@@ -2,7 +2,7 @@
 from glob import glob as do_glob
 from pathlib import Path
 import os
-from typing import Optional, List, Type
+from typing import Optional, List, Type, cast
 
 from .common import logger, Dry, Move, Remove, Mode
 from .processor import BaseNormaliser, compute_instructions, apply_instructions, bleanser_tmp_directory
@@ -36,15 +36,15 @@ def call_main() -> None:
     def diff(path1: str, path2: Path, *, glob: bool, from_: Optional[int], to: Optional[int], vim: bool, difftool: str) -> None:
         path1_: Path
         if glob:
-            assert path2 is _DEFAULT, path2
+            assert path2 is cast(Path, _DEFAULT), path2
             if to is None:
                 assert from_ is not None
                 to = from_ + 2
             paths = _get_paths(path=path1, from_=from_, to=to, glob=glob)
             assert len(paths) == 2, paths
             [path1_, path2] = paths
         else:
-            assert path2 is not _DEFAULT
+            assert cast(str, path2) is not _DEFAULT
             path1_ = Path(path1)
             path2 = Path(path2)