Skip to content

feat: Uv install - #1566

Open
jstucke wants to merge 4 commits into
masterfrom
uv-install
Open

jstucke wants to merge 4 commits into
masterfrom
uv-install

Conversation

@jstucke

@jstucke jstucke commented Nov 13, 2026

Copy link
Copy Markdown
Collaborator
  • Install fact with pyproject.toml and uv instead of requirements.txt and pip
  • ⚠️ breaking change: plugins also need their own pyproject.toml instead of a requirements.txt

jstucke and others added 3 commits November 13, 2026 16:55
…installer.py and binwalk/install.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…th uv

Declare FACT's Python dependencies in pyproject.toml, alongside the existing
requirements files:
- core dependencies (needed by the installer and all components) as project
  dependencies
- component-specific ones as dependency groups (frontend, backend, test, lint;
  dev includes all of them)
- every analysis plugin as a uv workspace member with its own pyproject.toml
  listing the plugin's dependencies

uv.lock pins the resolved versions. version.py now reads the version from
pyproject.toml, so it is only maintained in one place.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The installer installs FACT's Python dependencies from uv.lock into a venv
instead of pip-installing requirements files:
- pre_install.sh installs uv (if missing) and the core dependencies. It uses
  the active venv or creates .venv in the repository root.
- the installer components sync their dependency groups (frontend, backend) and
  the plugin dependencies (workspace members) into the venv of the running
  installer. The syncs are additive, so installing one component does not
  remove the dependencies of another one.
- installing outside a venv is no longer supported.

Removes all requirements files, the pip helpers, the pip-specific steps (pip
bootstrap, flask-security uninstall, binwalk pip build; binwalk is a plugin
dependency now) and pre_install_fedora.sh. Third-party plugins need a
pyproject.toml for their Python dependencies (and an updated uv.lock).

The shutdown signal handler identifies FACT's main process by its PID instead
of the process group, so that FACT also shuts down when it is not started as a
process group leader (e.g. with `uv run`).

Updates the build CI and the documentation (INSTALL.md, README.md, AGENTS.md)
accordingly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jstucke jstucke self-assigned this Nov 13, 2026
Move the documentation dependencies from docsrc/doc_dependencies.txt to the
docs dependency group in pyproject.toml. The docs workflows install them with
astral-sh/setup-uv and build the docs with uv run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov-commenter

codecov-commenter commented Nov 13, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 37.50000% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.54%. Comparing base (fa6a600) to head (171c8ac).

Files with missing lines Patch % Lines
src/helperFunctions/install.py 25.00% 9 Missing ⚠️
src/fact_base.py 0.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1566      +/-   ##
==========================================
- Coverage   93.13%   92.54%   -0.60%     
==========================================
  Files         377      370       -7     
  Lines       23829    21310    -2519     
==========================================
- Hits        22193    19721    -2472     
+ Misses       1636     1589      -47     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants