Add smaller tweaks & improvements

Author: lagru

src/docstub/_analysis.py

@@ -155,7 +155,7 @@ def __post_init__(self):
             ):
                 raise ValueError("builtin cannot contain import information")
         elif self.import_name is None:
-            raise ValueError("non bultin must at least define an `import_name`")
+            raise ValueError("non builtin must at least define an `import_name`")
 
     def __repr__(self):
         if self.builtin_name:

src/docstub/_docstrings.py

@@ -45,6 +45,8 @@ class Annotation:
 
     def __post_init__(self):
         object.__setattr__(self, "imports", frozenset(self.imports))
+        if "~" in self.value:
+            raise ValueError(f"unexpected '~' in annotation value: {self.value}")
 
     def __str__(self) -> str:
         return self.value

src/docstub/_stubs.py

@@ -149,7 +149,7 @@ def try_format_stub(stub: str) -> str:
     return stub
 
 
-class FuncType(enum.Enum):
+class FuncType(enum.StrEnum):
     MODULE = enum.auto()
     CLASS = enum.auto()
     FUNC = enum.auto()
@@ -526,7 +526,7 @@ def _parse_imports(imports, *, current_module=None):
 
         Parameters
         ----------
-        imports : set[~.DocName]
+        imports : set[~.KnownImport]
         current_module : str, optional
 
         Returns