chore: replace pipenv with poetry

Author: runemalm

.github/workflows/release.yml

@@ -30,13 +30,15 @@ jobs:
         with:
           python-version: '3.12'
 
-      - name: Install pipenv and dependencies
+      - name: Install Poetry
         run: |
           python -m pip install --upgrade pip
-          pip install pipenv
-          pipenv install --dev
+          pip install poetry
 
-      - name: Auto bump version
+      - name: Install dependencies
+        run: poetry install --with dev
+
+      - name: Bump version
         id: bump
         run: |
           python scripts/bump_version.py
@@ -52,7 +54,7 @@ jobs:
           git push
 
       - name: Build package
-        run: pipenv run python -m build
+        run: poetry build
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/run-unittests.yml

@@ -28,18 +28,18 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: Install pipenv
+      - name: Install Poetry
         run: |
           python -m pip install --upgrade pip
-          pip install pipenv
+          pip install poetry
 
       - name: Install dependencies
-        run: pipenv install --dev --deploy
+        run: poetry install --with dev
 
       - name: Run unittests
         run: |
           mkdir -p reports
-          PYTHONPATH=./src:./tests pipenv run pytest ./tests/unit --junitxml=reports/report.xml
+          PYTHONPATH=./src:./tests poetry run pytest ./tests/unit --junitxml=reports/report.xml
 
       - name: Upload JUnit report
         uses: actions/upload-artifact@v4

.gitignore

@@ -18,8 +18,6 @@ __pycache__/
 env/
 venv/
 ENV/
-env.bak/
-venv.bak/
 
 # Logs
 *.log

Makefile

@@ -30,83 +30,60 @@ help:
 
 .PHONY: test
 test: ## run test suite
-	PYTHONPATH=$(SRC):$(TESTS) pipenv run pytest $(TESTS)
+	PYTHONPATH=$(SRC):$(TESTS) poetry run pytest $(TESTS)
 
 .PHONY: test-all-versions
-test-all-versions: ## Run tests across all supported Python versions with pyenv + pipenv
+test-all-versions: ## Run tests across all supported Python versions with pyenv + poetry
 	@for PY in 3.9 3.10 3.11 3.12; do \
 		echo "\n>>> Running tests with Python $$PY"; \
 		PYTHON_BIN=$$(pyenv prefix $$PY)/bin/python; \
 		VENV_DIR=.venv-$$PY; \
 		$$PYTHON_BIN -m venv $$VENV_DIR && \
-		$$VENV_DIR/bin/pip install --upgrade pip && \
-		$$VENV_DIR/bin/pip install pipenv && \
-		cd $(PWD) && \
-		$$VENV_DIR/bin/pipenv install --dev --deploy && \
-		PYTHONPATH=./src:./tests $$VENV_DIR/bin/pipenv run pytest ./tests/unit || exit 1; \
-		rm -rf $$VENV_DIR; \
+		. $$VENV_DIR/bin/activate && \
+		pip install --upgrade pip && \
+		pip install poetry && \
+		poetry install --with dev && \
+		PYTHONPATH=./src:./tests poetry run pytest ./tests || exit 1; \
+		deactivate && rm -rf $$VENV_DIR; \
 	done
 
 .PHONY: test-version
-test-version: ## Run tests with a specific Python version via pyenv + pipenv. Usage: make test-version PY=3.10
+test-version: ## Run tests with a specific Python version via pyenv + poetry. Usage: make test-version PY=3.10
 	@if [ -z "$(PY)" ]; then \
 		echo "❌ PY is required. Usage: make test-version PY=3.10"; exit 1; \
 	fi
 	PYTHON_BIN=$$(pyenv prefix $(PY))/bin/python; \
 	VENV_DIR=.venv-$(PY); \
 	$$PYTHON_BIN -m venv $$VENV_DIR && \
