ci,pkg: poetry -> uv

uv:
- https://pypi.org/project/uv/
- https://github.com/astral-sh/uv
- https://docs.astral.sh/uv

poetry:
- https://pypi.org/project/poetry/
- https://github.com/python-poetry/poetry
- https://python-poetry.org/

Commands:

```
uv sync --all-extras --dev
```

Author: tony

.github/workflows/docs.yml

@@ -27,37 +27,36 @@ jobs:
             python_files:
               - 'src/tmuxp/**'
               - pyproject.toml
-              - poetry.lock
+              - uv.lock
 
       - name: Should publish
         if: steps.changes.outputs.docs == 'true' || steps.changes.outputs.root_docs == 'true' || steps.changes.outputs.python_files == 'true'
         run: echo "PUBLISH=$(echo true)" >> $GITHUB_ENV
 
-      - name: Install poetry
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
         if: env.PUBLISH == 'true'
-        run: pipx install "poetry==1.8.4"
+        with:
+          enable-cache: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
         if: env.PUBLISH == 'true'
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'poetry'
+        run: uv python install ${{ matrix.python-version }}
 
-      - name: Install dependencies [w/ docs]
+      - name: Install dependencies
         if: env.PUBLISH == 'true'
-        run: poetry install --with=docs,lint
+        run: uv sync --all-extras --dev
 
       - name: Print python versions
         if: env.PUBLISH == 'true'
         run: |
           python -V
-          poetry run python -V
+          uv run python -V
 
       - name: Build documentation
         if: env.PUBLISH == 'true'
         run: |
-          pushd docs; make SPHINXBUILD='poetry run sphinx-build' html; popd
+          pushd docs; make SPHINXBUILD='uv run sphinx-build' html; popd
 
       - name: Push documentation to S3
         if: env.PUBLISH == 'true'

.github/workflows/tests.yml

@@ -21,14 +21,16 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install poetry
-        run: pipx install "poetry==1.8.4"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'poetry'
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
 
       - name: Setup tmux build cache for tmux ${{ matrix.tmux-version }}
         id: tmux-build-cache
@@ -94,18 +96,20 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install poetry
-        run: pipx install "poetry==1.8.4"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'poetry'
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
 
       - name: Build package
         if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
-        run: poetry build
+        run: uv build
 
       - name: Publish package
         if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')

.tmuxp.json

