Migrate from `pipenv` to `uv` #1047

ninjinkun · 2025-06-18T07:38:03Z

Summary

This PR migrates the Launchable CLI development environment from pipenv to uv, a modern Python package and project manager. This change brings significant performance improvements and simplifies the development workflow.

🚀 Key Benefits

Performance Improvements

10-100x faster dependency resolution and installation
Dramatically reduced CI/CD build times
Faster local development environment setup

Simplified Python Version Management

Automatic Python installation: uv automatically downloads and manages the specified Python version
No more Python version matrix testing: Since uv ensures consistent Python versions across environments, we can simplify CI to test only Python 3.13
Better developer experience: Developers no longer need to manually install the correct Python version

Modern Tooling

Unified tool: Python version management + dependency management + virtual environments
Standards compliance: Full PEP 621 and modern Python packaging standards support
Better caching: Improved dependency caching in CI environments

📋 Changes Made

Configuration Updates

pyproject.toml: Added complete project metadata and dependencies
setup.cfg: Simplified by removing duplicate dependency definitions
Python requirement: Updated from 3.6+ to 3.13+ for modern Python features
Removed files: Pipfile and Pipfile.lock (replaced by pyproject.toml and uv.lock)

Development Workflow

Task runner: Integrated poethepoet for development tasks
Simplified commands: All development tasks now use uv run poe <task>
Available tasks:
- uv run poe test - Run tests
- uv run poe lint - Code linting
- uv run poe type - Type checking
- uv run poe format - Code formatting
- uv run poe build - Build packages

CI/CD Improvements

Simplified workflows: Updated GitHub Actions to use uv
Single Python version: Removed multi-version matrix testing (Python 3.13 only)
Faster builds: Leverages uv's superior caching and performance
Tool installation: Uses uv tool install for global CLI installation

Documentation Updates

README.md: Updated with uv installation and usage instructions
CLAUDE.md: Updated development commands and workflow
Version upgrade guide: Added comprehensive guide for future Python version updates

🔧 Migration Guide for Developers

Before (pipenv)

pip install pipenv
pipenv install --dev
pipenv shell
pipenv run test

After (uv)

# Install uv (one-time setup)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Setup and use
uv sync --dev
uv run poe test

Key Advantages for Users

No Python version management: uv automatically downloads Python 3.13 if not available
Faster setup: Dependencies install 10-100x faster than with pipenv
Consistent environments: Guaranteed reproducible builds across all platforms
Single tool: No need to manage multiple tools for Python versions, virtual environments, and dependencies

🧪 Testing

✅ All existing tests pass
✅ CI/CD workflows updated and tested
✅ Local development workflow verified
✅ Cross-platform compatibility (Ubuntu, Windows, macOS)
✅ Dependency resolution verified (lxml 5.4.0 with Python 3.13 wheels)

🔄 Breaking Changes

For End Users

None: The launchable CLI functionality remains identical
Installation: Still available via pip install launchable from PyPI

For Contributors

Python requirement: Now requires Python 3.13+ (was 3.6+)
Development setup: Must use uv instead of pipenv
Task commands: Use uv run poe <task> instead of pipenv run <task>

📚 Additional Notes

Rename Github Actions files

python-publish.yml to publish.yml
python-package.yml to test.yml

Dependency Changes

Version constraints relaxed: Removed strict upper bounds on dependencies (click, autopep8, mypy, types-pkg_resources) to allow automatic updates to latest compatible versions
Modern package metadata: Migrated from deprecated pkg_resources to standard library importlib.metadata for version detection
lxml: Updated to 5.4.0 with Python 3.13 wheel support (eliminates need for system dependencies)
poethepoet: Added for task management
Removed packages: Several build-time dependencies no longer needed

Python Version Management

The .python-version file serves as the authoritative source for the Python version requirement. When updating Python versions in the future, update these files:

.python-version
pyproject.toml (requires-python)
setup.cfg (python_requires)
GitHub Actions workflows
Documentation files

This migration positions the Launchable CLI for modern Python development practices while maintaining full backward compatibility for end users.

so, fixed the regexp to support groovy

Add Groovy config to jvm_test_pattern

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Release for v1.103.2

.github/workflows/publish.yml

Konboi · 2025-06-19T06:01:22Z

.github/workflows/publish.yml

-      with:
-        user: __token__
-        password: ${{ secrets.PYPI_API_TOKEN }}
+      run: uv publish --token ${{ secrets.PYPI_API_TOKEN }}


I think we should define a new token as different name.
We should keep to be able to publish v1 and v2

That's right. I'm going to update the token when I create a new package in PyPI.

Konboi · 2025-06-19T06:32:58Z