-	$$VENV_DIR/bin/pip install --upgrade pip && \
-	$$VENV_DIR/bin/pip install pipenv && \
-	cd $(PWD) && \
-	$$VENV_DIR/bin/pipenv install --dev --deploy && \
-	PYTHONPATH=./src:./tests $$VENV_DIR/bin/pipenv run pytest ./tests/unit || exit 1; \
-	rm -rf $$VENV_DIR
-
-##########################################################################
-# DOCS
-##########################################################################
-
-.PHONY: sphinx-quickstart
-sphinx-quickstart: ## run the sphinx quickstart
-	pipenv run docker run -it --rm -v $(PWD)/docs:/docs sphinxdoc/sphinx sphinx-quickstart
-
-.PHONY: sphinx-html
-sphinx-html: ## build the sphinx html
-	pipenv run make -C docs html
-
-.PHONY: sphinx-rebuild
-sphinx-rebuild: ## re-build the sphinx docs
-	cd $(DOCS) && \
-	pipenv run make clean && pipenv run make html
-
-.PHONY: sphinx-autobuild
-sphinx-autobuild: ## activate autobuild of docs
-	cd $(DOCS) && \
-	pipenv run sphinx-autobuild . _build/html --watch $(SRC)
+	. $$VENV_DIR/bin/activate && \
+	pip install --upgrade pip && \
+	pip install poetry && \
+	poetry install --with dev && \
+	PYTHONPATH=./src:./tests poetry run pytest ./tests || exit 1; \
+	deactivate && rm -rf $$VENV_DIR
 
 ################################################################################
-# RELEASE (LOCALLY)
+# RELEASE
 ################################################################################
 
 .PHONY: build
 build: ## build the python package
-	pipenv run python setup.py sdist bdist_wheel
+	poetry build
 
 .PHONY: clean
 clean: ## clean the build
-	python setup.py clean
 	rm -rf build dist
 	find . -type f -name '*.py[co]' -delete
 	find . -type d -name __pycache__ -exec rm -rf {} +
 	find . -type d -name '*.egg-info' -exec rm -rf {} +
 
 .PHONY: upload-test
-upload-test: ## upload package to testpypi repository
-	TWINE_USERNAME=$(PYPI_USERNAME_TEST) TWINE_PASSWORD=$(PYPI_PASSWORD_TEST) pipenv run twine upload --repository testpypi --skip-existing --repository-url https://test.pypi.org/legacy/ dist/*
+upload-test: ## upload package to test.pypi.org
+	poetry publish --repository testpypi
 
 .PHONY: upload