@@ -1,6 +1,9 @@
 {
   "session_name": "tmuxp",
   "start_directory": "./",
+  "shell_command_before": [
+    "uv virtualenv --quiet > /dev/null 2>&1 && clear"
+  ],
   "windows": [
     {
       "window_name": "tmuxp",

.tmuxp.yaml

@@ -1,5 +1,7 @@
 session_name: tmuxp
 start_directory: ./ # load session relative to config location (project root).
+shell_command_before:
+- uv virtualenv --quiet > /dev/null 2>&1 && clear
 windows:
 - window_name: tmuxp
   focus: True

CHANGES

@@ -21,10 +21,16 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
 
 ### Development
 
+- Project and package management: poetry to uv (#949)
+
+  [uv] is the new package and project manager for the project, replacing Poetry.
+
 - Code quality: Use f-strings in more places (#931)
 
   via [ruff 0.4.2](https://github.com/astral-sh/ruff/blob/v0.4.2/CHANGELOG.md).
 
+[uv]: https://github.com/astral-sh/uv
+
 ## tmuxp 1.47.0 (2024-04-21)
 
 _Maintenance only, no bug fixes or new features_

Makefile

@@ -12,10 +12,10 @@ entr_warn:
 	@echo "----------------------------------------------------------"
 
 test:
-	poetry run py.test $(test)
+	uv run py.test $(test)
 
 start:
-	$(MAKE) test; poetry run ptw .
+	$(MAKE) test; uv run ptw .
 
 watch_test:
 	if command -v entr > /dev/null; then ${TEST_FILES} | entr -c $(MAKE) test; else $(MAKE) test entr_warn; fi
@@ -39,16 +39,16 @@ design_docs:
 	$(MAKE) -C docs design
 
 ruff_format:
-	poetry run ruff format .
+	uv run ruff format .
 
 ruff:
-	poetry run ruff check .
+	uv run ruff check .
 
 watch_ruff:
 	if command -v entr > /dev/null; then ${PY_FILES} | entr -c $(MAKE) ruff; else $(MAKE) ruff entr_warn; fi
 
 mypy:
-	poetry run mypy `${PY_FILES}`
+	uv run mypy `${PY_FILES}`
 
 watch_mypy:
 	if command -v entr > /dev/null; then ${PY_FILES} | entr -c $(MAKE) mypy; else $(MAKE) mypy entr_warn; fi
@@ -57,7 +57,7 @@ format_markdown:
 	npx prettier --parser=markdown -w *.md docs/*.md docs/**/*.md CHANGES
 
 monkeytype_create:
-	poetry run monkeytype run `poetry run which py.test`
+	uv run monkeytype run `uv run which py.test`
 
 monkeytype_apply:
-	poetry run monkeytype list-modules | xargs -n1 -I{} sh -c 'poetry run monkeytype apply {}'
+	uv run monkeytype list-modules | xargs -n1 -I{} sh -c 'uv run monkeytype apply {}'

docs/Makefile

@@ -6,7 +6,7 @@ WATCH_FILES= find .. -type f -not -path '*/\.*' | grep -i '.*[.]\(rst\|md\)\$\|.
 
 # You can set these variables from the command line.
 SPHINXOPTS    =
-SPHINXBUILD   = poetry run sphinx-build
+SPHINXBUILD   = uv run sphinx-build
 PAPER         =
 BUILDDIR      = _build
 
@@ -182,8 +182,8 @@ dev:
 	$(MAKE) -j watch serve
 
 start:
-	poetry run sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --port ${HTTP_PORT} $(O)
+	uv run sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --port ${HTTP_PORT} $(O)
 
 design:
 	# This adds additional watch directories (for _static file changes) and disable incremental builds
-	poetry run sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --port ${HTTP_PORT} --watch "." -a $(O)
+	uv run sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --port ${HTTP_PORT} --watch "." -a $(O)

docs/configuration/examples.md

@@ -636,9 +636,9 @@ windows:
   - focus: True
   - blank
   - >
-    poetry run ./manage.py migrate &&
+    uv run ./manage.py migrate &&
     npm -C js run start
-  - poetry run ./manage.py runserver
+  - uv run ./manage.py runserver
   options:
     main-pane-height: 35
 ```

docs/developing.md

@@ -33,9 +33,9 @@ $ cd tmuxp
 
 ### Bootstrap
 
-The easiest way to configure a dev environment is through [poetry]. This
+The easiest way to configure a dev environment is through [uv]. This
 automatically will manage virtualenv and python dependencies for tmuxp.
-For information on installing poetry visit the [poetry's documentation].
+For information on installing uv visit the [uv's documentation].
 
 To begin developing, check out the code from github:
 
@@ -48,34 +48,29 @@ $ cd tmuxp
 ```
 
 You can create a virtualenv, and install all of the locked
-packages as listed in poetry.lock:
+packages as listed in uv.lock:
 
 ```console
-$ poetry install
+$ uv sync --all-extras --dev
 ```
 
 If you ever need to update packages during your development session, the
-following command can be used to update all packages as per poetry settings or
-individual package (second command):
+following command can be used to update all packages as per uv settings:
 
 ```console
-$ poetry update
+$ uv sync --all-extras --dev --upgrade
 ```
 
-```console
-$ poetry update requests
-```
-
-Then activate it to your current tty / terminal session with:
+Then before any python command in tty / terminal session, run with:
 
 ```console
-$ poetry shell
+$ uv run [command]
 ```
 
 That is it! You are now ready to code!
 
-[poetry]: https://python-poetry.org/
-[poetry's documentation]: https://python-poetry.org/docs/
+[uv]: https://github.com/astral-sh/uv
+[uv's documentation]: https://docs.astral.sh/uv
 
 ### Advanced: Manual virtualenv
 
@@ -134,7 +129,7 @@ $ make watch_test
 ### Manual (just the command, please)
 
 ```console
-$ poetry run py.test
+$ uv run py.test
 ```
 
 or:
@@ -159,19 +154,19 @@ $ env PYTEST_ADDOPTS="-verbose" make start
 Pick a file:
 
 ```console
-$ env PYTEST_ADDOPTS="tests/workspace/test_builder.py" poetry run make start
+$ env PYTEST_ADDOPTS="tests/workspace/test_builder.py" uv run make start
 ```
 
 Drop into `test_automatic_rename_option()` in `tests/workspace/test_builder.py`:
 
 ```console
-$ env PYTEST_ADDOPTS="-s -x -vv tests/workspace/test_builder.py" poetry run make start
+$ env PYTEST_ADDOPTS="-s -x -vv tests/workspace/test_builder.py" uv run make start
 ```
 
 Drop into `test_automatic_rename_option()` in `tests/workspace/test_builder.py` and stop on first error:
 
 ```console
-$ env PYTEST_ADDOPTS="-s -x -vv tests/workspace/test_builder.py::test_automatic_rename_option" poetry run make start
+$ env PYTEST_ADDOPTS="-s -x -vv tests/workspace/test_builder.py::test_automatic_rename_option" uv run make start
 ```
 
 Drop into `pdb` on first error:
@@ -299,10 +294,8 @@ $ cd doc
 $ make watch
 ```
 
-If you're not source'd via `poetry shell`, you can use this:
-
 ```console
-$ make SPHINXBUILD='poetry run sphinx-build' watch
+$ make SPHINXBUILD='uv run sphinx-build' watch
 ```
 
 (tmuxp-developer-config)=
@@ -335,10 +328,10 @@ The project uses [ruff] to handle formatting, sorting imports and linting.
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run ruff
+$ uv run ruff
 ```
 
 If you setup manually:
@@ -369,10 +362,10 @@ requires [`entr(1)`].
 
 ````{tab} Fix files
 
-poetry:
+uv:
 
 ```console
-$ poetry run ruff check . --fix
+$ uv run ruff check . --fix
 ```
 
 If you setup manually:
@@ -389,10 +382,10 @@ $ ruff check . --fix
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run ruff format .
+$ uv run ruff format .
 ```
 
 If you setup manually:
@@ -417,10 +410,10 @@ $ make ruff_format
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run mypy .
+$ uv run mypy .
 ```
 
 If you setup manually: