From 893d8a6f78953a971876b0771d7675e318691f2f Mon Sep 17 00:00:00 2001 From: dxl <64101226@qq.com> Date: Tue, 25 Aug 2026 18:40:51 +0800 Subject: [PATCH] Rename ePassport launcher to ePassport.py to avoid case collision The launcher script tools/ePassport/ePassport and the package directory tools/ePassport/epassport/ differ only in case, so on case-insensitive filesystems (Windows) they occupy the same path and a fresh clone reports the tracked script as deleted. Rename the launcher to ePassport.py and update the Makefile run target, the README, and the python3 -m epassport shim docstring. --- tools/ePassport/Makefile | 2 +- tools/ePassport/README.md | 14 +++++++------- tools/ePassport/{ePassport => ePassport.py} | 0 tools/ePassport/epassport/__main__.py | 2 +- 4 files changed, 9 insertions(+), 9 deletions(-) rename tools/ePassport/{ePassport => ePassport.py} (100%) diff --git a/tools/ePassport/Makefile b/tools/ePassport/Makefile index 5fd79964c..abf93075b 100644 --- a/tools/ePassport/Makefile +++ b/tools/ePassport/Makefile @@ -21,7 +21,7 @@ help: @echo " PYTHON=$(PYTHON) (override if your dependencies live in a venv)" run: - $(PYTHON) ./ePassport + $(PYTHON) ./ePassport.py test: $(PYTHON) -m pytest tests/ -q diff --git a/tools/ePassport/README.md b/tools/ePassport/README.md index a7d3fcc74..723294ba8 100644 --- a/tools/ePassport/README.md +++ b/tools/ePassport/README.md @@ -7,13 +7,13 @@ Everything runs **offline**. No telemetry, no cloud OCR, no network calls of any kind — every font and asset is bundled. ``` -./ePassport # normal use -./ePassport --dump DIR # open a saved dump, no hardware -./ePassport --dry-run pm3.log --dump DIR # replay a session you recorded -./ePassport --help +./ePassport.py # normal use +./ePassport.py --dump DIR # open a saved dump, no hardware +./ePassport.py --dry-run pm3.log --dump DIR # replay a session you recorded +./ePassport.py --help ``` -`ePassport` is a plain executable script — run it from anywhere, by path or +`ePassport.py` is a plain launcher script — run it directly (it has a shebang) or with `python3`, from anywhere, by path or from a symlink; there is nothing to install and no `PYTHONPATH` to set. If a dependency is missing it says which one, which interpreter it used, and the exact command to fix it. @@ -22,7 +22,7 @@ It needs an interpreter that has the requirements. With a virtualenv, either activate it first or point at it directly: ```bash -/path/to/venv/bin/python ./ePassport +/path/to/venv/bin/python ./ePassport.py ``` --- @@ -410,7 +410,7 @@ pm3 -c "hf emrtd dump -n ... -d ... -e ..." | tee pm3.log ``` Makefile run / test / format / clean -ePassport the executable; everything below is the implementation +ePassport.py the launcher; everything below is the implementation epassport/ app.py app, screens, worker threads __main__.py shim so `python3 -m epassport` still works diff --git a/tools/ePassport/ePassport b/tools/ePassport/ePassport.py similarity index 100% rename from tools/ePassport/ePassport rename to tools/ePassport/ePassport.py diff --git a/tools/ePassport/epassport/__main__.py b/tools/ePassport/epassport/__main__.py index 6096f7a4f..d957abc66 100644 --- a/tools/ePassport/epassport/__main__.py +++ b/tools/ePassport/epassport/__main__.py @@ -1,6 +1,6 @@ """Support ``python3 -m epassport``. -The real entry point is the ``ePassport`` script in the project root; this +The real entry point is the ``ePassport.py`` script in the project root; this shim only exists so the module form keeps working. """