Convert from Poetry to PEP standard pyproject.toml for uv

- Replace Poetry-specific configuration with PEP 621 project metadata
- Convert dependency groups to optional-dependencies
- Update build system to use hatchling instead of poetry-core
- Remove poetry.toml and poetry.lock files
- Update all documentation to reference uv instead of Poetry
- Test package building with standard tools

This change makes the project compatible with modern Python packaging
tools like uv while maintaining all functionality.

Author: pi-anl

.github/copilot-instructions.md

@@ -32,10 +32,9 @@ MPFlash is a command-line tool and Python library for managing MicroPython firmw
 
 # dependencies
 
-- Use uv pip for package management
-- the project is handled by poetry and all dependencies should be added to the pyproject.toml file
-- minimize the number of dependencies
--
+- Use uv for package management
+- The project uses PEP standard pyproject.toml format and all dependencies should be added to the dependencies or optional-dependencies sections
+- Minimize the number of dependencies
 
 # Writing tests
 - when asked to create an MVP - keep the number of tests to a minimum

docs/contributing.md

@@ -18,7 +18,7 @@ Thank you for your interest in contributing to MPFlash! This guide will help you
 ### Prerequisites
 
 - Python 3.9.2 or later
-- Poetry for dependency management
+- uv for dependency management (recommended) or pip
 - Git for version control
 - A MicroPython board for testing (optional but recommended)
 
@@ -42,10 +42,10 @@ Thank you for your interest in contributing to MPFlash! This guide will help you
 
 ```bash
 # Install development dependencies
-poetry install
+uv sync --all-extras
 
-# Activate virtual environment
-poetry shell
+# Or using pip (if uv not available)
+pip install -e ".[dev,test,perf]"
 ```
 
 ### Environment Configuration
@@ -66,10 +66,10 @@ PYTHONPATH=src                # For development
 
 ```bash
 # Run MPFlash to verify installation
-poetry run mpflash --help
+uv run mpflash --help
 
 # Run tests to ensure everything works
-poetry run pytest
+uv run pytest
 ```
 
 ## Code Style Guidelines
@@ -171,16 +171,13 @@ Use these tools to maintain code quality:
 
 ```bash
 # Format code
-poetry run black mpflash/
+uv run ruff format mpflash/
 
-# Sort imports
-poetry run isort mpflash/
+# Lint and fix code  
+uv run ruff check --fix mpflash/
 
-# Remove unused imports
-poetry run autoflake mpflash/ -r --in-place --remove-all-unused-imports
-
-# Type checking
-poetry run mypy mpflash/
+# Type checking (if mypy is installed)
+uv run mypy mpflash/
 ```
 
 ## Testing
@@ -306,22 +303,22 @@ def test_list_command():
 
 ```bash
 # Run all tests
-poetry run pytest
+uv run pytest
 
 # Run specific test file
-poetry run pytest tests/test_download.py
+uv run pytest tests/test_download.py
 
 # Run tests with coverage
-poetry run pytest --cov=mpflash
+uv run pytest --cov=mpflash
 
 # Run tests with verbose output
-poetry run pytest -v
+uv run pytest -v
 
 # Run tests excluding slow tests
-poetry run pytest -m "not basicgit"
+uv run pytest -m "not basicgit"
 
 # Run tests for specific functionality
-poetry run pytest -k "flash"
+uv run pytest -k "flash"
 ```
 
 ### Test Coverage
@@ -330,8 +327,8 @@ Maintain high test coverage:
 
 ```bash
 # Generate coverage report
-poetry run coverage run -m pytest
-poetry run coverage html
+uv run coverage run -m pytest
+uv run coverage html
 
 # View coverage report
 open htmlcov/index.html
@@ -528,14 +525,11 @@ To add support for a new hardware platform:
 MPFlash uses semantic versioning:
 
 ```bash
-# Patch version (bug fixes)
-poetry version patch
-
-# Minor version (new features)
-poetry version minor
-
-# Major version (breaking changes)
-poetry version major
+# Update version in pyproject.toml manually
+# Or use a tool like bump2version:
+# bump2version patch   # for bug fixes
+# bump2version minor   # for new features  
+# bump2version major   # for breaking changes
 ```
 
 ### Changelog

docs/developer.md

@@ -87,14 +87,14 @@ CREATE TABLE firmwares (
 
 ### Prerequisites
 - Python 3.9.2+
-- Poetry for dependency management
+- uv for dependency management (or pip)
 - Git for version control
 
 ### Installation
 ```bash
 git clone https://github.com/Josverl/mpflash.git
 cd mpflash
-poetry install
+uv sync --all-extras
 ```
 
 ### Environment Variables
@@ -111,13 +111,13 @@ PYTHONPATH=src                # Test source path
 ### Running Tests
 ```bash
 # Run all tests
-poetry run pytest
+uv run pytest
 
 # Run with coverage
-poetry run pytest --cov=mpflash
+uv run pytest --cov=mpflash
 
 # Run specific test categories
-poetry run pytest -m "not basicgit"
+uv run pytest -m "not basicgit"
 ```
 
 ## Code Standards
@@ -355,12 +355,12 @@ Use the configured tasks for development:
 
 ### Version Management
 ```bash
-# Update version in pyproject.toml
-poetry version patch|minor|major
+# Update version in pyproject.toml manually or with tools like bump2version
+# Build package
+uv build
 
