feat: migrate from poetry and black to uv and ruff by dennisweil · Pull Request #623 · ftrackhq/integrations

dennisweil · 2025-12-01T14:26:02Z

Resolves : fi-7

I have added automatic tests where applicable.
The PR contains a description of what has been changed.
The description contains manual test instructions.
The PR contains update to the release notes.
The PR contains update to the documentation.

This PR has been tested on :

Windows.
MacOs.
Linux.

Overview

Migrate the whole monorepo/dependency/project management from poetry to uv.
MIgrate all formatting and pre-commits from black to ruff.

- ftrack connect - installer - projects/rv - tools update to build resources

github-actions · 2026-03-12T13:52:44Z

Coverage report

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
tests/libraries
test_version_parsing.py
Project Total

_{This report was generated by python-coverage-comment-action}

… docs

Copilot

Pull request overview

Migrates the monorepo’s Python packaging/dependency tooling from Poetry/Black to uv/Ruff, converting package metadata to PEP 621 and updating CI and build docs accordingly.

Changes:

Convert pyproject.toml files from [tool.poetry] to [project] (PEP 621) and switch build backend to Hatchling; add tool.uv.sources for local path deps.
Replace Black with Ruff formatting and update pre-commit + documentation/README instructions to use uv.
Update CI workflows to use uv for installs/builds/tests; add/adjust version parsing utilities + tests.

Reviewed changes