-upload: ## upload package to pypi repository
-	TWINE_USERNAME=$(PYPI_USERNAME) TWINE_PASSWORD=$(PYPI_PASSWORD) pipenv run twine upload --skip-existing dist/*
+upload: ## upload package to PyPI
+	poetry publish
 
 .PHONY: act-release
 act-release: ## Run release workflow locally with act
@@ -115,17 +92,21 @@ act-release: ## Run release workflow locally with act
 .PHONY: test-install-all-py
 test-install-all-py:
 	@for PY in 3.9 3.10 3.11 3.12; do \
-		echo "\n>>> Testing with Python $$PY"; \
-		PYTHON_BIN=$$(pyenv prefix $$PY)/bin/python; \
-		VENV_DIR=.venv-$$PY; \
-		$$PYTHON_BIN -m venv $$VENV_DIR && \
-		$$VENV_DIR/bin/pip install --upgrade pip && \
-		$$VENV_DIR/bin/pip install --index-url https://test.pypi.org/simple/ \
-		                             --extra-index-url https://pypi.org/simple \
-		                             codius && \
-		mkdir -p /tmp/test-codius && \
-		$$VENV_DIR/bin/codius /tmp/test-codius --version || echo "❌ Failed to run codius with Python $$PY"; \
-		rm -rf $$VENV_DIR /tmp/test-codius; \
+		( \
+			set -e; \
+			echo "\n>>> Testing with Python $$PY"; \
+			PYTHON_BIN=$$(pyenv prefix $$PY)/bin/python; \
+			VENV_DIR=.venv-$$PY; \
+			TRAP_CMD="rm -rf $$VENV_DIR /tmp/test-codius"; \
+			trap "$$TRAP_CMD" EXIT; \
+			$$PYTHON_BIN -m venv $$VENV_DIR; \
+			$$VENV_DIR/bin/pip install --upgrade pip; \
+			$$VENV_DIR/bin/pip install --index-url https://test.pypi.org/simple/ \
+			                             --extra-index-url https://pypi.org/simple \
+			                             codius; \
+			mkdir -p /tmp/test-codius; \
+			$$VENV_DIR/bin/codius /tmp/test-codius --version; \
+		) || exit 1; \
 	done
 
 .PHONY: test-install-version
@@ -150,78 +131,66 @@ test-install-version: ## Test installing package from TestPyPI with a specific P
 
 .PHONY: black
 black: ## format code using black
-	pipenv run black --line-length 88 $(SRC)
+	poetry run black --line-length 88 $(SRC)
 
 .PHONY: black-check
 black-check: ## check code don't violate black formatting rules
-	pipenv run black --check --line-length 88 $(SRC)
+	poetry run black --check --line-length 88 $(SRC)
 
 .PHONY: flake
 flake: ## lint code with flake
-	pipenv run flake8 --max-line-length=200 $(SRC)
+	poetry run flake8 --max-line-length=200 $(SRC)
 
 .PHONY: pre-commit-install
 pre-commit-install: ## install the pre-commit git hook
-	pipenv run pre-commit install
+	poetry run pre-commit install
 
 .PHONY: pre-commit-run
 pre-commit-run: ## run the pre-commit hooks
-	pipenv run pre-commit run --all-files
+	poetry run pre-commit run --all-files
 
 ################################################################################
-# PIPENV
+# POETRY
 ################################################################################
 
-.PHONY: pipenv-rm
-pipenv-rm: ## remove the virtual environment
-	pipenv --rm
-
-.PHONY: pipenv-install
-pipenv-install: ## setup the virtual environment
-	pipenv install --dev
-
-.PHONY: pipenv-install-package
-pipenv-install-package: ## install a package (uses PACKAGE)
-	pipenv install $(PACKAGE)
-
-.PHONY: pipenv-install-package-dev
-pipenv-install-package-dev: ## install a dev package (uses PACKAGE)
-	pipenv install --dev $(PACKAGE)
+.PHONY: poetry-install-with-dev
+poetry-install-with-dev: ## Install all dependencies including dev group
+	poetry install --with dev
 
-.PHONY: pipenv-graph
-pipenv-graph: ## Check installed packages
-	pipenv graph
+.PHONY: poetry-env-remove
+poetry-env-remove: ## Remove the Poetry virtual environment
+	poetry env info --path >/dev/null 2>&1 && poetry env remove python || echo "No Poetry environment found."
 
-.PHONY: pipenv-generate-requirements
-pipenv-generate-requirements: ## Check a requirements.txt
-	pipenv lock -r > requirements.txt
+.PHONY: poetry-shell
+poetry-shell: ## Activate the Poetry virtual environment
+	poetry shell
 
-.PHONY: pipenv-shell
-pipenv-shell: ## Activate the virtual environment
-	pipenv shell
+.PHONY: poetry-env-info-path
+poetry-env-info-path: ## Show the path to the Poetry virtual environment
+	poetry env info --path
 
-.PHONY: pipenv-venv
-pipenv-venv: ## Show the path to the venv
-	pipenv --venv
-
-.PHONY: pipenv-lock-and-install
-pipenv-lock-and-install: ## Lock the pipfile and install (after updating Pipfile)
-	pipenv lock && \
-	pipenv install --dev
-
-.PHONY: pipenv-pip-freeze
-pipenv-pip-freeze: ## Run pip freeze in the virtual environment
-	pipenv run pip freeze
+.PHONY: poetry-add
+poetry-add: ## Install a runtime package (uses PACKAGE)
+	@if [ -z "$(PACKAGE)" ]; then \
+		echo "❌ PACKAGE is required. Usage: make poetry-add PACKAGE=your-package"; exit 1; \
+	fi
+	poetry add $(PACKAGE)
 
-.PHONY: pipenv-sync-setup
-pipenv-sync-setup: ## Update install_requires in setup.py from Pipfile
-	pipenv run python scripts/sync_setup.py --sync Pipfile setup.py
+.PHONY: poetry-add-dev
+poetry-add-dev: ## Install a dev package (uses PACKAGE)
+	@if [ -z "$(PACKAGE)" ]; then \
+		echo "❌ PACKAGE is required. Usage: make poetry-add-dev PACKAGE=your-package"; exit 1; \
+	fi
+	poetry add --group dev $(PACKAGE)
 
-.PHONY: pipenv-sync-setup-dry-run
-pipenv-sync-setup-dry-run: ## Dry run: preview install_requires from Pipfile
-	pipenv run python scripts/sync_setup.py --dry-run Pipfile setup.py
+.PHONY: poetry-show-tree
+poetry-show-tree: ## Show dependency tree
+	poetry show --tree
 
-.PHONY: pipenv-install-cli-editable
-pipenv-install-cli-editable: ## Install the package in editable mode (for CLI use)
-	pipenv run pip install -e .
+.PHONY: poetry-export-requirements-txt
+poetry-export-requirements-txt: ## Export requirements.txt (for Docker or CI)
+	poetry export --without-hashes --format=requirements.txt > requirements.txt
 
+.PHONY: poetry-show-codius
+poetry-show-codius: ## Show installed details for the codius package
+	poetry run pip show -f codius || echo "❌ codius is not installed yet. Run 'make poetry-install'"