ci,pkg: poetry -> uv (#479)

# Changes

## 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,31 +27,30 @@ jobs:
             python_files:
               - 'libvcs/**'
               - 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
         if: env.PUBLISH == 'true'
-        run: pipx install "poetry==1.8.4"
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
 
       - name: Set up Python ${{ matrix.python-version }}
         if: env.PUBLISH == 'true'
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'poetry'
+        run: uv python install ${{ matrix.python-version }}
 
       - name: Install dependencies [w/ docs]
         if: env.PUBLISH == 'true'
-        run: poetry install --with=docs,lint
+        run: uv sync --all-extras --dev
 
       - 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

@@ -19,34 +19,33 @@ jobs:
         python-version: ['3.9', '3.13']
     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: poetry install --with=docs,test,coverage,lint
+        run: uv sync --all-extras --dev
 
       - name: Lint with ruff check
-        run: poetry run ruff check .
+        run: uv run ruff check .
 
       - name: Format with ruff
-        run: poetry run ruff format . --check
+        run: uv run ruff format . --check
 
       - name: Lint with mypy
-        run: poetry run mypy .
+        run: uv run mypy .
 
       - name: Print python versions
         run: |
           python -V
-          poetry run python -V
+          uv run python -V
 
       - name: Test with pytest
-        run: poetry run py.test --cov=./ --cov-append --cov-report=xml
+        run: uv run py.test --cov=./ --cov-append --cov-report=xml
         env:
           COV_CORE_SOURCE: .
           COV_CORE_CONFIG: .coveragerc
@@ -67,21 +66,18 @@ 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: 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')
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           user: __token__

.tmuxp.yaml

@@ -1,23 +1,15 @@
 session_name: libvcs
 start_directory: ./ # load session relative to config location (project root).
+shell_command_before:
+- uv virtualenv --quiet > /dev/null 2>&1 && clear
 windows:
 - window_name: libvcs
   focus: True
   layout: main-horizontal
   options:
-    main-pane-height: 35
+    main-pane-height: 67%
   panes:
   - focus: true
-  - pane
-  - make watch_mypy
-  - make start
-- window_name: docs
-  layout: main-horizontal
-  options:
-    main-pane-height: 35
-  start_directory: docs/
-  panes:
-  - focus: true
-  - pane
+  - pane 
   - pane
   - make start

.tool-versions

@@ -1,2 +1,2 @@
-poetry 1.8.4
+uv 0.5.4
 python 3.13.0 3.12.7 3.11.10 3.10.15 3.9.20 3.8.20 3.7.17

CHANGES

@@ -15,6 +15,14 @@ $ pip install --user --upgrade --pre libvcs
 
 <!-- Maintainers, insert changes / features for the next release here -->
 
+### Development
+
+#### Project and package management: poetry to uv (#479)
+
+[uv] is the new package and project manager for the project, replacing Poetry.
+
+[uv]: https://github.com/astral-sh/uv
+
 ## libvcs 0.33.0 (2024-10-13)
 
 ### New features

Makefile

@@ -13,10 +13,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 ${ALL_FILES} | entr -c $(MAKE) test; else $(MAKE) test entr_warn; fi
@@ -34,16 +34,16 @@ design_docs:
 	$(MAKE) -C docs design
 
 ruff_format:
-	poetry run ruff format .
+	uv run ruff format .
 
 ruff:
-	poetry run ruff .
+	uv run ruff .
 
 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
@@ -52,7 +52,7 @@ format_markdown:
 	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
 
@@ -173,16 +173,16 @@ serve:
 	@echo 'docs server running at http://localhost:${HTTP_PORT}/'
 	@echo
 	@echo '=============================================================='
-	poetry run python -m http.server ${HTTP_PORT} --directory _build/html
+	uv run python -m http.server ${HTTP_PORT} --directory _build/html
 
 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} \
+	uv run sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --port ${HTTP_PORT} \
 		--watch ".." --ignore "../.*" --ignore "_build" -a \
 		$(O)

docs/contributing/workflow.md

@@ -4,7 +4,7 @@
 
 ## Development environment
 
-[poetry] is a required package to develop.
+[uv] is a required package to develop.
 
 ```console
 $ git clone https://github.com/vcs-python/libvcs.git
@@ -15,15 +15,15 @@ $ cd libvcs
 ```
 
 ```console
-$ poetry install -E "docs test coverage lint"
+$ uv install -E "docs test coverage lint"
 ```
 
 Makefile commands prefixed with `watch_` will watch files and rerun.
 
 ## Tests
 
 ```console
-$ poetry run py.test
+$ uv run py.test
 ```
 
 Helpers: `make test` Rerun tests on file change: `make watch_test` (requires [entr(1)])
@@ -57,10 +57,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:
@@ -91,10 +91,10 @@ requires [`entr(1)`].
 
 ````{tab} Fix files
 
-poetry:
+uv:
 
 ```console
-$ poetry run ruff . --fix
+$ uv run ruff . --fix
 ```
 
 If you setup manually:
@@ -111,10 +111,10 @@ $ ruff . --fix
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run ruff format .
+$ uv run ruff format .
 ```
 
 If you setup manually:
@@ -139,10 +139,10 @@ $ make ruff_format
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run mypy .
+$ uv run mypy .
 ```
 
 If you setup manually:
@@ -176,10 +176,10 @@ requires [`entr(1)`].
 
 ````{tab} Command
 
-poetry:
+uv:
 
 ```console
-$ poetry run mypy .
+$ uv run mypy .
 ```
 
 If you setup manually:
@@ -245,7 +245,7 @@ After `git push` and `git push --tags`, CI will automatically build and deploy t
 
 ### Releasing (manual)
 
-As of 0.10, [poetry] handles virtualenv creation, package requirements, versioning, building, and
+As of 0.10, [uv] handles virtualenv creation, package requirements, versioning, building, and
 publishing. Therefore there is no setup.py or requirements files.
 
 Update `__version__` in `__about__.py` and `pyproject.toml`::
@@ -254,10 +254,10 @@ Update `__version__` in `__about__.py` and `pyproject.toml`::
     git tag v0.1.1
     git push
     git push --tags
-    poetry build
-    poetry publish
+    uv build
+    uv publish
 
-[poetry]: https://python-poetry.org/
+[uv]: https://github.com/astral-sh/uv 
 [entr(1)]: http://eradman.com/entrproject/
 [`entr(1)`]: http://eradman.com/entrproject/
 [ruff format]: https://docs.astral.sh/ruff/formatter/