Copilot reviewed 45 out of 91 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
tools/requirements.txt	Replace `pyScss` with `libsass` for build tooling dependencies.
tools/requirements-pyside6.txt	Replace `pyScss` with `libsass` for PySide6 build tooling.
tools/requirements-connect.txt	Replace `pyScss` with `libsass` for Connect build tooling.
tests/libraries/test_version_parsing.py	Adds tests for new version parsing helpers and regex validity.
pyproject.toml	Root metadata migrated to PEP 621 + Hatchling; adds uv sources and Ruff config.
projects/rv/pyproject.toml	Migrates RV project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/rv/connect-plugin/hook/ftrack_rv_launcher.py	Ruff-formatting (quotes) and minor string/regex updates.
projects/rv/README.md	Updates build/versioning instructions from Poetry to uv.
projects/nuke-studio/pyproject.toml	Migrates Nuke Studio project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/nuke-studio/README.md	Updates build + docs instructions to use uv.
projects/framework-premiere/pyproject.toml	Migrates Premiere project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-premiere/connect-plugin/hook/discover_ftrack_framework_premiere.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-premiere/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-photoshop/pyproject.toml	Migrates Photoshop project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-photoshop/connect-plugin/hook/discover_ftrack_framework_photoshop.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-photoshop/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-nuke/pyproject.toml	Migrates Nuke framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-nuke/connect-plugin/hook/discover_ftrack_framework_nuke.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-nuke/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-maya/pyproject.toml	Migrates Maya framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-maya/connect-plugin/hook/discover_ftrack_framework_maya.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-maya/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-max/pyproject.toml	Migrates 3ds Max framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-max/connect-plugin/hook/discover_ftrack_framework_max.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-max/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-houdini/pyproject.toml	Migrates Houdini framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-houdini/connect-plugin/hook/discover_ftrack_framework_houdini.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-houdini/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-harmony/pyproject.toml	Migrates Harmony framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-harmony/connect-plugin/hook/discover_ftrack_framework_harmony.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-harmony/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-flame/pyproject.toml	Migrates Flame framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-flame/connect-plugin/hook/discover_ftrack_framework_flame.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-flame/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/framework-blender/pyproject.toml	Migrates Blender framework project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/framework-blender/connect-plugin/hook/discover_ftrack_framework_blender.py	Ruff-formatting + version extraction fallback logic changes.
projects/framework-blender/README.md	Updates build instructions to uv, adjusts build tool invocation paths.
projects/connect-timetracker-widget/pyproject.toml	Migrates widget project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/connect-timetracker-widget/README.md	Updates build instructions to uv.
projects/connect-publisher-widget/pyproject.toml	Migrates widget project metadata to PEP 621/Hatchling/uv + Ruff config.
projects/connect-publisher-widget/README.md	Updates build instructions to uv.
libs/utils/source/ftrack_utils/version/init.py	Adds version parsing helpers and switches pyproject parsing to tomllib + PEP 621 layout.
libs/utils/pyproject.toml	Migrates utils library metadata to PEP 621/Hatchling + Ruff config.
libs/qt/pyproject.toml	Migrates qt library metadata to PEP 621/Hatchling/uv sources + Ruff config.
libs/qt-style/pyproject.toml	Migrates qt-style library metadata to PEP 621/Hatchling/uv sources + Ruff config.
libs/qt-style/README.md	Updates qt-style build instructions to uv.
libs/framework-qt/pyproject.toml	Migrates framework-qt library metadata to PEP 621/Hatchling/uv sources + Ruff config.
libs/framework-core/pyproject.toml	Migrates framework-core library metadata to PEP 621/Hatchling/uv sources + Ruff config.
libs/constants/pyproject.toml	Migrates constants library metadata to PEP 621/Hatchling/uv sources + Ruff config.
installers/app-installer/uv.lock	Adds uv lockfile for the app-installer package.
installers/app-installer/source/ftrack_app_installer/init.py	Switch DMG creation to `dmgbuild` and refactor packaging/code-signing flow.
installers/app-installer/pyproject.toml	Migrates app-installer metadata to PEP 621/Hatchling + Ruff config.
apps/connect/source/ftrack_connect/main.py	Ruff-formatting plus new application naming/icon setup.
apps/connect/resource/sass/widget/_list.scss	Updates a selector for checkbox hover styling.
apps/connect/resource/sass/module/_test.scss	Fixes comment syntax.
apps/connect/pyproject.toml	Migrates Connect app metadata to PEP 621/Hatchling/uv sources + Ruff config.
apps/connect/installer.py	Refactors installer entrypoint to locate package via importlib.
apps/connect/README.md	Updates Connect build/run/docs instructions to uv.
README.md	Updates repo-level dev/test instructions from Poetry/Black to uv/Ruff.
.pre-commit-config.yaml	Replaces Black hook with Ruff hooks.
.github/workflows/push-main-test.yml	Switch CI installs/tests from Poetry to uv + coverage.
.github/workflows/build-plugin.yml	Switch plugin build workflow from Poetry/pip to uv run/build.
.github/workflows/build-library.yml	Switch library build workflow from Poetry/pip to uv.
.github/workflows/build-connect.yml	Switch Connect build/installer workflows from Poetry/pyenv/pip to uv.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

installers/app-installer/source/ftrack_app_installer/__init__.py

apps/connect/installer.py

.github/workflows/build-plugin.yml

.pre-commit-config.yaml

apps/connect/resource/sass/widget/_list.scss

installers/app-installer/source/ftrack_app_installer/__init__.py

apps/connect/source/ftrack_connect/__main__.py

installers/app-installer/pyproject.toml

pyproject.toml

installers/app-installer/source/ftrack_app_installer/__init__.py

Copilot · 2026-03-19T14:16:45Z

@dennisweil I've opened a new pull request, #630, to work on those changes. Once the pull request is ready, I'll request review from you.

dennisweil added 10 commits November 11, 2025 17:24

Use uv and ruff for main monorepo project

d7f7ed3

Enable uv for connect app

f1b7e15

WIP poetry to uv/ruff migration

d8dfc48

- ftrack connect - installer - projects/rv - tools update to build resources

Remove resource files

dc0d6bf

Move add tomli to rv to support older python versions in build script

17738f0

Update macos version for test runner

eec193c

Align with main branch

7172e61

chore: migrate libs and connect to uv on python 3.13

8c2baf9

chore: migrate ci workflows to uv execution

df0e823

fix: always upload coverage artifact in test workflow

4f8c974

dennisweil added 19 commits March 12, 2026 15:24

