latextify 0.3.2__tar.gz → 0.3.3__tar.gz

{latextify-0.3.2 → latextify-0.3.3}/.github/workflows/ci.yml

@@ -147,14 +147,18 @@ jobs:
         with:
           python-version: "3.13"
       - name: Install
-        run: uv sync --locked --group portable
+        run: |
+          uv sync --locked --group portable
+          # setup-uv may select GitHub's hosted interpreter, which is not a
+          # relocatable payload. Install an explicit uv-managed copy to bundle.
+          uv python install 3.13 --no-bin --no-registry
       - name: Set up the TARGET Python 3.10 (what install.py will run under)
         id: py310
         uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: "3.10"
-      - name: Build a GUI kit covering Python 3.10 and warm one journal (network ON)
-        run: uv run latextify make-kit --target current --python-versions 3.10 --with-gui --journals revtex4-2 --output build
+      - name: Build a GUI/dev kit covering Python 3.10 and 3.13 (network ON)
+        run: uv run latextify make-kit --target current --python-versions 3.10 --python-versions 3.13 --with-gui --with-dev --journals revtex4-2 --output build
       - name: Install the kit under Python 3.10, network POISONED
         env:
           # Same reasoning as the Linux offline-kit job: uppercase only, one
@@ -220,3 +224,30 @@ jobs:
           } finally {
             if (-not $process.HasExited) { Stop-Process -Id $process.Id -Force }
           }
+      - name: Build and exercise the editable offline repository
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          $python = uv python find --managed-python 3.13
+          uv run --group portable python tools/build_windows_offline_repo.py `
+            --kit build/latextify-offline-windows-x64 `
+            --python-runtime $python `
+            --output build/offline-repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository build failed" }
+          $repo = Resolve-Path "build/offline-repo/LaTeXtify-Windows-Offline-Repo"
+          & "$repo/.runtime/python/python.exe" "$repo/.offline-kit/install.py" --dir $repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository setup failed" }
+          Push-Location $repo
+          try {
+            $env:LATEXTIFY_OFFLINE = "1"
+            $env:PATH = "$repo/.offline-kit/tectonic;$env:PATH"
+            $env:TECTONIC_CACHE_DIR = "$repo/.offline-kit/tex-bundle-cache"
+            & ".venv/Scripts/python.exe" -c "import pathlib, latextify; assert pathlib.Path(latextify.__file__).resolve().is_relative_to(pathlib.Path.cwd())"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository did not import editable source" }
+            & ".venv/Scripts/python.exe" -m pytest -q tests/test_portable.py
+            if ($LASTEXITCODE -ne 0) { throw "offline repository test command failed" }
+          } finally {
+            Pop-Location
+          }

{latextify-0.3.2 → latextify-0.3.3}/.github/workflows/release.yml

@@ -45,11 +45,15 @@ jobs:
             ~/.cache/Tectonic
           key: tectonic-${{ runner.os }}-v1
       - name: Install build dependencies
-        run: uv sync --locked --no-dev --extra gui --group portable
+        run: |
+          uv sync --locked --no-dev --extra gui --group portable
+          # The hosted interpreter is runner infrastructure, not a portable
+          # payload. Install a complete uv-managed runtime for the repo bundle.
+          uv python install 3.13 --no-bin --no-registry
       - name: Build native Windows runtime assets
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: uv run latextify make-kit --target current --python-versions 3.13 --with-gui -o build
+        run: uv run latextify make-kit --target current --python-versions 3.13 --with-gui --with-dev -o build
       - name: Freeze and verify the portable application
         env:
           HTTPS_PROXY: http://127.0.0.1:9
@@ -63,10 +67,70 @@ jobs:
             Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
             throw "portable self-test failed (exit $($selfTest.ExitCode))"
           }
+
+      - name: Build and verify the editable offline repository
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          # setup-uv already installed this managed interpreter. Copying its
+          # complete runtime makes the target independent of system Python.
+          $python = uv python find --managed-python 3.13
+          uv run --group portable python tools/build_windows_offline_repo.py `
+            --kit build/latextify-offline-windows-x64 `
+            --python-runtime $python `
+            --output build/offline-repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository build failed" }
+
+          $repo = Resolve-Path "build/offline-repo/LaTeXtify-Windows-Offline-Repo"
+          $process = Start-Process -FilePath "cmd.exe" `
+            -ArgumentList "/c", "startup.bat --port 8766 --no-browser --keep-alive" `
+            -WorkingDirectory $repo -PassThru -WindowStyle Hidden
+          try {
+            $ready = $false
+            for ($i = 0; $i -lt 60; $i++) {
+              Start-Sleep -Seconds 1
+              try {
+                $response = Invoke-WebRequest "http://127.0.0.1:8766/" -UseBasicParsing -NoProxy
+                if ($response.StatusCode -eq 200 -and $response.Content -match "LaTeXtify") {
+                  $ready = $true
+                  break
+                }
+              } catch {}
+              if ($process.HasExited) { break }
+            }
+            if (-not $ready) {
+              Get-Content "$repo/latextify-startup.log" -ErrorAction SilentlyContinue
+              throw "offline repository GUI did not start"
+            }
+          } finally {
+            if (-not $process.HasExited) { Stop-Process -Id $process.Id -Force }
+          }
+
+          Push-Location $repo
+          try {
+            $env:LATEXTIFY_OFFLINE = "1"
+            $env:PATH = "$repo/.offline-kit/tectonic;$env:PATH"
+            $env:TECTONIC_CACHE_DIR = "$repo/.offline-kit/tex-bundle-cache"
+            & ".venv/Scripts/python.exe" -c "import pathlib, latextify; assert pathlib.Path(latextify.__file__).resolve().is_relative_to(pathlib.Path.cwd())"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository did not import editable source" }
+            & ".venv/Scripts/python.exe" -m pytest -q tests/test_portable.py
+            if ($LASTEXITCODE -ne 0) { throw "offline repository test command failed" }
+            & ".venv/Scripts/python.exe" -m latextify convert tests/fixtures/clean.docx -j revtex4-2 -o offline-repo-demo --pdf
+            if ($LASTEXITCODE -ne 0) { throw "offline repository conversion failed" }
+            if (-not (Test-Path "offline-repo-demo/revtex4-2/main.pdf")) {
+              throw "offline repository did not compile a PDF"
+            }
+          } finally {
+            Pop-Location
+          }
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: windows-portable
-          path: build/portable/LaTeXtify-Windows-Portable.zip
+          name: windows-offline-packages
+          path: |
+            build/portable/LaTeXtify-Windows-Portable.zip
+            build/offline-repo/LaTeXtify-Windows-Offline-Repo.zip
           if-no-files-found: error
 
   build-kits:
