Add pyproject.toml metadata

This includes a build system specification (PEP 518) and essential
metadata (PEP 621). This configuration is needed for modern tooling.

Migrate dev-dependencies.txt to pyproject.toml and add ruff and mypy.

Also add a PEP 561 py.typed marker and a .python-version file.

Author: v--

.github/workflows/python-package.yml

@@ -27,11 +27,13 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip setuptools
-        python -m pip install build
+        python -m pip install --upgrade pip
+        python -m pip install --group dev
         python -m pip install twine
-        python -m pip install sphinx
-        if [ -f dev-requirements.txt ]; then pip install -r dev-requirements.txt; fi
+    - name: Run linter
+      run: ruff check
+    - name: Check types
+      run: mypy
     - name: Run Tests
       run: |
         python tests.py

.python-version

@@ -0,0 +1 @@
+3.10

AGENTS.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ```bash
 # Install dev dependencies
-pip install -r dev-requirements.txt
+pip install --group dev
 
 # Run all tests
 python tests.py

CONTRIBUTING.md

@@ -6,7 +6,7 @@ Development Environment Setup
 
 Install dev dependencies:
 
-    pip install -r dev-requirements.txt
+    pip install --group dev
 
 Running Tests
 ---------------

dev-requirements.txt

@@ -0,0 +1,40 @@
+[project]
+name = "nameparser"
+readme = "README.rst"
+requires-python = ">=3.10"
+dynamic = ["version", "description", "license", "authors"]
+dependencies = [
+  "typing_extensions (>=4.5.0); python_version < '3.11'"
+]
+
+[build-system]
+# nameparser is a build requirement of itself because it is imported in setup.py
+requires = ["setuptools (>=82.0.1)", "nameparser"]
+build-backend = "setuptools.build_meta"
+
+[dependency-groups]
+dev = [
+  "dill (>=0.2.5)",
+  "sphinx (>=8)",
+  "mypy (>=2.1)",
+  "ruff (>=0.15)"
+]
+
+[tool.mypy]
+packages = ["nameparser"]
+
+[[tool.mypy.overrides]]
+module = [
+  "dill.*",
+]
+ignore_missing_imports = true
+
+[tool.ruff.lint]
+select = [
+  "ANN",   # flake8-annotations
+  "UP",    # pyupgrade
+]
+ignore = [
+  "UP031",   # printf-string-formatting (the code already uses % formatting)
+  "UP032",   # f-string (the code already uses str.format)
+]