chore: Migrate from Poetry to uv workspace

jsonbailey · jsonbailey · commit f54d5cf72bd8 · 2026-03-10T15:49:22.000-05:00
diff --git a/.gitignore b/.gitignore
@@ -72,5 +72,6 @@ test-packaging-venv
 .vscode/
 .python-version
 
-# Poetry
-poetry.lock
+# uv — lock file is not committed for libraries (only for applications)
+uv.lock
+.venv/
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -14,13 +14,29 @@ We encourage pull requests and other contributions from the community. Before su
 
 ### Setup
 
-This project is built using [poetry](https://python-poetry.org/). To learn more about the basics of working with this tool, read [Poetry's basic usage guide](https://python-poetry.org/docs/basic-usage/).
+This project is built using [uv](https://docs.astral.sh/uv/). The repo is structured as a uv workspace — a single shared virtual environment at the repo root contains all packages and their dependencies, and cross-package dependencies (e.g. the provider packages depending on `launchdarkly-server-sdk-ai`) are automatically resolved from the local workspace members.
 
-To begin development, ensure your dependencies are installed and (optionally) activate the virtualenv.
+To install uv, see the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/).
 
+To install all packages and dev dependencies into the shared workspace environment:
+
+```shell
+make install
+# or directly:
+uv sync --all-groups
 ```
-poetry install
-eval $(poetry env activate)
+
+To activate the shared virtual environment:
+
+```shell
+source .venv/bin/activate
+```
+
+Alternatively, prefix any command with `uv run` to use the workspace environment without activating it:
+
+```shell
+uv run pytest
+uv run mypy src/ldai
 ```
 
 ### Testing
@@ -31,6 +47,14 @@ To run all unit tests:
 make test
 ```
 
+To run tests for a specific package:
+
+```shell
+make test-server-ai
+make test-openai
+make test-langchain
+```
+
 It is preferable to run tests against all supported minor versions of Python (as described in `README.md` under Requirements), or at least the lowest and highest versions, prior to submitting a pull request. However, LaunchDarkly's CI tests will run automatically against all supported versions.
 
 ### Building documentation
diff --git a/Makefile b/Makefile
@@ -23,10 +23,8 @@ help: #! Show this help message
 #
 
 .PHONY: install
-install: #! Install all packages
-	$(MAKE) install-server-ai
-	$(MAKE) install-langchain
-	$(MAKE) install-openai
+install: #! Install all packages and dev dependencies into the shared workspace environment
+	uv sync --all-groups
 
 .PHONY: install-server-ai
 install-server-ai: #! Install server-ai package
diff --git a/packages/ai-providers/server-ai-langchain/Makefile b/packages/ai-providers/server-ai-langchain/Makefile
@@ -9,21 +9,21 @@ help: #! Show this help message
 
 .PHONY: install
 install: #! Install package dependencies
-	poetry install
+	uv sync --group dev
 
 .PHONY: test
 test: #! Run unit tests
 test: install
-	poetry run pytest $(PYTEST_FLAGS)
+	uv run pytest $(PYTEST_FLAGS)
 
 .PHONY: lint
 lint: #! Run type analysis and linting checks
 lint: install
-	poetry run mypy src/ldai_langchain
-	poetry run isort --check --atomic src/ldai_langchain
-	poetry run pycodestyle src/ldai_langchain
+	uv run mypy src/ldai_langchain
+	uv run isort --check --atomic src/ldai_langchain
+	uv run pycodestyle src/ldai_langchain
 
 .PHONY: build
 build: #! Build distribution files
 build: install
-	poetry build
+	uv build
diff --git a/packages/ai-providers/server-ai-langchain/pyproject.toml b/packages/ai-providers/server-ai-langchain/pyproject.toml
@@ -1,12 +1,11 @@
-[tool.poetry]
+[project]
 name = "launchdarkly-server-sdk-ai-langchain"
 version = "0.3.1"
 description = "LaunchDarkly AI SDK LangChain Provider"
-authors = ["LaunchDarkly <dev@launchdarkly.com>"]
-license = "Apache-2.0"
+authors = [{name = "LaunchDarkly", email = "dev@launchdarkly.com"}]
+license = {text = "Apache-2.0"}
 readme = "README.md"
-homepage = "https://docs.launchdarkly.com/sdk/ai/python"
-repository = "https://github.com/launchdarkly/python-server-sdk-ai"
+requires-python = ">=3.9,<4"
 classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
@@ -20,21 +19,32 @@ classifiers = [
     "Topic :: Software Development",
     "Topic :: Software Development :: Libraries",
 ]
-packages = [{ include = "ldai_langchain", from = "src" }]
+dependencies = [
+    "launchdarkly-server-sdk-ai>=0.16.0",
+    "langchain-core>=0.2.0",
+    "langchain>=0.2.0",
+]
+
+[project.urls]
+Homepage = "https://docs.launchdarkly.com/sdk/ai/python"
+Repository = "https://github.com/launchdarkly/python-server-sdk-ai"
+
+[dependency-groups]
+dev = [
+    "pytest>=2.8",
+    "pytest-cov>=2.4.0",
+    "pytest-asyncio>=0.21.0",
+    "mypy==1.18.2",
+    "pycodestyle>=2.11.0",
+    "isort>=5.12.0",
+]
 
-[tool.poetry.dependencies]
-python = ">=3.9,<4"
-launchdarkly-server-sdk-ai = ">=0.16.0"
-langchain-core = ">=0.2.0"
-langchain = ">=0.2.0"
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
-[tool.poetry.group.dev.dependencies]
-pytest = ">=2.8"
-pytest-cov = ">=2.4.0"
-pytest-asyncio = ">=0.21.0"
-mypy = "==1.18.2"
-pycodestyle = ">=2.11.0"
-isort = ">=5.12.0"
+[tool.hatch.build.targets.wheel]
+packages = ["src/ldai_langchain"]
 
 [tool.mypy]
 python_version = "3.9"
@@ -47,13 +57,7 @@ profile = "black"
 known_third_party = ["langchain", "langchain_core", "ldai"]
 sections = ["FUTURE", "STDLIB", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER"]
 
-
 [tool.pytest.ini_options]
 addopts = ["-ra"]
 testpaths = ["tests"]
 asyncio_mode = "auto"
-
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
diff --git a/packages/ai-providers/server-ai-openai/Makefile b/packages/ai-providers/server-ai-openai/Makefile
@@ -9,22 +9,21 @@ help: #! Show this help message
 
 .PHONY: install
 install: #! Install package dependencies
-	poetry install
+	uv sync --group dev
 
 .PHONY: test
 test: #! Run unit tests
 test: install
-	poetry run pytest $(PYTEST_FLAGS)
+	uv run pytest $(PYTEST_FLAGS)
 
 .PHONY: lint
 lint: #! Run type analysis and linting checks
 lint: install
-	poetry run mypy src/ldai_openai
-	poetry run isort --check --atomic src/ldai_openai
-	poetry run pycodestyle src/ldai_openai
+	uv run mypy src/ldai_openai
+	uv run isort --check --atomic src/ldai_openai
+	uv run pycodestyle src/ldai_openai
 
 .PHONY: build
 build: #! Build distribution files
 build: install
-	poetry build
-
+	uv build
diff --git a/packages/ai-providers/server-ai-openai/pyproject.toml b/packages/ai-providers/server-ai-openai/pyproject.toml
@@ -1,12 +1,11 @@
-[tool.poetry]
+[project]
 name = "launchdarkly-server-sdk-ai-openai"
 version = "0.2.0"
 description = "LaunchDarkly AI SDK OpenAI Provider"
-authors = ["LaunchDarkly <dev@launchdarkly.com>"]
-license = "Apache-2.0"
+authors = [{name = "LaunchDarkly", email = "dev@launchdarkly.com"}]
+license = {text = "Apache-2.0"}
 readme = "README.md"
-homepage = "https://docs.launchdarkly.com/sdk/ai/python"
-repository = "https://github.com/launchdarkly/python-server-sdk-ai"
+requires-python = ">=3.9,<4"
 classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
@@ -20,20 +19,31 @@ classifiers = [
     "Topic :: Software Development",
     "Topic :: Software Development :: Libraries",
 ]
-packages = [{ include = "ldai_openai", from = "src" }]
+dependencies = [
+    "launchdarkly-server-sdk-ai>=0.16.0",
+    "openai>=1.0.0",
+]
 
-[tool.poetry.dependencies]
-python = ">=3.9,<4"
-launchdarkly-server-sdk-ai = ">=0.16.0"
-openai = ">=1.0.0"
+[project.urls]
+Homepage = "https://docs.launchdarkly.com/sdk/ai/python"
+Repository = "https://github.com/launchdarkly/python-server-sdk-ai"
+
+[dependency-groups]
+dev = [
+    "pytest>=2.8",
+    "pytest-cov>=2.4.0",
+    "pytest-asyncio>=0.21.0,<1.0.0",
+    "mypy==1.18.2",
+    "pycodestyle>=2.11.0",
+    "isort>=5.12.0",
+]
 
-[tool.poetry.group.dev.dependencies]
-pytest = ">=2.8"
-pytest-cov = ">=2.4.0"
-pytest-asyncio = ">=0.21.0,<1.0.0"
-mypy = "==1.18.2"
-pycodestyle = ">=2.11.0"
-isort = ">=5.12.0"
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ldai_openai"]
 
 [tool.mypy]
 python_version = "3.9"
@@ -46,14 +56,7 @@ profile = "black"
 known_third_party = ["openai", "ldai"]
 sections = ["FUTURE", "STDLIB", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER"]
 
-
 [tool.pytest.ini_options]
 addopts = ["-ra"]
 testpaths = ["tests"]
 asyncio_mode = "auto"
-
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
-
diff --git a/packages/sdk/server-ai/Makefile b/packages/sdk/server-ai/Makefile
@@ -15,26 +15,26 @@ help: #! Show this help message
 
 .PHONY: install
 install: #! Install package dependencies
-	poetry install
+	uv sync --group dev
 
 .PHONY: test
 test: #! Run unit tests
 test: install
-	poetry run pytest $(PYTEST_FLAGS)
+	uv run pytest $(PYTEST_FLAGS)
 
 .PHONY: lint
 lint: #! Run type analysis and linting checks
 lint: install
-	poetry run mypy src/ldai
-	poetry run isort --check --atomic src/ldai
-	poetry run pycodestyle src/ldai
+	uv run mypy src/ldai
+	uv run isort --check --atomic src/ldai
+	uv run pycodestyle src/ldai
 
 .PHONY: build
 build: #! Build distribution files
 build: install
-	poetry build
+	uv build
 
 .PHONY: docs
 docs: #! Generate sphinx-based documentation
-	poetry install --with docs
-	poetry run $(SPHINXBUILD) -M html "$(DOCS_DIR)" "$(DOCS_BUILD_DIR)" $(SPHINXOPTS)
+	uv sync --group docs
+	uv run $(SPHINXBUILD) -M html "$(DOCS_DIR)" "$(DOCS_BUILD_DIR)" $(SPHINXOPTS)
diff --git a/packages/sdk/server-ai/pyproject.toml b/packages/sdk/server-ai/pyproject.toml
diff --git a/pyproject.toml b/pyproject.toml
