pyi-doctor 1.0.0__tar.gz

pyi_doctor-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 서주원 (OMEGA SYSTEMS)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyi_doctor-1.0.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: pyi-doctor
+Version: 1.0.0
+Summary: Build PyInstaller apps as portable exe + installer, then check startup, antivirus risk factors and bundled licenses.
+Author-email: "서주원 (OMEGA SYSTEMS)" <seodes105@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sjw0328/pyi-doctor
+Project-URL: Issues, https://github.com/sjw0328/pyi-doctor/issues
+Keywords: pyinstaller,installer,inno-setup,antivirus,false-positive,sbom,windows,packaging
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Software Distribution
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyinstaller>=6.0
+Requires-Dist: tomli>=1.1; python_version < "3.11"
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# pyi-doctor
+
+[한국어 문서 (Korean)](README.ko.md)
+
+**Build a PyInstaller app as a portable exe and a setup wizard in one call, then check whether it starts outside your machine, which antivirus false-positive risk factors it carries, and which third-party licenses it bundles.**
+
+Tools such as briefcase and pyship focus on shipping an app. pyi-doctor focuses on the problems that tend to show up after shipping a PyInstaller build: "it works on my PC only", "Windows Defender calls it a trojan", and "which licenses am I redistributing?".
+
+```python
+from pyi_doctor import Project, build_all
+
+project = Project(entry="main.py", name="MyApp", version="1.0.0", publisher="Me")
+report = build_all(project, log=print)
+print(report.ok)
+```
+
+```
+dist/release/
+├── MyApp-1.0.0-portable-win64.zip   # onedir build (+ THIRD_PARTY_LICENSES.txt)
+├── MyApp-1.0.0-win64.exe            # single-file build (if onefile = true)
+├── MyApp-1.0.0-setup.exe            # Inno Setup wizard (Windows + Inno Setup)
+├── MyApp-1.0.0.cdx.json             # CycloneDX 1.5 SBOM
+├── THIRD_PARTY_LICENSES.txt
+├── SHA256SUMS.txt
+├── av-submission-notes.txt          # text for false-positive submission forms
+├── report.md / report.json
+```
+
+## What it does
+
+| Step | What happens |
+|---|---|
+| Portable build | PyInstaller **onedir** build (default) with `--noupx`, a Windows version resource and your icon. Optional **onefile** build. |
+| Installer | Writes an Inno Setup script (fixed AppId for upgrades, per-user install by default, modern wizard, Start menu / optional desktop shortcut, uninstaller, English + Korean and other languages) and compiles it when Inno Setup 6.3+ is installed. |
+| Smoke test | Copies each build to a temp folder and starts it with Python's environment variables and folders removed from the environment. Reports missing modules, data files and DLL errors with hints (e.g. "add 'x' to hidden_imports"). |
+| Antivirus diagnosis | Reads the PE file (pure Python) and scores commonly cited risk factors: UPX sections, onefile, missing version resource, no signature, prebuilt bootloader, default icon. On Windows it can also scan with the local Microsoft Defender CLI (no remediation). |
+| Licenses + SBOM | Maps bundled modules (from PyInstaller's TOC files) to installed distributions and writes `THIRD_PARTY_LICENSES.txt` (also placed next to the exe and inside the installer) and a CycloneDX SBOM. |
+| Release folder | Collects the files, writes `SHA256SUMS.txt`, a report and false-positive submission notes. Optional upload to a GitHub release through the GitHub CLI (`gh`). |
+
+Only the onedir build is required to succeed; every other step records its own status, so a missing tool (for example Inno Setup) does not stop the rest.
+
+## Install
+
+```bash
+pip install pyi-doctor
+```
+
+Requirements: Python 3.9+, PyInstaller 6+ (installed as a dependency). The installer step needs Windows and [Inno Setup](https://jrsoftware.org/isinfo.php) 6.3 or newer (not bundled; set `PYI_DOCTOR_ISCC` if it is not in the default location). The GitHub upload needs the [GitHub CLI](https://cli.github.com/).
+
+## Configuration
+
+Add a table to your `pyproject.toml` (`pyi-doctor init --write` adds a template):
+
+```toml
+[tool.pyi-doctor]
+entry = "main.py"
+name = "MyApp"
+version = "1.0.0"
+publisher = "Your Name"
+description = "What the app does"
+icon = "assets/app.ico"
+app_id = "PUT-A-FIXED-GUID-HERE"   # keep it fixed after the first release
+console = false
+onefile = false
+license_file = "LICENSE"            # shown in the installer
+add_data = ["assets=assets"]
+hidden_imports = []
+languages = ["english", "korean"]
+```
+
+`name`, `version` and `description` fall back to `[project]`. If `app_id` is not set, a GUID is derived from publisher and name; changing either then changes the GUID, so set it explicitly before the first release.
+
+<details>
+<summary>All settings</summary>
+
+| Key | Default | Meaning |
+|---|---|---|
+| `entry` | required | Script PyInstaller starts from |
+| `name` | required | Exe / installer name |
+| `version` | `0.1.0` | Version string; the first four numbers go into Windows version resources |
+| `publisher`, `description`, `copyright`, `website` | `""` | Metadata for version resources, installer and reports |
+| `icon` | none | `.ico` file |
+| `app_id` | derived | Installer GUID |
+| `console` | `false` | `true` for command-line apps |
+| `onefile` | `false` | Also build a single-file exe |
+| `upx` | `false` | Allow UPX (adds a high-weight risk factor) |
+| `hidden_imports`, `excludes` | `[]` | Passed to PyInstaller |
+| `add_data` | `[]` | `"src=dest"`, `"src;dest"` or `["src", "dest"]` |
+| `pyinstaller_args` | `[]` | Extra PyInstaller arguments |
+| `license_file` | none | License page in the installer |
+| `privileges` | `lowest` | `lowest` (per-user, can be raised in the wizard) or `admin` |
+| `languages` | `["english", "korean"]` | Installer languages available in your Inno Setup |
+| `smoke_args`, `smoke_timeout` | `[]`, `15` | Arguments and seconds for the smoke test |
+| `output_dir`, `work_dir` | `dist`, `build` | Output folders |
+
+</details>
+
+## Command line
+
+```bash
+pyi-doctor build                        # full pipeline from pyproject.toml
+pyi-doctor build --onefile --no-defender
+pyi-doctor build --github-release v1.0.0 --github-repo me/myapp
+pyi-doctor diagnose dist/portable/MyApp/MyApp.exe   # score any exe
+pyi-doctor smoke dist/portable/MyApp/MyApp.exe -- --version
+pyi-doctor iss                          # write the Inno Setup script only
+pyi-doctor init --write                 # add [tool.pyi-doctor] to pyproject.toml
+```
+
+## Library API
+
+```python
+from pyi_doctor import Project, build_portable, build_installer, smoke_test, diagnose, collect_licenses
+
+project = Project.from_pyproject("pyproject.toml")
+onedir = build_portable(project)                     # Artifact(kind="onedir", path=..., folder=...)
+result = smoke_test(onedir.path, timeout=10)         # SmokeResult(ok, status, missing_modules, ...)
+risk = diagnose(onedir.path, icon_configured=True)   # Diagnosis(score, level, factors, defender, ...)
+setup = build_installer(project, onedir.folder)      # Windows + Inno Setup
+packages, mode = collect_licenses(project.work_path / "onedir")
+```
+
+`build_all(project, onefile=..., installer=..., smoke_test=..., diagnose=..., defender=..., licenses=..., sbom_file=..., github_tag=...)` runs everything and returns a `Report` with `.ok`, `.steps`, `.to_markdown()` and `.to_json()`.
+
+## About the antivirus score
+
+The score adds fixed weights for factors that are commonly reported to affect heuristic detection of PyInstaller executables (UPX 30, onefile 20, no version resource 15, unsigned 15, prebuilt bootloader 10, default icon 5). It is meant for comparing your own builds. It does not predict the verdict of Microsoft Defender or any other product, and a low score does not mean a file will not be flagged.
+
+pyi-doctor does not obfuscate, encrypt or otherwise hide code from scanners. It applies ordinary distribution practices (version information, no packer, onedir layout, signing advice) and helps you prepare a false-positive report. Code signing with a certificate from a trusted authority is generally the most effective measure and is outside the scope of this tool.
+
+## Measured on the bundled example
+
+`examples/hello`, Linux x86_64, Python 3.13, PyInstaller 6.22.3 (installer step skipped because it needs Windows):
+
+| Step | Time |
+|---|---|
+| onedir build | 4.5 s |
+| onefile build | 12.2 s |
+| licenses + SBOM | 0.8 s |
+| smoke test (both builds) | 0.6 s |
+| diagnosis | < 0.1 s |
+| release folder (zip + checksums) | 1.5 s |
+| **total** | **19.7 s** |
+
+Test suite: 138 tests (including 2 real PyInstaller builds) on Python 3.9, 3.11 and 3.13 on Linux. Windows-specific paths (version resource, Inno Setup compilation, Defender scan, error-dialog detection in the smoke test) run in the Windows CI jobs.
+
+## Known limitations
+
+- Windows features (installer, version resource, Defender scan) need Windows. On other systems the `.iss` script is still written.
+- The smoke test is a heuristic. It removes Python from the environment but does not reproduce a clean PC (installed DLLs, Visual C++ runtime, fonts, etc.). GUI apps that keep running are counted as started. Windowed apps that crash show a PyInstaller error dialog; on Windows pyi-doctor looks for that dialog by window title, which may not catch every case.
+- The bootloader check compares the installed PyInstaller bootloader with the hashes recorded in its wheel. It describes the PyInstaller in the current environment, not an exe built elsewhere.
+- License notices come from package metadata, which can be missing or wrong; packages loaded dynamically may be missed. Review the generated file.
+- Only PyInstaller is supported (no Nuitka / cx_Freeze). No code signing and no auto-update.
+
+## Disclaimer
+
+pyi-doctor is rule-based and may miss problems or report problems that do not exist. Its reports are informational and do not replace your own testing, review of licenses, or obligations under applicable law; checking the results and complying with license terms and laws remain the user's responsibility. The software is provided "AS IS", without warranty of any kind, under the MIT License.
+
+pyi-doctor is an independent project and is not affiliated with or endorsed by the PyInstaller project, Jordan Russell / Inno Setup, Microsoft, or GitHub. Product names are trademarks of their respective owners.
+
+## License
+
+MIT © 2026 서주원 (OMEGA SYSTEMS) · Contact: seodes105@gmail.com

pyi_doctor-1.0.0/README.md

@@ -0,0 +1,163 @@
+# pyi-doctor
+
+[한국어 문서 (Korean)](README.ko.md)
+
+**Build a PyInstaller app as a portable exe and a setup wizard in one call, then check whether it starts outside your machine, which antivirus false-positive risk factors it carries, and which third-party licenses it bundles.**
+
+Tools such as briefcase and pyship focus on shipping an app. pyi-doctor focuses on the problems that tend to show up after shipping a PyInstaller build: "it works on my PC only", "Windows Defender calls it a trojan", and "which licenses am I redistributing?".
+
+```python
+from pyi_doctor import Project, build_all
+
+project = Project(entry="main.py", name="MyApp", version="1.0.0", publisher="Me")
+report = build_all(project, log=print)
+print(report.ok)
+```
+
+```
+dist/release/
+├── MyApp-1.0.0-portable-win64.zip   # onedir build (+ THIRD_PARTY_LICENSES.txt)
+├── MyApp-1.0.0-win64.exe            # single-file build (if onefile = true)
+├── MyApp-1.0.0-setup.exe            # Inno Setup wizard (Windows + Inno Setup)
+├── MyApp-1.0.0.cdx.json             # CycloneDX 1.5 SBOM
+├── THIRD_PARTY_LICENSES.txt
+├── SHA256SUMS.txt
+├── av-submission-notes.txt          # text for false-positive submission forms
+├── report.md / report.json
+```
+
+## What it does
+
+| Step | What happens |
+|---|---|
+| Portable build | PyInstaller **onedir** build (default) with `--noupx`, a Windows version resource and your icon. Optional **onefile** build. |
+| Installer | Writes an Inno Setup script (fixed AppId for upgrades, per-user install by default, modern wizard, Start menu / optional desktop shortcut, uninstaller, English + Korean and other languages) and compiles it when Inno Setup 6.3+ is installed. |
+| Smoke test | Copies each build to a temp folder and starts it with Python's environment variables and folders removed from the environment. Reports missing modules, data files and DLL errors with hints (e.g. "add 'x' to hidden_imports"). |
+| Antivirus diagnosis | Reads the PE file (pure Python) and scores commonly cited risk factors: UPX sections, onefile, missing version resource, no signature, prebuilt bootloader, default icon. On Windows it can also scan with the local Microsoft Defender CLI (no remediation). |
+| Licenses + SBOM | Maps bundled modules (from PyInstaller's TOC files) to installed distributions and writes `THIRD_PARTY_LICENSES.txt` (also placed next to the exe and inside the installer) and a CycloneDX SBOM. |
+| Release folder | Collects the files, writes `SHA256SUMS.txt`, a report and false-positive submission notes. Optional upload to a GitHub release through the GitHub CLI (`gh`). |
+
+Only the onedir build is required to succeed; every other step records its own status, so a missing tool (for example Inno Setup) does not stop the rest.
+
+## Install
+
+```bash
+pip install pyi-doctor
+```
+
+Requirements: Python 3.9+, PyInstaller 6+ (installed as a dependency). The installer step needs Windows and [Inno Setup](https://jrsoftware.org/isinfo.php) 6.3 or newer (not bundled; set `PYI_DOCTOR_ISCC` if it is not in the default location). The GitHub upload needs the [GitHub CLI](https://cli.github.com/).
+
+## Configuration
+
+Add a table to your `pyproject.toml` (`pyi-doctor init --write` adds a template):
+
+```toml
+[tool.pyi-doctor]
+entry = "main.py"
+name = "MyApp"
+version = "1.0.0"
+publisher = "Your Name"
+description = "What the app does"
+icon = "assets/app.ico"
+app_id = "PUT-A-FIXED-GUID-HERE"   # keep it fixed after the first release
+console = false
+onefile = false
+license_file = "LICENSE"            # shown in the installer
+add_data = ["assets=assets"]
+hidden_imports = []
+languages = ["english", "korean"]
+```
+
+`name`, `version` and `description` fall back to `[project]`. If `app_id` is not set, a GUID is derived from publisher and name; changing either then changes the GUID, so set it explicitly before the first release.
+
+<details>
+<summary>All settings</summary>
+
+| Key | Default | Meaning |
+|---|---|---|
+| `entry` | required | Script PyInstaller starts from |
+| `name` | required | Exe / installer name |
+| `version` | `0.1.0` | Version string; the first four numbers go into Windows version resources |
+| `publisher`, `description`, `copyright`, `website` | `""` | Metadata for version resources, installer and reports |
+| `icon` | none | `.ico` file |
+| `app_id` | derived | Installer GUID |
+| `console` | `false` | `true` for command-line apps |
+| `onefile` | `false` | Also build a single-file exe |
+| `upx` | `false` | Allow UPX (adds a high-weight risk factor) |
+| `hidden_imports`, `excludes` | `[]` | Passed to PyInstaller |
+| `add_data` | `[]` | `"src=dest"`, `"src;dest"` or `["src", "dest"]` |
+| `pyinstaller_args` | `[]` | Extra PyInstaller arguments |
+| `license_file` | none | License page in the installer |
+| `privileges` | `lowest` | `lowest` (per-user, can be raised in the wizard) or `admin` |
+| `languages` | `["english", "korean"]` | Installer languages available in your Inno Setup |
+| `smoke_args`, `smoke_timeout` | `[]`, `15` | Arguments and seconds for the smoke test |
+| `output_dir`, `work_dir` | `dist`, `build` | Output folders |
+
+</details>
+
+## Command line
+
+```bash
+pyi-doctor build                        # full pipeline from pyproject.toml
+pyi-doctor build --onefile --no-defender
+pyi-doctor build --github-release v1.0.0 --github-repo me/myapp
+pyi-doctor diagnose dist/portable/MyApp/MyApp.exe   # score any exe
+pyi-doctor smoke dist/portable/MyApp/MyApp.exe -- --version
+pyi-doctor iss                          # write the Inno Setup script only
+pyi-doctor init --write                 # add [tool.pyi-doctor] to pyproject.toml
+```
+
+## Library API
+
+```python
+from pyi_doctor import Project, build_portable, build_installer, smoke_test, diagnose, collect_licenses
+
+project = Project.from_pyproject("pyproject.toml")
+onedir = build_portable(project)                     # Artifact(kind="onedir", path=..., folder=...)
+result = smoke_test(onedir.path, timeout=10)         # SmokeResult(ok, status, missing_modules, ...)
+risk = diagnose(onedir.path, icon_configured=True)   # Diagnosis(score, level, factors, defender, ...)
+setup = build_installer(project, onedir.folder)      # Windows + Inno Setup
+packages, mode = collect_licenses(project.work_path / "onedir")
+```
+
+`build_all(project, onefile=..., installer=..., smoke_test=..., diagnose=..., defender=..., licenses=..., sbom_file=..., github_tag=...)` runs everything and returns a `Report` with `.ok`, `.steps`, `.to_markdown()` and `.to_json()`.
+
+## About the antivirus score
+
+The score adds fixed weights for factors that are commonly reported to affect heuristic detection of PyInstaller executables (UPX 30, onefile 20, no version resource 15, unsigned 15, prebuilt bootloader 10, default icon 5). It is meant for comparing your own builds. It does not predict the verdict of Microsoft Defender or any other product, and a low score does not mean a file will not be flagged.
+
+pyi-doctor does not obfuscate, encrypt or otherwise hide code from scanners. It applies ordinary distribution practices (version information, no packer, onedir layout, signing advice) and helps you prepare a false-positive report. Code signing with a certificate from a trusted authority is generally the most effective measure and is outside the scope of this tool.
+
+## Measured on the bundled example
+
+`examples/hello`, Linux x86_64, Python 3.13, PyInstaller 6.22.3 (installer step skipped because it needs Windows):
+
+| Step | Time |
+|---|---|
+| onedir build | 4.5 s |
+| onefile build | 12.2 s |
+| licenses + SBOM | 0.8 s |
+| smoke test (both builds) | 0.6 s |
+| diagnosis | < 0.1 s |
+| release folder (zip + checksums) | 1.5 s |
+| **total** | **19.7 s** |
+
+Test suite: 138 tests (including 2 real PyInstaller builds) on Python 3.9, 3.11 and 3.13 on Linux. Windows-specific paths (version resource, Inno Setup compilation, Defender scan, error-dialog detection in the smoke test) run in the Windows CI jobs.
+
+## Known limitations
+
+- Windows features (installer, version resource, Defender scan) need Windows. On other systems the `.iss` script is still written.
+- The smoke test is a heuristic. It removes Python from the environment but does not reproduce a clean PC (installed DLLs, Visual C++ runtime, fonts, etc.). GUI apps that keep running are counted as started. Windowed apps that crash show a PyInstaller error dialog; on Windows pyi-doctor looks for that dialog by window title, which may not catch every case.
+- The bootloader check compares the installed PyInstaller bootloader with the hashes recorded in its wheel. It describes the PyInstaller in the current environment, not an exe built elsewhere.
+- License notices come from package metadata, which can be missing or wrong; packages loaded dynamically may be missed. Review the generated file.
+- Only PyInstaller is supported (no Nuitka / cx_Freeze). No code signing and no auto-update.
+
+## Disclaimer
+
+pyi-doctor is rule-based and may miss problems or report problems that do not exist. Its reports are informational and do not replace your own testing, review of licenses, or obligations under applicable law; checking the results and complying with license terms and laws remain the user's responsibility. The software is provided "AS IS", without warranty of any kind, under the MIT License.
+
+pyi-doctor is an independent project and is not affiliated with or endorsed by the PyInstaller project, Jordan Russell / Inno Setup, Microsoft, or GitHub. Product names are trademarks of their respective owners.
+
+## License
+
+MIT © 2026 서주원 (OMEGA SYSTEMS) · Contact: seodes105@gmail.com

pyi_doctor-1.0.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyi-doctor"
+version = "1.0.0"
+description = "Build PyInstaller apps as portable exe + installer, then check startup, antivirus risk factors and bundled licenses."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "서주원 (OMEGA SYSTEMS)", email = "seodes105@gmail.com" }]
+keywords = ["pyinstaller", "installer", "inno-setup", "antivirus", "false-positive", "sbom", "windows", "packaging"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Software Distribution",
+]
+dependencies = [
+    "pyinstaller>=6.0",
+    "tomli>=1.1; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+
+[project.urls]
+Homepage = "https://github.com/sjw0328/pyi-doctor"
+Issues = "https://github.com/sjw0328/pyi-doctor/issues"
+
+[project.scripts]
+pyi-doctor = "pyi_doctor.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["integration: runs a real PyInstaller build (slow)"]
+addopts = "-ra"

pyi_doctor-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyi_doctor-1.0.0/src/pyi_doctor/__init__.py

@@ -0,0 +1,74 @@
+"""pyi-doctor: build PyInstaller apps as a portable exe and an installer, then
+check whether they start outside the build machine, which antivirus risk
+factors they carry, and which third-party licenses they bundle.
+
+Typical use::
+
+    from pyi_doctor import Project, build_all
+
+    project = Project(entry="main.py", name="MyApp", version="1.0.0", publisher="Me")
+    report = build_all(project, log=print)
+    print(report.ok)
+"""
+
+__version__ = "1.0.0"
+
+from .config import Project  # noqa: E402
+from .errors import BuildError, ConfigError, PyiDoctorError, ToolNotFoundError  # noqa: E402
+
+__all__ = [
+    "__version__",
+    "Project",
+    "build_all",
+    "build_portable",
+    "build_installer",
+    "diagnose",
+    "smoke_test",
+    "collect_licenses",
+    "PyiDoctorError",
+    "ConfigError",
+    "BuildError",
+    "ToolNotFoundError",
+]
+
+
+def build_all(project, **kwargs):
+    """Run the full pipeline. See :func:`pyi_doctor.pipeline.build_all`."""
+    from .pipeline import build_all as _impl
+
+    return _impl(project, **kwargs)
+
+
+def build_portable(project, *, onefile: bool = False):
+    """Build the onedir (default) or onefile executable with PyInstaller."""
+    from .portable import build
+
+    return build(project, onefile=onefile)
+
+
+def build_installer(project, onedir, **kwargs):
+    """Write and compile the Inno Setup installer for an onedir folder."""
+    from .installer import build
+
+    return build(project, onedir, **kwargs)
+
+
+def diagnose(exe, **kwargs):
+    """Score an executable for antivirus false-positive risk factors."""
+    from .antivirus import diagnose as _impl
+
+    return _impl(exe, **kwargs)
+
+
+def smoke_test(exe, **kwargs):
+    """Start an executable in a temp folder with a reduced environment."""
+    from .smoke import run
+
+    return run(exe, **kwargs)
+
+
+def collect_licenses(work_dir=None):
+    """Return (packages, mode) for bundled third-party packages."""
+    from .licenses import collect
+
+    return collect(work_dir)

pyi_doctor-1.0.0/src/pyi_doctor/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

pyi_doctor-1.0.0/src/pyi_doctor/_proc.py

@@ -0,0 +1,55 @@
+"""Small subprocess helpers shared by the build steps."""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+from typing import List, Optional, Sequence
+
+from .errors import BuildError
+
+
+def tail(text: str, lines: int = 25) -> str:
+    return "\n".join(text.splitlines()[-lines:])
+
+
+def run_logged(
+    cmd: Sequence[str],
+    *,
+    cwd: Path,
+    log_path: Path,
+    what: str,
+    timeout: Optional[float] = None,
+) -> str:
+    """Run ``cmd``, write combined output to ``log_path`` and return it.
+
+    Raises :class:`BuildError` with the last lines of output on failure.
+    """
+    log_path.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        proc = subprocess.run(
+            list(cmd),
+            cwd=str(cwd),
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            timeout=timeout,
+        )
+    except FileNotFoundError as exc:
+        raise BuildError(f"{what}: could not start {cmd[0]!r}: {exc}") from exc
+    except subprocess.TimeoutExpired as exc:
+        out = (exc.stdout or b"").decode("utf-8", "replace")
+        log_path.write_text(out, encoding="utf-8")
+        raise BuildError(f"{what} timed out after {timeout}s", tail(out), str(log_path)) from exc
+    out = (proc.stdout or b"").decode("utf-8", "replace")
+    log_path.write_text(" ".join(_q(c) for c in cmd) + "\n\n" + out, encoding="utf-8")
+    if proc.returncode != 0:
+        raise BuildError(f"{what} failed with exit code {proc.returncode}", tail(out), str(log_path))
+    return out
+
+
+def _q(arg: str) -> str:
+    return f'"{arg}"' if (" " in arg or not arg) else arg
+
+
+def quote_list(cmd: List[str]) -> str:
+    return " ".join(_q(c) for c in cmd)