feature: migrate from pipenv to uv

Author: ninjinkun

.github/workflows/python-package.yml

@@ -11,7 +11,6 @@ on:
       - 'WORKSPACE'
       - 'src/**'
   pull_request:
-    branches: [ main ]
     paths-ignore:
       - 'WORKSPACE'
       - 'src/**'
@@ -34,63 +33,41 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        # Python 3.6 is not supported on Ubuntu 22.04.
         os: [ubuntu-22.04, windows-latest]
-        python-version: [3.7, 3.8, 3.9, "3.10", "3.11", "3.12"]
-        include:
-          - os: windows-latest
-            python-version: 3.6
 
     steps:
-    - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
       with:
-        python-version: ${{ matrix.python-version }}
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+    
     - name: Set up JDK 1.8
       uses: actions/setup-java@c5195efecf7bdfc987ee8bae7a71cb8b11521c00 # v4.7.1
       with:
         java-version: 8
-        distribution: 'temurin'
-    - name: Install specific dependencies in 3.6
-      if: matrix.python-version == '3.6'
-      uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3.0.2
-      with:
-        max_attempts: 3
-        timeout_minutes: 5
-        retry_on: error
-        command: |
-          python -m pip install --upgrade pip
-          pip install pipenv==2021.11.5
-          pipenv install --dev --python ${{ matrix.python-version }}
+        distribution: 'temurin'    
+    
     - name: Install dependencies
-      if: matrix.python-version != '3.6'
-      uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3.0.2
-      with:
-        max_attempts: 3
-        timeout_minutes: 5
-        retry_on: error
-        command: |
-          python -m pip install --upgrade pip
-          pip install pipenv
-          pipenv install --dev --python ${{ matrix.python-version }}
+      run: uv sync --dev
     - name: Build
       run: |
-        pipenv run pip list
-        pipenv run build
-        pipenv run install
+        uv pip list
+        uv run poe build
+    
     - name: Type check
-      run: pipenv run type
+      run: uv run poe type
+    
     - name: Lint with flake8
-      run: |
-        # stop the build if there are Python syntax errors or undefined names
-        pipenv run lint
+      run: uv run poe lint
     - name: Pull request validation
       run: |
-        # Install Launchable CLI from this repos's code
-        pip3 install . > /dev/null
+        # Install Launchable CLI from this repo's code as a global tool
+        uv tool install .
 
         set -x
 
@@ -99,7 +76,7 @@ jobs:
         # Tell Launchable about the build you are producing and testing
         launchable record build --name ${GITHUB_RUN_ID}
 
-        launchable record session --build ${GITHUB_RUN_ID} --flavor os=${{ matrix.os }} --flavor python=${{ matrix.python-version }} > session.txt
+        launchable record session --build ${GITHUB_RUN_ID} --flavor os=${{ matrix.os }} --flavor python=3.13 > session.txt
 
         # Find 25% of the relevant tests to run for this change
         find tests -name test_*.py | grep -v tests/data | launchable subset --target 25% --session $(cat session.txt) --rest launchable-remainder.txt file > subset.txt
@@ -112,8 +89,8 @@ jobs:
         trap record EXIT
 
         # Test subset of tests
-        pipenv run test-xml $(tr '\r\n' '\n' < subset.txt)
+        uv run poe test-xml $(tr '\r\n' '\n' < subset.txt)
 
         # Test rest of tests
-        pipenv run test-xml $(tr '\r\n' '\n' < launchable-remainder.txt)
+        uv run poe test-xml $(tr '\r\n' '\n' < launchable-remainder.txt)
       shell: bash

.github/workflows/python-publish.yml

@@ -38,26 +38,14 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 0
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+    
     - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.x'
-    # build and publish package using GitHub Actions workflow
-    # https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
-    - name: Install pypa/build
-      run: >-
-        python -m
-        pip install
-        build
-        --user
-    - name: Build a binary wheel and a source tarball
-      run: >-
-        python -m
-        build
-        --sdist
-        --wheel
-        --outdir dist/
-        .
+      run: uv python install 3.13
+    
+    - name: Build package
+      run: uv build
     # actual publish
     - name: Publish to PyPI
       uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4

.python-version

@@ -1 +1 @@
-3.6.15
+3.13

Pipfile

@@ -7,27 +7,37 @@ https://www.launchableinc.com/docs/getting-started/.
 
 ## Preparation
 
