chore: add type annotations

Makefile

@@ -0,0 +1,56 @@
+# Makefile for running mypy type checks, tests, flake8 checks, and ruff formatting
+
+# Variables
+PYTHON = python3
+MYPY = mypy
+MYPY_CONFIG = mypy.ini  
+SOURCE_DIR = ./nikola  
+TEST_DIR = ./tests  
+TEST_RUNNER = pytest 
+FLAKE8 = flake8 
+RUFF = ruff  # Ruff linter/formatter
+
+# Default target
+.PHONY: all
+all: check test lint format
+
+# Check types with mypy
+.PHONY: check
+check:
+	@echo "Running mypy type checks..."
+	$(MYPY) --config-file $(MYPY_CONFIG) $(SOURCE_DIR)
+
+# Run tests with pytest
+.PHONY: test
+test:
+	@echo "Running tests..."
+	$(TEST_RUNNER) $(TEST_DIR)
+
+# Run flake8 checks
+.PHONY: lint
+lint:
+	@echo "Running flake8 checks..."
+	$(FLAKE8) $(SOURCE_DIR) $(TEST_DIR)
+
+# Run ruff checks and formatting
+.PHONY: format
+format:
+	@echo "Running Ruff for formatting and linting..."
+	$(RUFF) check $(SOURCE_DIR) $(TEST_DIR)  # Change 'check' to 'fix' if you want to auto-fix issues
+
+# Clean up (optional)
+.PHONY: clean
+clean:
+	@echo "Cleaning up..."
+	# You can add commands to remove unwanted files if needed
+
+# Help
+.PHONY: help
+help:
+	@echo "Makefile commands:"
+	@echo "  check   - Run mypy type checks"
+	@echo "  test    - Run tests using pytest"
+	@echo "  lint    - Run flake8 checks on source and tests"
+	@echo "  format   - Run Ruff for formatting and linting"
+	@echo "  clean   - Clean up (optional)"
+	@echo "  help    - Show this help message"

mypy.ini

@@ -0,0 +1,6 @@
+[mypy]
+ignore_missing_imports = True
+strict = True
+disallow_untyped_calls = True
+disallow_untyped_defs = True
+disable_error_code = no-untyped-call, misc

nikola/__init__.py

@@ -28,13 +28,14 @@
 
 import os
 import sys
+from typing import Final
 
-__version__ = '8.3.1'
-DEBUG = bool(os.getenv('NIKOLA_DEBUG'))
-SHOW_TRACEBACKS = bool(os.getenv('NIKOLA_SHOW_TRACEBACKS'))
+__version__: Final[str] = "8.3.1"
+DEBUG: bool = bool(os.getenv("NIKOLA_DEBUG"))
+SHOW_TRACEBACKS: bool = bool(os.getenv("NIKOLA_SHOW_TRACEBACKS"))
 
 if sys.version_info[0] == 2:
     raise Exception("Nikola does not support Python 2.")
 
-from .nikola import Nikola  # NOQA
 from . import plugins  # NOQA
+from .nikola import Nikola  # NOQA