-# Build and publish
-poetry build
-poetry publish
+# Publish to PyPI
+uv publish
 ```
 
 ### Documentation Updates

poetry.lock

@@ -1,86 +1,96 @@
 
 ############################################################
-#                      POETRY                              #
+#                    PROJECT METADATA                      #
 ############################################################
 
-[tool.poetry]
+[project]
 name = "mpflash"
 version = "1.26.0"
 description = "Flash and download tool for MicroPython firmwares"
-authors = ["Jos Verlinde <[email protected]>"]
-license = "MIT"
+authors = [
+    {name = "Jos Verlinde", email = "[email protected]"}
+]
+license = {text = "MIT"}
 readme = "README.md"
 keywords = ["MicroPython", "firmware", "flash", "download", "UF2", "esptool"]
-homepage = "https://github.com/Josverl/mpflash/blob/main/README.md"
-repository = "https://github.com/Josverl/mpflash"
 classifiers = [
-    "Programming Language :: Python :: Implementation :: MicroPython",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: MicroPython",
     "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Hardware",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.9.2"
+dependencies = [
+    "beautifulsoup4>=4.12.3",
+    "bincopy>=20.0.0",
+    "blkinfo>=0.2.0",
+    "cachetools>=5.3.0",
+    "esptool>=4.7.0",
+    "inquirer>=3.2.4",
+    "jsonlines>=4.0.0",
+    "jsons>=1.6.3",
+    "libusb>=1.0.27; sys_platform == 'win32'",
+    "pywin32>=310; sys_platform == 'win32'",
+    "loguru>=0.7.2",
+    "mpremote>=1.22.0",
+    "packaging>=24.2",
+    "platformdirs>=4.2.0",
+    "psutil>=7.0.0,<8.0.0",
+    "pygithub>=2.1.1",
+    "pyusb>=1.2.1",
+    "requests>=2.31.0",
+    "rich-click>=1.8.1",
+    "tenacity==9.0.0",
+    "cache-to-disk>=2.0.0",
+    "sqlalchemy>=2.0.41",
+    "tomli-w>=1.2.0",
+    "tomli>=2.2.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ipykernel>=6.29.5",
+    "tornado>=6.5",
+    "pandas>=2.2.3",
+]
+test = [
+    "pandas>=2.2.3",
+    "pytest>=7.1.2,<9.0.0",
+    "pytest-cov>=6.0.0",
+    "pytest-github-actions-annotate-failures>=0.1.7,<0.4.0",
+    "pytest-json-report>=1.5.0",
+    "pytest-metadata>=2.0.2,<4.0.0",
+    "pytest-mock>=3.10.0",
+    "coverage>=6.4.3,<8.0.0",
+    "distro>=1.8.0",
+    "fasteners>=0.19",
+    "mock>=4.0.3,<6.0.0",
+]
+perf = [
+    "scalene>=1.5.51",
 ]
 
-[tool.poetry.scripts]
+[project.scripts]
 mpflash = "mpflash.cli_main:mpflash"
 
-[tool.poetry.dependencies]
-python = ">=3.9.2,<3.11.0 || >3.11.0,<4.0"
-beautifulsoup4 = "^4.12.3"
-bincopy = "^20.0.0"
-blkinfo = "^0.2.0"
-cachetools = "^5.3.0"
-esptool = "^4.7.0"
-inquirer = "^3.2.4"
-jsonlines = "^4.0.0"
-jsons = "^1.6.3"
-libusb = { version = "^1.0.27", platform = "win32" }
-pywin32 = { version = "^310", platform = "win32" }
-loguru = "^0.7.2"
-mpremote = "^1.22.0"
-packaging = "^24.2"
-platformdirs = "^4.2.0"
-psutil = ">=7.0.0,<8.0.0"
-pygithub = "^2.1.1"
-pyusb = "^1.2.1"
-requests = "^2.31.0"
-rich-click = "^1.8.1"
-tenacity = "9.0.0"
-cache-to-disk = "^2.0.0"
-sqlalchemy = "^2.0.41"
-tomli-w = "^1.2.0"
-
-
-[tool.poetry.group.dev]
-optional = true
-[tool.poetry.group.dev.dependencies]
-ipykernel = "^6.29.5"
-tornado = "^6.5"      # fix 
-pandas = "^2.2.3"
-
-[tool.poetry.group.test]
-optional = true
-[tool.poetry.group.test.dependencies]
-pandas = "^2.2.3"
-pytest = ">=7.1.2,<9.0.0"
-pytest-cov = "^6.0.0"
-pytest-github-actions-annotate-failures = ">=0.1.7,<0.4.0"
-pytest-json-report = "^1.5.0"
-pytest-metadata = ">=2.0.2,<4.0.0"
-pytest-mock = "^3.10.0"
-#
-coverage = ">=6.4.3,<8.0.0"
-distro = "^1.8.0"
-fasteners = "^0.19"
-mock = ">=4.0.3,<6.0.0"
-
-
-[tool.poetry.group.perf]
-optional = true
-[tool.poetry.group.perf.dependencies]
-scalene = "^1.5.51"
+[project.urls]
+Homepage = "https://github.com/Josverl/mpflash"
+Documentation = "https://github.com/Josverl/mpflash/blob/main/README.md"
+Repository = "https://github.com/Josverl/mpflash"
+"Bug Tracker" = "https://github.com/Josverl/mpflash/issues"
 
 [build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
 ############################################################
 #                  PYTEST                                  #

poetry.toml

@@ -2,22 +2,22 @@
 
 To install test dependencies, use:
 ```
-poetry install --with test
+uv sync --extra test
 ```
 
 To run all tests, use:
 ```
-pytest
+uv run pytest
 ```
 
 To run tests with coverage report:
 ```
-pytest --cov
+uv run pytest --cov
 ```
 
 To generate an HTML coverage report:
 ```
-pytest --cov=mpflash --cov-report=html
+uv run pytest --cov=mpflash --cov-report=html
 ```
 Open the generated `htmlcov/index.html` in your browser to view the coverage report.