.github/workflows/test.yml

+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-22.04, windows-latest]


Don't we need to set multiple Python versions?

With uv, we only need to support a specified version. In this case, that's 3.13 in .python-version.

.github/workflows/test.yml

Konboi · 2025-06-19T06:36:36Z

README.md

 ## Prerequisite

- \>= Python 3.6
+- \>= Python 3.13


Don't we support from 3.6? Is it ok??

Same #1047 (comment)

Konboi · 2025-06-19T06:37:34Z

Q: Will we continue to use this repo?

If that’s the case, we’d want to be able to maintain both v1 and v2.
We’ll probably need to set up separate tag and PR workflows for the v1 and v2 releases, right?

Support groovy file in the maven profile

Release for v1.104.1

Fix robot ci failure

…ateutil

[LCHIB-612] Add a workaround for handling timezone abbreviations in d…

Release for v1.105.1

Copilot

Pull Request Overview

This PR migrates the development environment from pipenv to uv, updating project configuration, CLI commands, and CI workflows to leverage the performance and modern features of uv.

Migrates dependency and Python version management from pipenv to uv
Updates configuration files (pyproject.toml, setup.cfg, .python-version) and documentation accordingly
Revamps CI/CD workflows by removing pipenv steps and introducing uv-based actions

Reviewed Changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
setup.cfg	Updated python_requires and removed duplicate dependency definitions
pyproject.toml	Added complete project metadata and uv configuration
launchable/version.py	Replaced pkg_resources usage with importlib.metadata
README.md	Updated installation and task commands from pipenv to uv
Pipfile	Removed as part of the migration
.python-version	Updated Python version from 3.6.15 to 3.13
.github/workflows/test.yml	Revamped CI workflow using uv for dependency installing, testing, linting, etc.
.github/workflows/python-package.yml	Removed obsolete pipenv-based workflow
.github/workflows/publish.yml	Simplified publish workflow using uv publish command
.github/workflows/e2e.yml	Updated workflow with new branch condition and uv integration for end-to-end tests

.github/workflows/e2e.yml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

ninjinkun · 2025-06-26T01:27:55Z

Q: Will we continue to use this repo?

If that’s the case, we’d want to be able to maintain both v1 and v2.

Yes, we will continue to use this repo.

We’ll probably need to set up separate tag and PR workflows for the v1 and v2 releases, right?

That's right. In v1 branch, it keeps using the existing PR workflow. We should prepare another tag and PR workflow for v2.

Konboi · 2025-06-26T05:30:50Z

.github/workflows/test.yml

+
+        set -x
+
+        launchable verify


don't change the command name??

I will change the command name in another PR.

Konboi · 2025-06-26T05:32:46Z

pyproject.toml

+    "click>=8.1",
+    "requests>=2.25",
+    "urllib3>=1.26",
+    "junitparser>=2.0.0",


in main branch, we updated the junitparser to v4

Okay, I'm going to backport the main branch. Thank you for noticing!

Konboi · 2025-06-26T05:33:12Z

pyproject.toml

+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://launchableinc.com/"


Don't you change the information in this PR?

I will change it in another PR as well as the command name. Thanks for reminding me.

Konboi

Left a comment, but I'll approve not to block your task

Konboi · 2025-06-26T07:59:48Z

.github/workflows/publish.yml

-      with:
-        user: __token__
-        password: ${{ secrets.PYPI_API_TOKEN }}
+      run: uv publish --token ${{ secrets.PYPI_API_TOKEN }}


It should probably be fine, but just to prevent anything from accidentally running on this branch and getting uploaded to PyPI,
could you temporarily change the variable name to something safer?

Change PYPI_API_TOKEN to SMART_TESTS_PYPI_API_TOKEN to prevent accidental publishing during development on feature branches. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>

sonarqubecloud · 2025-06-27T00:40:44Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

ninjinkun force-pushed the introduce-uv branch 2 times, most recently from d75009a to c6146d7 Compare June 18, 2025 07:54

Groovy lang works on JVM but we haven't supported it as jvm_test_pattern

d789de9

so, fixed the regexp to support groovy

ninjinkun force-pushed the introduce-uv branch 3 times, most recently from 5e0ccb5 to b2eda83 Compare June 19, 2025 01:54

ninjinkun added the Smart Tests CLI The next gen CLI label Jun 19, 2025

ninjinkun marked this pull request as ready for review June 19, 2025 02:17

feature: migrate from pipenv to uv

099cc68

ninjinkun force-pushed the introduce-uv branch from b2eda83 to 099cc68 Compare June 19, 2025 02:23

ninjinkun and others added 4 commits June 19, 2025 11:44

