Scaffold Python package with uv and CI

.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: ["main"]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v1
+      - run: uv sync --dev
+      - run: uv run pre-commit run --all-files
+      - run: uv run pytest

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.11
+    hooks:
+      - id: ruff
+      - id: ruff-format

pyproject.toml

@@ -1,6 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
 [project]
 name = "python-usajobsapi"
 version = "0.1.0"
 description = "A Python wrapper for the USA Jobs REST API."
 readme = "README.md"
+requires-python = ">=3.9"
+license = {file = "LICENSE"}
 dependencies = []
+
+[tool.hatch.build.targets.wheel]
+packages = ["usajobsapi"]
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.3.0",
+    "pytest>=8.4.1",
+    "ruff>=0.12.11",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py39"
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]

tests/test_placeholder.py

@@ -0,0 +1,6 @@
+"""Placeholder tests for USAJobs API package."""
+
+
+def test_placeholder() -> None:
+    """A trivial test to ensure the test suite runs."""
+    assert True

usajobsapi/__init__.py

@@ -0,0 +1,3 @@
+"""Top-level package for USAJobs API wrapper."""
+
+__all__: list[str] = []