idftool 0.3.0__tar.gz → 0.5.0__tar.gz

{idftool-0.3.0 → idftool-0.5.0}/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to this project are documented here. The format is
 based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [v0.5.0] — 2026-07-17
+
+### Changed
+- The CLI is rebuilt on [click](https://click.palletsprojects.com/) and
+  [rich-click](https://github.com/ewels/rich-click) (like esptool): `--help`,
+  usage, and errors now render in boxed panels, and commands are grouped into
+  labelled sections. Command names, arguments, options, aliases (`reflash`,
+  `list`), and behaviour are unchanged — only the help/usage and error
+  formatting differ.
+
+### Added
+- `create-table` as an alias for `convert-table`.
+- `create-nvs` and `write-nvs` now accept a pre-built NVS binary image as
+  input (auto-detected), not only a CSV — it is validated against the
+  partition size and padded to it, instead of failing when parsed as CSV.
+- A test suite: an offline suite (no hardware) plus a real-device suite that
+  cycles every command against a connected ESP, with fixtures built from a
+  small ESP-IDF app (`make test-offline` / `make test-device`).
+
+### Fixed
+- `write-bundle` now reports a clear error when a bundle entry is larger than
+  its target partition, instead of crashing with an `AttributeError`.
+
 ## [v0.3.0] — 2026-07-15
 
 ### Added
@@ -87,6 +110,7 @@ this project adheres to [Semantic Versioning](https://semver.org/).
 ### Added
 - Initial release.
 
+[v0.5.0]: https://github.com/nebkat/idftool/releases/tag/v0.5.0
 [v0.3.0]: https://github.com/nebkat/idftool/releases/tag/v0.3.0
 [v0.2.2]: https://github.com/nebkat/idftool/releases/tag/v0.2.2
 [v0.2.1]: https://github.com/nebkat/idftool/releases/tag/v0.2.1

idftool-0.5.0/Makefile

@@ -0,0 +1,62 @@
+.PHONY: build build-onefile test test-offline test-device test-device-full install install-onefile uninstall clean
+
+VENV         := .venv
+PYINSTALLER  := $(VENV)/bin/pyinstaller
+PREFIX       := $(HOME)/.local
+BINDIR       := $(PREFIX)/bin
+SHAREDIR     := $(PREFIX)/share/idftool
+
+# Device test config: `make test-device PORT=/dev/cu.usbmodem101 CHIP=esp32s3`
+PORT         :=
+CHIP         := esp32s3
+
+build: $(VENV)
+	$(PYINSTALLER) --noconfirm --distpath ./dist-onedir --workpath ./build-onedir idftool-onedir.spec
+
+build-onefile: $(VENV)
+	$(PYINSTALLER) --noconfirm --distpath ./dist --workpath ./build idftool.spec
+
+test: build
+	./dist-onedir/idftool/idftool --help >/dev/null
+
+# Offline test suite (no hardware).
+test-offline: $(VENV)
+	$(VENV)/bin/pip install -q -e ".[test]"
+	$(VENV)/bin/pytest test/test_offline.py
+
+# Real-device test suite (fast core: the quick per-command tests). Requires a connected board and
+# built fixtures (test/project/build_fixtures.sh). WILL ERASE THE DEVICE'S FLASH.
+test-device: $(VENV)
+	@test -n "$(PORT)" || { echo "Usage: make test-device PORT=/dev/... [CHIP=$(CHIP)]"; exit 2; }
+	$(VENV)/bin/pip install -q -e ".[test]"
+	$(VENV)/bin/pytest test/test_device.py --port $(PORT) --chip $(CHIP) -m "not slow"
+
+# Full device suite, including the slow full-flash dump-image / bundle round-trips. These move
+# megabytes and take many minutes (a full 16 MB dump-image is ~25 min on USB-Serial-JTAG boards).
+test-device-full: $(VENV)
+	@test -n "$(PORT)" || { echo "Usage: make test-device-full PORT=/dev/... [CHIP=$(CHIP)]"; exit 2; }
+	$(VENV)/bin/pip install -q -e ".[test]"
+	$(VENV)/bin/pytest test/test_device.py --port $(PORT) --chip $(CHIP)
+
+install: build
+	mkdir -p $(BINDIR)
+	rm -rf $(SHAREDIR)
+	mkdir -p $(dir $(SHAREDIR))
+	cp -R dist-onedir/idftool $(SHAREDIR)
+	ln -sf $(SHAREDIR)/idftool $(BINDIR)/idftool
+
+install-onefile: build-onefile
+	mkdir -p $(BINDIR)
+	cp dist/idftool $(BINDIR)/idftool
+
+uninstall:
+	rm -f $(BINDIR)/idftool
+	rm -rf $(SHAREDIR)
+
+clean:
+	rm -rf build build-onedir dist dist-onedir $(VENV)
+
+$(VENV):
+	python3 -m venv $(VENV)
+	$(VENV)/bin/pip install --upgrade pip
+	$(VENV)/bin/pip install -e . pyinstaller

{idftool-0.3.0 → idftool-0.5.0}/PKG-INFO

@@ -1,15 +1,19 @@
 Metadata-Version: 2.4
 Name: idftool
-Version: 0.3.0
+Version: 0.5.0
 Summary: Utility for flashing, provisioning, and interacting with Espressif SOCs running ESP-IDF
 License-Expression: Apache-2.0
 Project-URL: Source, https://github.com/nebkat/idftool
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
+Requires-Dist: click>=8.1
+Requires-Dist: rich-click>=1.8
 Requires-Dist: esptool~=5.2.0
 Requires-Dist: esp-idf-defs~=0.1.3
 Requires-Dist: esp-idf-nvs-partition-gen~=0.2.0
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
 Dynamic: license-file
 
 # idftool