refactor: rename GA files

771c19a

refactor: use uv publish

6353ba6

Merge pull request #1048 from launchableinc/support-groovy-as-jvm-files

25b1076

Add Groovy config to jvm_test_pattern

[tagpr] prepare for the next release

790d3c2

ninjinkun requested review from Konboi and Copilot June 19, 2025 02:52

This comment was marked as outdated.

Sign in to view

ninjinkun removed the request for review from Konboi June 19, 2025 02:57

ninjinkun and others added 4 commits June 19, 2025 11:58

Update pyproject.toml

8a83f54

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge pull request #1049 from launchableinc/tagpr-from-v1.103.1

3d879bd

Release for v1.103.2

refactor: remove an unused option

3534cae

refactor: update dependencies

3ffe950

ninjinkun requested a review from Konboi June 19, 2025 03:39

support groovy file in the maven profile

76e8312

Konboi reviewed Jun 19, 2025

View reviewed changes

Konboi and others added 4 commits June 19, 2025 16:21

Merge pull request #1050 from launchableinc/support-groovy-for-maven

3b1c57f

Support groovy file in the maven profile

[tagpr] prepare for the next release

921a92c

Merge pull request #1051 from launchableinc/tagpr-from-v1.104.0

e11e7d2

Release for v1.104.1

install latest version

b13dd73

Konboi and others added 12 commits June 24, 2025 08:55

from junitparser v4.0.0 returns JUnitXml instead of testsuite

a1ec8e6

Merge pull request #1055 from launchableinc/fix-robot-ci

6b94c1c

Fix robot ci failure

[LCHIB-612] Add a workaround for handling timezone abbreviations in d…

70042cf

…ateutil

Add new tests for checking the behavior

842f235

Use assertEqual instead of assertTrue and assertIn

bc99065

Add comment

7fc8428

Merge pull request #1043 from launchableinc/LCHIB-612

5b51375

[LCHIB-612] Add a workaround for handling timezone abbreviations in d…

[tagpr] prepare for the next release

120a19a

Merge pull request #1056 from launchableinc/tagpr-from-v1.105.0

9971c58

Release for v1.105.1

fix: specify the uv commit hash

742fbae

refactor: use .python-version

5b56f0d

feature: update e2e.yml

cbc377e

ninjinkun requested a review from Copilot June 26, 2025 01:21

Copilot AI reviewed Jun 26, 2025

View reviewed changes

.github/workflows/e2e.yml Outdated Show resolved Hide resolved

Update .github/workflows/e2e.yml

5ed3ad3

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

ninjinkun requested a review from Konboi June 26, 2025 01:27

Konboi reviewed Jun 26, 2025

View reviewed changes

Konboi approved these changes Jun 26, 2025

View reviewed changes

ninjinkun and others added 2 commits June 27, 2025 09:32

refactor: use safer PyPI token variable name

49f547e

Change PYPI_API_TOKEN to SMART_TESTS_PYPI_API_TOKEN to prevent accidental publishing during development on feature branches. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>

Merge branch 'main' into introduce-uv

b9e2c94

ninjinkun merged commit 8939b16 into smart-tests Jun 27, 2025
4 checks passed

ninjinkun deleted the introduce-uv branch June 27, 2025 00:57

This was referenced Sep 16, 2025

Release for v1.111.5 #1139

Closed

Release for v1.111.5 #1140

Closed

Release for v1.111.5 #1142

Closed

Release for v1.111.5 #1144

Closed

Release for v1.111.5 #1145

Merged

github-actions bot mentioned this pull request Nov 4, 2025

Release for v2.0.0 #1176

Merged

Migrate from pipenv to uv #1047

Migrate from pipenv to uv #1047

Uh oh!

Conversation

ninjinkun commented Jun 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

🚀 Key Benefits

Performance Improvements

Simplified Python Version Management

Modern Tooling

📋 Changes Made

Configuration Updates

Development Workflow

CI/CD Improvements

Documentation Updates

🔧 Migration Guide for Developers

Before (pipenv)

After (uv)

Key Advantages for Users

🧪 Testing

🔄 Breaking Changes

For End Users

For Contributors

📚 Additional Notes

Rename Github Actions files

Dependency Changes

Python Version Management

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Konboi commented Jun 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

ninjinkun commented Jun 26, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Konboi left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sonarqubecloud bot commented Jun 27, 2025

Quality Gate passed

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Migrate from `pipenv` to `uv` #1047

Migrate from `pipenv` to `uv` #1047

ninjinkun commented Jun 18, 2025 •

edited

Loading

Konboi commented Jun 19, 2025 •

edited

Loading