@@ -161,13 +225,19 @@ jobs:
 
       - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
         with:
-          name: windows-portable
+          name: windows-offline-packages
           path: build
 
-      - name: Add the portable Windows application to checksums
+      - name: Add the Windows packages to checksums
         run: |
           cd build
+          # upload-artifact preserves the common `build/`-relative directory
+          # structure when given files from two different subdirectories.
+          # Flatten those two known assets before checksumming/uploading them.
+          mv portable/LaTeXtify-Windows-Portable.zip .
+          mv offline-repo/LaTeXtify-Windows-Offline-Repo.zip .
           sha256sum LaTeXtify-Windows-Portable.zip >> SHA256SUMS.txt
+          sha256sum LaTeXtify-Windows-Offline-Repo.zip >> SHA256SUMS.txt
           cat SHA256SUMS.txt
 
       - name: Create release (if missing) and upload assets
@@ -181,6 +251,7 @@ jobs:
             latextify-offline-linux-x64.zip
             latextify-offline-macos-arm64.zip
             LaTeXtify-Windows-Portable.zip
+            LaTeXtify-Windows-Offline-Repo.zip
             latextify-source.zip
             SHA256SUMS.txt
           )

{latextify-0.3.2 → latextify-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: latextify
-Version: 0.3.2
+Version: 0.3.3
 Summary: Convert Word manuscripts to journal-ready LaTeX projects and PDFs
 Project-URL: Homepage, https://github.com/pquarterman17/LaTeXtify
 Project-URL: Repository, https://github.com/pquarterman17/LaTeXtify
@@ -331,8 +331,10 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy. This source-tree launcher needs internet access
-on its first run.
+and prints it for you to copy. On Windows, `startup.bat` is offline-first and
+never downloads missing software. A connected source checkout can explicitly
+opt into the old online bootstrap by running **`startup-online.bat`** instead.
+The macOS/Linux source launcher still needs internet access on its first run.
 
 ### Offline / firewalled Windows computer
 
@@ -360,6 +362,25 @@ Python already present on the work computer. Embedded EMF/WMF figures work,
 but preserving them as vectors requires an offline installation of LibreOffice
 or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
+For an **editable source checkout** on an air-gapped Windows computer, use
+**`LaTeXtify-Windows-Offline-Repo.zip`**. It contains the complete tracked
+repository, a portable Python 3.13 runtime, pinned runtime and development
+dependencies, Pandoc, Tectonic, and the warmed TeX cache. Extract the whole
+folder and double-click `startup.bat`; its first launch creates `.venv` from
+the local wheelhouse without contacting any service. Code changes under
+`latextify\` are used on the next launch, and the bundled environment can run
+the offline test, lint, and type-check commands described in
+`README-OFFLINE-REPO.txt`.
+
+These packages serve different purposes:
+
+| Release asset | Intended use | Python required |
+|---|---|---|
+| `LaTeXtify-Windows-Portable.zip` | Normal GUI use | No |
+| `LaTeXtify-Windows-Offline-Repo.zip` | Editable/debuggable/testable source | No |
+| `latextify-offline-windows-x64.zip` | Inspectable installed Python package | Yes |
+| GitHub/source ZIP | Connected development | Yes |
+
 ## Usage
 
 > Installed from source with `uv sync`? Prefix these with `uv run` (e.g.

{latextify-0.3.2 → latextify-0.3.3}/README.md

@@ -285,8 +285,10 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy. This source-tree launcher needs internet access
-on its first run.
+and prints it for you to copy. On Windows, `startup.bat` is offline-first and
+never downloads missing software. A connected source checkout can explicitly
+opt into the old online bootstrap by running **`startup-online.bat`** instead.
+The macOS/Linux source launcher still needs internet access on its first run.
 
 ### Offline / firewalled Windows computer
 
@@ -314,6 +316,25 @@ Python already present on the work computer. Embedded EMF/WMF figures work,
 but preserving them as vectors requires an offline installation of LibreOffice
 or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
+For an **editable source checkout** on an air-gapped Windows computer, use
+**`LaTeXtify-Windows-Offline-Repo.zip`**. It contains the complete tracked
+repository, a portable Python 3.13 runtime, pinned runtime and development
+dependencies, Pandoc, Tectonic, and the warmed TeX cache. Extract the whole
+folder and double-click `startup.bat`; its first launch creates `.venv` from
+the local wheelhouse without contacting any service. Code changes under
+`latextify\` are used on the next launch, and the bundled environment can run
+the offline test, lint, and type-check commands described in
+`README-OFFLINE-REPO.txt`.
+
+These packages serve different purposes:
+
+| Release asset | Intended use | Python required |
+|---|---|---|
+| `LaTeXtify-Windows-Portable.zip` | Normal GUI use | No |
+| `LaTeXtify-Windows-Offline-Repo.zip` | Editable/debuggable/testable source | No |
+| `latextify-offline-windows-x64.zip` | Inspectable installed Python package | Yes |
+| GitHub/source ZIP | Connected development | Yes |
+
 ## Usage
 
 > Installed from source with `uv sync`? Prefix these with `uv run` (e.g.

{latextify-0.3.2 → latextify-0.3.3}/latextify/cli_kit.py

@@ -43,6 +43,11 @@ def make_kit_cmd(
     with_gui: bool = typer.Option(
         False, "--with-gui", help="Also bundle the optional web-GUI dependency wheels."
     ),
+    with_dev: bool = typer.Option(
+        False,
+        "--with-dev",
+        help="Also bundle development/test dependencies for an offline source checkout.",
+    ),
     zip_kit: bool = typer.Option(
         False, "--zip", help="Also produce a .zip of the kit folder for distribution."
     ),
@@ -67,6 +72,7 @@ def make_kit_cmd(
             warm_tex=warm_tex,
             journals=journal_list,
             with_gui=with_gui,
+            with_dev=with_dev,
             make_zip=zip_kit,
         )
     except KitBuildError as exc:

{latextify-0.3.2 → latextify-0.3.3}/latextify/kit/README-OFFLINE.md

@@ -19,6 +19,10 @@ Everything installs into this folder; nothing else on the system is touched.
 | `requirements.txt` | the exact pinned versions (for IT / security review) |
 | `bundle-info.json` | which OS, CPU, and Python versions this kit covers |
 
+When `with_dev` is true in `bundle-info.json`, `requirements.txt` and the
+wheelhouse also contain the pinned test, lint, and type-check dependencies used
+by the editable offline repository release.
+
 ## Requirements
 
 - The OS and CPU this kit was built for — see `bundle-info.json` (the folder

{latextify-0.3.2 → latextify-0.3.3}/latextify/kit/build.py

@@ -84,12 +84,11 @@ def _build_project_wheel(wheelhouse: Path) -> str:
     return wheels[-1].name.split("-")[1]
 
 
-def _export_requirements(req: Path, *, with_gui: bool) -> None:
+def _export_requirements(req: Path, *, with_gui: bool, with_dev: bool = False) -> None:
     cmd = [
         "uv",
         "export",
         "--frozen",
-        "--no-dev",
         "--no-emit-project",
         "--no-hashes",
         "--format",
@@ -97,6 +96,10 @@ def _export_requirements(req: Path, *, with_gui: bool) -> None:
         "-o",
         str(req),
     ]
+    if not with_dev:
+        cmd += ["--no-dev"]
+    else:
+        cmd += ["--group", "dev"]
     if with_gui:
         cmd += ["--extra", "gui"]
     _run(cmd, cwd=str(REPO_ROOT))
@@ -243,13 +246,15 @@ def make_kit(
     warm_tex: bool = True,
     journals: list[str] | None = None,
     with_gui: bool = False,
+    with_dev: bool = False,
     make_zip: bool = False,
 ) -> Path:
     """Build an offline kit for ``target_name`` under ``output_dir``; return the kit dir.
 
     ``journals`` limits TeX-cache warming (default: every registered journal).
     ``warm_tex=False`` produces a smaller emit-only kit (no ``tex-bundle-cache/``).
-    ``with_gui`` adds the optional GUI dependency wheels.
+    ``with_gui`` adds the optional GUI dependency wheels. ``with_dev`` also
+    bundles the development/test dependency group for an editable offline checkout.
     """
     _require_uv()
     target = resolve_target(target_name)
@@ -263,7 +268,7 @@ def make_kit(
     wheelhouse.mkdir(parents=True)
 
     version = _build_project_wheel(wheelhouse)
-    _export_requirements(kit_dir / "requirements.txt", with_gui=with_gui)
+    _export_requirements(kit_dir / "requirements.txt", with_gui=with_gui, with_dev=with_dev)
     _download_deps(wheelhouse, kit_dir / "requirements.txt", python_versions, target)
 
     _fetch_tectonic(target, kit_dir / "tectonic")
@@ -282,6 +287,7 @@ def make_kit(
                 list(python_versions),
                 warm_tex=warm_tex,
                 with_gui=with_gui,
+                with_dev=with_dev,
                 journals=warmed,
             ),
             indent=2,

{latextify-0.3.2 → latextify-0.3.3}/latextify/kit/install_template.py

@@ -133,6 +133,13 @@ def _package_spec(info: dict) -> str:
     return "latextify[gui]" if info.get("with_gui", False) else "latextify"
 
 
+def _install_requirements(base: list[str]) -> None:
+    """Install the exact exported dependency set before the project wheel."""
+    requirements = HERE / "requirements.txt"
+    if requirements.is_file():
+        _run(base + ["-r", str(requirements)])
+
+
 def _write_launchers(target: Path, venv_dir: Path, *, with_gui: bool) -> list[Path]:
     """Write LaTeXtify.bat / ./latextify that run the venv CLI with the in-kit
     Tectonic binary on PATH and TECTONIC_CACHE_DIR pointed at the warmed cache.
@@ -234,6 +241,7 @@ def main() -> None:
         subprocess.run(base + ["--upgrade", "--quiet", "pip"])
     with_gui = bool(info.get("with_gui", False))
     package = _package_spec(info)
+    _install_requirements(base)
     _run(base + ["--upgrade", package])
 
     imports = "import latextify"

{latextify-0.3.2 → latextify-0.3.3}/latextify/kit/target.py

@@ -128,6 +128,7 @@ def build_bundle_info(
     *,
     warm_tex: bool,
     with_gui: bool,
+    with_dev: bool = False,
     journals: list[str],
 ) -> dict:
     """Shape the ``bundle-info.json`` manifest (pure)."""
@@ -140,5 +141,6 @@ def build_bundle_info(
         "python_versions": list(py_versions),
         "warm_tex": warm_tex,
         "with_gui": with_gui,
+        "with_dev": with_dev,
         "warmed_journals": sorted(journals) if warm_tex else [],
     }

latextify-0.3.3/packaging/README-WINDOWS-OFFLINE-REPO.txt

@@ -0,0 +1,55 @@
+LaTeXtify for Windows - editable offline repository
+===================================================
+
+This bundle is for running, editing, debugging, and testing the LaTeXtify
+source code on a Windows computer that cannot reach GitHub, Astral, or PyPI.
+
+START THE GUI
+-------------
+1. Extract the entire folder to a short writable path, such as
+   C:\LaTeXtify-Source.
+2. Double-click startup.bat.
+3. The first launch creates .venv from the bundled wheelhouse. This can take
+   a few minutes, but it does not use the network or require administrator
+   rights. Later launches reuse that environment.
+
+The bundle contains a portable Python 3.13 runtime, all pinned dependencies,
+Pandoc, Tectonic, the warmed TeX package cache, and the complete tracked source
+checkout. The GUI and command line run the files in this folder, so edits to
+latextify\ take effect on the next launch.
+
+OFFLINE DEVELOPMENT
+-------------------
+Run the test suite:
+
+    .venv\Scripts\python.exe -m pytest -q -m "not network"
+
+Run lint and type checks:
+
+    .venv\Scripts\python.exe -m ruff check .
+    .venv\Scripts\python.exe -m mypy
+
+Run the command line directly:
+
+    .venv\Scripts\python.exe -m latextify convert paper.docx -j revtex4-2 --pdf
+
+NETWORK BEHAVIOR
+----------------
+startup.bat never downloads missing software. The bundled launch sets
+LATEXTIFY_OFFLINE=1, uses the bundled Tectonic/cache, and disables Crossref
+reference checks. Other GUI features remain available.
+
+For a normal connected source checkout, startup-online.bat explicitly enables
+the historical uv/dependency download setup. Do not use it on an air-gapped
+computer.
+
+EMF/WMF figures can be rasterized without additional software. Preserving them
+as vectors requires an approved offline installation of LibreOffice or
+Inkscape.
+
+TROUBLESHOOTING
+---------------
+The startup log is latextify-startup.log beside startup.bat. Keep .runtime,
+.offline-kit, and the source tree together. If endpoint security blocks
+python.exe, pandoc.exe, or tectonic.exe, provide IT with SHA256SUMS.txt from
+the release and request allow-listing.

{latextify-0.3.2 → latextify-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "latextify"
-version = "0.3.2"
+version = "0.3.3"
 description = "Convert Word manuscripts to journal-ready LaTeX projects and PDFs"
 readme = "README.md"
 license = "Apache-2.0"

latextify-0.3.3/startup-online.bat

@@ -0,0 +1,5 @@
+@echo off
+REM Explicitly opt into the source launcher's network bootstrap.
+set "LATEXTIFY_ALLOW_DOWNLOADS=1"
+call "%~dp0startup.bat" %*
+exit /b %ERRORLEVEL%

{latextify-0.3.2 → latextify-0.3.3}/startup.bat

@@ -9,6 +9,8 @@ setlocal
 cd /d "%~dp0"
 set "LOG=%~dp0latextify-startup.log"
 set "VENVPY=%~dp0.venv\Scripts\python.exe"
+set "BUNDLEPY=%~dp0.runtime\python\python.exe"
+set "OFFLINEKIT=%~dp0.offline-kit\install.py"
 
 > "%LOG%" echo LaTeXtify startup log
 >> "%LOG%" echo Run at %DATE% %TIME%
@@ -20,10 +22,30 @@ if not exist "%VENVPY%" goto setup
 if not errorlevel 1 goto launch
 
 :setup
+REM An offline repository bundle carries both of these. Prefer them before
+REM looking for uv and never contact the network from this path.
+if exist "%BUNDLEPY%" if exist "%OFFLINEKIT%" goto setup_offline
+
+REM A plain source checkout is offline-first too. Downloads happen only via
+REM startup-online.bat (which sets LATEXTIFY_ALLOW_DOWNLOADS=1 explicitly).
+if /I not "%LATEXTIFY_ALLOW_DOWNLOADS%"=="1" goto no_offline_runtime
+
+:setup_online
 where uv >nul 2>&1
 if errorlevel 1 goto install_uv
 goto have_uv
 
+:setup_offline
+echo Setting up LaTeXtify entirely from bundled files - please wait...
+>> "%LOG%" echo --- offline setup from .runtime and .offline-kit ---
+set "LATEXTIFY_OFFLINE=1"
+"%BUNDLEPY%" "%OFFLINEKIT%" --dir "%CD%" >> "%LOG%" 2>&1
+if errorlevel 1 goto fail
+if not exist "%VENVPY%" goto fail
+"%VENVPY%" -c "import latextify.gui.server" >> "%LOG%" 2>&1
+if errorlevel 1 goto fail
+goto launch
+
 :install_uv
 echo uv is not installed -- installing it now...
 >> "%LOG%" echo --- installing uv via official installer ---
@@ -37,10 +59,16 @@ if errorlevel 1 goto no_uv
 echo Setting up LaTeXtify - first run installs dependencies, please wait...
 >> "%LOG%" echo --- uv sync --extra gui ---
 uv sync --extra gui >> "%LOG%" 2>&1
+if errorlevel 1 goto fail
 
 :launch
 if not exist "%VENVPY%" goto fail
-echo Starting LaTeXtify. Your browser should open at http://127.0.0.1:8501
+if exist "%OFFLINEKIT%" (
+  set "LATEXTIFY_OFFLINE=1"
+  set "PATH=%~dp0.offline-kit\tectonic;%PATH%"
+  set "TECTONIC_CACHE_DIR=%~dp0.offline-kit\tex-bundle-cache"
+)
+echo Starting LaTeXtify. Your browser should open shortly.
 echo Keep this window open while you use it. Close it or press Ctrl+C to stop.
 >> "%LOG%" echo --- launch: python -m latextify gui ---
 "%VENVPY%" -m latextify gui %* >> "%LOG%" 2>&1
@@ -51,14 +79,25 @@ exit /b 0
 :no_uv
 >> "%LOG%" echo ERROR: automatic uv install failed.
 >> "%LOG%" echo.
->> "%LOG%" echo This is the SOURCE launcher and its first run requires internet access.
->> "%LOG%" echo For a firewalled or air-gapped computer, use the release asset named
->> "%LOG%" echo LaTeXtify-Windows-Portable.zip instead of the source-code zip.
->> "%LOG%" echo Transfer that zip from a connected computer, extract the whole
->> "%LOG%" echo folder, then double-click LaTeXtify.exe. No Python or install is needed.
+>> "%LOG%" echo startup-online.bat was selected, but its uv download failed.
+>> "%LOG%" echo For a firewalled computer, use LaTeXtify-Windows-Offline-Repo.zip
+>> "%LOG%" echo for editable source or LaTeXtify-Windows-Portable.zip for ordinary use.
 >> "%LOG%" echo.
 >> "%LOG%" echo On a connected computer, install uv from https://docs.astral.sh/uv/
->> "%LOG%" echo and run this launcher again.
+>> "%LOG%" echo and run startup-online.bat again.
+goto fail
+
+:no_offline_runtime
+>> "%LOG%" echo ERROR: no working environment or bundled offline runtime was found.
+>> "%LOG%" echo.
+>> "%LOG%" echo This launcher does not download software unless you explicitly use
+>> "%LOG%" echo startup-online.bat on a connected computer.
+>> "%LOG%" echo.
+>> "%LOG%" echo For an editable, air-gapped checkout, use the release asset named
+>> "%LOG%" echo LaTeXtify-Windows-Offline-Repo.zip. It includes Python, the complete
+>> "%LOG%" echo wheelhouse, Pandoc, Tectonic, the TeX cache, and this source tree.
+>> "%LOG%" echo.
+>> "%LOG%" echo For ordinary use, use LaTeXtify-Windows-Portable.zip instead.
 goto fail
 
 :fail

{latextify-0.3.2 → latextify-0.3.3}/tests/test_kit_build.py

@@ -92,6 +92,7 @@ def test_bundle_info_manifest_shape():
         ["3.10", "3.11"],
         warm_tex=True,
         with_gui=False,
+        with_dev=False,
         journals=["revtex4-2", "iopart"],
     )
     assert info["name"] == "latextify"
@@ -99,6 +100,7 @@ def test_bundle_info_manifest_shape():
     assert info["target"] == "linux-x64"
     assert info["python_versions"] == ["3.10", "3.11"]
     assert info["warm_tex"] is True
+    assert info["with_dev"] is False
     assert info["warmed_journals"] == ["iopart", "revtex4-2"]  # sorted
 
 
@@ -109,11 +111,13 @@ def test_bundle_info_emit_only_lists_no_warmed_journals():
         ["3.12"],
         warm_tex=False,
         with_gui=True,
+        with_dev=True,
         journals=["revtex4-2"],
     )
     assert info["warm_tex"] is False
     assert info["warmed_journals"] == []
     assert info["with_gui"] is True
+    assert info["with_dev"] is True
 
 
 # --------------------------------------------------------------------------- #
@@ -167,6 +171,30 @@ def test_command_line_only_kit_does_not_write_gui_launcher(tmp_path):
     assert all("gui" not in path.name.lower() for path in launchers)
 
 
+def test_installer_installs_pinned_requirements(monkeypatch, tmp_path):
+    requirements = tmp_path / "requirements.txt"
+    requirements.write_text("pytest==9.0.0\n")
+    calls = []
+    monkeypatch.setattr(install_template, "HERE", tmp_path)
+    monkeypatch.setattr(install_template, "_run", calls.append)
+
+    install_template._install_requirements(["python", "-m", "pip", "install"])
+
+    assert calls == [["python", "-m", "pip", "install", "-r", str(requirements)]]
+
+
+def test_dev_requirements_export_includes_dev_group(monkeypatch, tmp_path):
+    calls = []
+    monkeypatch.setattr(build, "_run", lambda command, **kwargs: calls.append(command))
+
+    build._export_requirements(tmp_path / "requirements.txt", with_gui=True, with_dev=True)
+
+    command = calls[0]
+    assert "--no-dev" not in command
+    assert command[command.index("--group") + 1] == "dev"
+    assert command[command.index("--extra") + 1] == "gui"
+
+
 def test_default_warm_journals_are_the_registered_ones():
     # Sanity: warming defaults to the live registry, not a hardcoded list.
     assert set(loader.available()) == set(loader.discover())

latextify-0.3.3/tests/test_offline_repo.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+import zipfile
+from pathlib import Path
+
+from tools import build_windows_offline_repo as offline_repo
+
+
+def test_copy_checkout_copies_only_reported_tracked_files(monkeypatch, tmp_path: Path) -> None:
+    source = tmp_path / "source"
+    destination = tmp_path / "destination"
+    (source / "package").mkdir(parents=True)
+    (source / "package" / "tracked.py").write_text("tracked")
+    (source / "ignored.txt").write_text("ignored")
+    monkeypatch.setattr(offline_repo, "tracked_files", lambda _repo: [Path("package/tracked.py")])
+
+    offline_repo._copy_checkout(source, destination)
+
+    assert (destination / "package" / "tracked.py").read_text() == "tracked"
+    assert not (destination / "ignored.txt").exists()
+
+
+def test_zip_tree_has_one_top_level_bundle_directory(tmp_path: Path) -> None:
+    bundle = tmp_path / offline_repo.BUNDLE_NAME
+    (bundle / "latextify").mkdir(parents=True)
+    (bundle / "startup.bat").write_text("@echo off\n")
+    (bundle / "latextify" / "__init__.py").write_text("")
+    archive = tmp_path / "bundle.zip"
+
+    offline_repo._zip_tree(bundle, archive)
+
+    with zipfile.ZipFile(archive) as zf:
+        assert sorted(zf.namelist()) == [
+            f"{offline_repo.BUNDLE_NAME}/latextify/__init__.py",
+            f"{offline_repo.BUNDLE_NAME}/startup.bat",
+        ]
+
+
+def test_windows_startup_is_offline_first() -> None:
+    source = (offline_repo.ROOT / "startup.bat").read_text(encoding="utf-8")
+    folded = source.casefold()
+    assert ".runtime\\python\\python.exe" in folded
+    assert ".offline-kit\\install.py" in folded
+    assert '--dir "%cd%"' in folded
+    assert '--dir "%~dp0"' not in folded
+    assert 'if /i not "%latextify_allow_downloads%"=="1"' in folded
+    assert "goto no_offline_runtime" in folded
+
+
+def test_online_bootstrap_requires_explicit_wrapper() -> None:
+    wrapper = (offline_repo.ROOT / "startup-online.bat").read_text(encoding="utf-8")
+    assert 'set "LATEXTIFY_ALLOW_DOWNLOADS=1"' in wrapper
+    assert 'call "%~dp0startup.bat" %*' in wrapper