Add type annotations (#50)

Closes #42

.github/workflows/ci.yml

@@ -27,5 +27,5 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4
         with:
-          python-version: "3.11"
+          python-version: "3.x"
       - run: pipx run nox -s lint

.vscode/settings.json

@@ -9,5 +9,5 @@
     },
     "[toml]": {
         "editor.defaultFormatter": "tamasfe.even-better-toml"
-    },
+    }
 }

microvenv/__init__.py

@@ -2,8 +2,6 @@
 import pathlib
 import sys
 
-from . import _create
-
 # Exported as part of the public API.
 from ._create import create as create
 

microvenv/__init__.pyi

@@ -0,0 +1,12 @@
+from os import PathLike
+from typing import TypedDict
+
+IN_VIRTUAL_ENV: bool
+
+def parse_config(env_dir: str | PathLike[str]) -> dict[str, str]: ...
+
+class _ActivationEnvVars(TypedDict):
+    PATH: str
+    VIRTUAL_ENV: str
+
+def activation(env_vars: dict[str, str] = ...) -> _ActivationEnvVars: ...

microvenv/_create.pyi

@@ -0,0 +1,7 @@
+from os import PathLike
+from typing import Iterable
+
+def create(
+    env_dir: str | PathLike[str] = ..., *, scm_ignore_files=Iterable[str]
+) -> None: ...
+def main() -> None: ...

noxfile.py

@@ -12,3 +12,4 @@ def lint(session):
     session.install(".[lint]")
     session.run("ruff", "check", ".")
     session.run("black", "--check", ".")
+    session.run("mypy", ".")

pyproject.toml

@@ -22,17 +22,16 @@ classifiers = [
   "Natural Language :: English",
   "Operating System :: MacOS :: MacOS X",
   "Operating System :: POSIX",
-  "Programming Language :: Python :: 3.7",
-  "Programming Language :: Python :: 3.8",
-  "Programming Language :: Python :: 3.9",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
 ]
 
 [project.optional-dependencies]
 test = ["pytest"]
-lint = ["black", "ruff"]
+lint = ["black", "mypy", "ruff"]
 
 [project.urls]
 Changelog = "https://github.com/brettcannon/microvenv/releases"
 Source = "https://github.com/brettcannon/microvenv"
+
+
+[tool.mypy]
+ignore_missing_imports = true