-We recommend Pipenv
+We recommend uv for dependency management:
 
 ```shell
-pip install pipenv==2021.5.29
-pipenv install --dev
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install dependencies
+uv sync --dev
 ```
 
 In order to automatically format files with autopep8, this repository contains a
 configuration for [pre-commit](https://pre-commit.com). Install the hook with
-`pipenv run pre-commit install`.
+`uv run pre-commit install`.
 
 ## Load development environment
 
 ```shell
-pipenv shell
+# Activate virtual environment
+source .venv/bin/activate
+# or use uv run for individual commands
+uv run <command>
 ```
 
 ## Run tests cli
 
 ```shell
-pipenv run test
+# Using poethepoet (recommended)
+uv run poe test
+
+# Direct command
+uv run python -m unittest
 ```
 
 ## Run tests exe_deploy.jar
@@ -36,12 +46,58 @@ pipenv run test
 bazel test ...
 ```
 
+## Available Development Tasks
+
+This project uses [poethepoet](https://poethepoet.natn.io/) for task management. Available tasks:
+
+```shell
+# Show all available tasks
+uv run poe --help
+
+# Run tests
+uv run poe test
+
+# Run tests with XML output
+uv run poe test-xml
+
+# Run linting
+uv run poe lint
+
+# Run type checking
+uv run poe type
+
+# Format code
+uv run poe format
+
+# Build package
+uv run poe build
+
+# Install package locally
+uv run poe install
+```
+
 ## Add dependency
 
 ```shell
-pipenv install --dev some-what-module
+# Add runtime dependency
+uv add some-package
+
+# Add development dependency  
+uv add --dev some-dev-package
 ```
 
+## Updating Python Version
+
+When updating the Python version requirement, update the following files:
+
+1. **`.python-version`** - Used by pyenv, uv, and local development
+2. **`pyproject.toml`** - Update `requires-python = ">=X.Y"`
+3. **`setup.cfg`** - Update `python_requires = >=X.Y`
+4. **`.github/workflows/python-package.yml`** - Update `python-version: ["X.Y"]`
+5. **`.github/workflows/python-publish.yml`** - Update `uv python install X.Y`
+6. **`README.md`** - Update prerequisite section
+7. **`CLAUDE.md`** - Update development notes
+
 # How to release
 
 Create new release on Github, then Github Actions automatically uploads the
@@ -59,7 +115,7 @@ You can install the `launchable` command from either source or [pypi](https://py
 
 ## Prerequisite
 
-- \>= Python 3.6
+- \>= Python 3.13
 - \>= Java 8
 
 ## Install from source

README.md

@@ -1,3 +1,63 @@
+[project]
+name = "launchable"
+authors = [
+    {name = "Launchable, Inc.", email = "[email protected]"}
+]
+description = "Launchable CLI"
+readme = "README.md"
+license = {text = "Apache Software License v2"}
+requires-python = ">=3.13"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "click>=8.1,<8.2",
+    "requests>=2.25",
+    "urllib3>=1.26",
+    "junitparser>=2.0.0",
+    "setuptools",
+    "more-itertools>=7.1.0",
+    "python-dateutil",
+    "tabulate",
+]
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://launchableinc.com/"
+Repository = "https://github.com/launchableinc/cli"
+
+[project.scripts]
+launchable = "launchable.__main__:main"
+
+[tool.uv]
+dev-dependencies = [
+    "flake8",
+    "autopep8<=1.7.0",
+    "isort",
+    "mypy<1.16.0",
+    "pre-commit",
+    "responses",
+    "types-click",
+    "types-pkg_resources==0.1.3",
+    "types-python-dateutil",
+    "types-requests",
+    "types-tabulate",
+    "lxml",
+    "unittest-xml-reporting",
+    "poethepoet",
+]
+
+[tool.poe.tasks]
+build = "python setup.py sdist bdist_wheel"
+format = "/bin/bash -c 'isort -l 130 --balanced launchable/*.py tests/*.py && autopep8 --in-place --recursive --aggressive --experimental --max-line-length=130 --verbose launchable/ tests/'"
+lint = "flake8 --count --ignore=C901,E741,F401 --show-source --max-line-length=130 --statistics launchable/ tests/"
+lint-warn = "flake8 --count --exit-zero --max-complexity=15 --max-line-length=130 --statistics launchable/ tests/"
+test = "python -m unittest"
+test-xml = "python -m test-runner"
+type = "mypy launchable tests"
+
 [build-system]
 requires = ["setuptools>=45", "wheel", "setuptools_scm"]
 build-backend = "setuptools.build_meta"

pyproject.toml

@@ -14,19 +14,7 @@ classifiers =
 
 [options]
 packages = find:
-install_requires =
-    click>=8.0,<8.1;python_version=='3.6'
-    click>=8.1,<8.2;python_version>'3.6'
-    requests>=2.25;python_version>='3.6'
-    urllib3>=1.26
-    junitparser>=2.0.0
-    setuptools
-    more_itertools>=7.1.0;python_version>='3.6'
-    python-dateutil
-    tabulate
-python_requires = >=3.6
-setup_requires =
-    setuptools-scm
+python_requires = >=3.13
 
 [options.entry_points]
 console_scripts = launchable = launchable.__main__:main