refactor: Move from setuptools to uv

Previously, we were using setuptools via a setup.py file
and various requirements*.txt files. This updates the
package to the more modern pyproject.toml file and switches
our build system to uv.

Additionally, the package was previously a top level package,
which improves testability since the package will no longer be
automatically added to sys.path.

This change will improve both our developer experience and the
packages reproducibility.

Author: birdcar

.github/workflows/ci.yml

@@ -17,29 +17,25 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        python: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v3
-      - uses: actions/setup-python@v5
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python }}
-          cache: "pip"
-          cache-dependency-path: setup.py
+          enable-cache: true
 
       - name: Install dependencies
-        run: |
-          pip install -e .[dev]
+        run: uv sync --locked --dev
 
       - name: Check formatting
-        run: black --check .
+        run: uv run ruff format --check .
 
       - name: Lint
-        run: |
-          flake8 . --extend-exclude .devbox --count --select=E9,F7,F82 --show-source --statistics
-          flake8 . --extend-exclude .devbox --count --exit-zero --max-complexity=10 --statistics
+        run: uv run ruff check --extend-exclude .devbox
 
       - name: Type Check
-        run: mypy
+        run: uv run mypy
 
       - name: Test
-        run: python -m pytest
+        run: uv run pytest

CLAUDE.md

@@ -0,0 +1,63 @@
+[project]
+name = "workos"
+version = "5.32.0"
+description = "WorkOS Python Client"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "WorkOS", email = "team@workos.com" }]
+requires-python = ">=3.8"
+
+dependencies = [
+  "cryptography>=44.0.2",
+  "httpx~=0.28.1",
+  "pydantic>=2.10.4",
+  "pyjwt>=2.10.0 ; python_full_version >= '3.9'",
+  "pyjwt>=2.9.0,<2.10 ; python_full_version == '3.8.*'",
+]
+
+[project.urls]
+Homepage = "https://workos.com/docs/sdks/python"
+Documentation = "https://workos.com/docs/reference"
+Changelog = "https://workos.com/docs/sdks/python"
+
+[dependency-groups]
+dev = [
+  { include-group = "test" },
+  { include-group = "lint" },
+  { include-group = "type_check" },
+]
+test = [
+  "pytest==8.3.4",
+  "pytest-asyncio==0.23.8",
+  "pytest-cov==5.0.0",
+  "six==1.17.0",
+]
+lint = ["ruff==0.14.5"]
+type_check = ["mypy==1.14.1"]
+
+
+[tool.mypy]
+packages = "workos"
+warn_return_any = true
+warn_unused_configs = true
+warn_unreachable = true
+warn_redundant_casts = true
+warn_no_return = true
+warn_unused_ignores = true
+implicit_reexport = true
+strict_equality = true
+strict = true
+
+[tool.ruff.lint.per-file-ignores]
+"*/__init__.py" = ["F401", "F403"]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.uv.build-backend]
+source-include = ["py.typed"]
+source-exclude = ["tests*"]
+
+[build-system]
+requires = ["uv_build>=0.8.15,<0.9.0"]
+build-backend = "uv_build"

README.md

@@ -2,8 +2,9 @@
 # Clean out the dist directory so only the current release gets uploaded
 rm dist/*
 
-# Build the distribution
-python3 setup.py sdist bdist_wheel
+# Build the package using uv
+uv build --sdist --wheel
+
+# Upload the distribution to PyPi via uv
+uv publish
 
-# Upload the distribution to PyPi via twine
-twine upload dist/*