feat(rv): migrate RV project to uv and refresh build pipeline

d724ef2

feat(connect-publisher-widget): port project to uv and update build docs

5ec80c0

feat(connect-timetracker-widget): port project to uv and update build…

82e2229

… docs

docs(projects): run build script from project directories

140bd32

feat(framework-maya): port project to uv with 26.3.0.dev0

540fa0e

feat(framework-nuke): port project to uv with 26.3.0.dev0

3681570

feat(framework-max): port project to uv with 26.3.0.dev0

15d50a5

feat(framework-houdini): port project to uv with 26.3.0.dev0

1c85149

feat(framework-harmony): port project to uv with 26.3.0.dev0

f257f09

feat(framework-flame): port project to uv with 26.3.0.dev0

69d8a5f

feat(framework-blender): port project to uv with 26.3.0.dev0

d66c091

feat(framework-photoshop): port project and validate full cep build flow

be49141

feat(framework-premiere): port project to uv with 26.3.0.dev0

3da2be0

feat(nuke-studio): port project to uv with 26.3.0.dev0

30e076f

docs: add migration handoff context for uv transition

6f17e67

revert: remove handoff context from tracked files

bbacdcb

refactor: move app version parsing into ftrack-utils

700835f

Fix readme to correctly explain build process

8674c23

fix(security): raise urllib3 floor and refresh uv lockfiles

1521b9e

dennisweil added 8 commits March 16, 2026 17:33

fix(app-installer): tighten python target and lock secure deps

dd8bb2b

fix(connect): bump certifi to patched 2024 line

d1818a2

docs: align local build instructions with uv workflows

349bfc7

build: refresh lockfiles and generated resources after clean rebuild

fcd207e

fix(versioning): switch plugin projects to rc1 and rv to 26.3

55f3f00

fix(rv): keep integration at rc1 while preserving rvpkg naming

8d209c7

fix(connect): set runtime app icon and display name for uv runs

1235240

fix(connect): normalize app version payload for integration events

b6f5fd0

dennisweil requested a review from Copilot March 17, 2026 14:16

Copilot started reviewing on behalf of dennisweil March 17, 2026 14:17 View session

Copilot AI reviewed Mar 17, 2026

View reviewed changes

dennisweil added 2 commits March 18, 2026 15:14

fix(qt-style): ship compiled Qt resource module in library builds

cae4ec0

fix(framework-houdini): include ftrack-qt-style in plugin dependencies

5e08520

hdd changed the base branch from main to backlog/uv-build/main March 18, 2026 14:52

dennisweil marked this pull request as ready for review March 18, 2026 14:52

dennisweil requested a review from a team as a code owner March 18, 2026 14:52

hdd self-requested a review March 18, 2026 14:54

Copilot AI mentioned this pull request Mar 19, 2026

fix(ci): use Python 3.13 for packages requiring >= 3.13 in build-plugin workflow #630

Closed

8 tasks

dennisweil added 9 commits March 19, 2026 15:36

ci(plugin): standardize workflow on Python 3.13

b4d8eab

fix(connect): use cross-platform runtime icon selection

e3da2a5

fix(connect): resolve version fallback from project pyproject

c64f227

fix(connect-style): use Qt-compatible unchecked hover selector

9b2f1d9

fix(app-installer): surface PyInstaller build failures

615c840

fix(app-installer): preserve dmg errors and correct xcode typo

4c52650

fix(app-installer): correct repository URL path

4f416f9

fix(test): upgrade root pytest constraint for Python 3.13

8fe1b52

chore(pre-commit): use python3.13 and valid top-level config keys

410f2cb

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: migrate from poetry and black to uv and ruff#623

feat: migrate from poetry and black to uv and ruff#623
dennisweil wants to merge 48 commits intobacklog/uv-build/mainfrom
fi-7_use-uv-and-ruff-for-main-repo-management

dennisweil commented Dec 1, 2025

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

dennisweil commented Dec 1, 2025

Overview

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Mar 12, 2026 •

edited

Loading