feat: support for the uv plugin

.gitignore

@@ -30,6 +30,7 @@ __pycache__
 *.comp
 *.snap
 snap/.snapcraft/
+.spread_multipass
 .spread-reuse.*
 /stage
 *.swp

docs/conf.py

@@ -1,4 +1,4 @@
-# Copyright 2023-2024 Canonical Ltd.
+# Copyright 2023-2025 Canonical Ltd.
 #
 # This program is free software; you can redistribute it and/or
 # modify it under the terms of the GNU Lesser General Public
@@ -79,6 +79,7 @@
     "common/craft-parts/reference/plugins/poetry_plugin.rst",
     "common/craft-parts/reference/plugins/python_plugin.rst",
     "common/craft-parts/reference/plugins/maven_plugin.rst",
+    "common/craft-parts/reference/plugins/uv_plugin.rst",
     # Extra non-craft-parts exclusions can be added after this comment
 ]
 

docs/reference/changelog.rst

@@ -78,6 +78,15 @@ Core
 
 * Improved error messaging when unable to pack.
 
+Plugins
+#######
+
+uv
+""
+
+* Add a new plugin for projects using `uv <https://docs.astral.sh/uv/>`_.
+  For more information, see :doc:`uv plugin reference
+  </reference/plugins/uv_plugin>`.
 
 8.5.1 (2024-Dec-17)
 -------------------

docs/reference/plugins.rst

@@ -16,6 +16,7 @@ Snapcraft.
    /common/craft-parts/reference/plugins/cmake_plugin
    /common/craft-parts/reference/plugins/dump_plugin
    /common/craft-parts/reference/plugins/go_plugin
+   /common/craft-parts/reference/plugins/go_use_plugin
    /common/craft-parts/reference/plugins/make_plugin
    plugins/maven_plugin
    /common/craft-parts/reference/plugins/meson_plugin
@@ -26,3 +27,4 @@ Snapcraft.
    /common/craft-parts/reference/plugins/qmake_plugin
    /common/craft-parts/reference/plugins/rust_plugin
    /common/craft-parts/reference/plugins/scons_plugin
+   plugins/uv_plugin

docs/reference/plugins/uv_plugin.rst

@@ -0,0 +1,7 @@
+.. include:: /common/craft-parts/reference/plugins/uv_plugin.rst
+   :end-before: .. _uv-details-begin:
+
+.. include:: _python_common.rst
+
+.. include:: /common/craft-parts/reference/plugins/uv_plugin.rst
+   :start-after: .. _uv-details-end:

requirements-devel.txt

@@ -59,7 +59,7 @@ craft-grammar==2.0.1
     # via
     #   craft-application
     #   snapcraft (setup.py)
-craft-parts==2.1.2
+craft-parts @ git+https://github.com/canonical/craft-parts@main
     # via
     #   craft-application
     #   snapcraft (setup.py)

requirements-docs.txt

@@ -486,4 +486,4 @@ ws4py==0.5.1
 
 # The following packages are considered to be unsafe in a requirements file:
 # setuptools
-python-apt @ https://launchpad.net/ubuntu/+archive/primary/+sourcefiles/python-apt/2.4.0ubuntu1/python-apt_2.4.0ubuntu1.tar.xz ; sys.platform == "linux"
+python-apt @ https://launchpad.net/ubuntu/+archive/primary/+sourcefiles/python-apt/2.4.0ubuntu1/python-apt_2.4.0ubuntu1.tar.xz ; sys.platform == "linux"

requirements.txt

@@ -41,7 +41,7 @@ craft-grammar==2.0.1
     # via
     #   craft-application
     #   snapcraft (setup.py)
-craft-parts==2.1.2
+craft-parts @ git+https://github.com/canonical/craft-parts@main
     # via
     #   craft-application
     #   snapcraft (setup.py)

setup.py

@@ -102,7 +102,7 @@ def recursive_data_files(directory, install_directory):
     "craft-archives~=2.0",
     "craft-cli~=2.9",
     "craft-grammar>=2.0.1,<3.0.0",
-    "craft-parts>=2.1.2,<3.0.0",
+    "craft-parts @ git+https://github.com/canonical/craft-parts@main",
     "craft-platforms~=0.4",
     "craft-providers>=2.0.4,<3.0.0",
     "craft-store>=3.0.2,<4.0.0",

snapcraft/parts/plugins/__init__.py

@@ -1,6 +1,6 @@
 # -*- Mode:Python; indent-tabs-mode:nil; tab-width:4 -*-
 #
-# Copyright 2022 Canonical Ltd.
+# Copyright 2022, 2025 Canonical Ltd.
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License version 3 as
@@ -17,14 +17,16 @@
 """Snapcraft specific plugins."""
 
 
+from .register import get_plugins, register
+
 from .colcon_plugin import ColconPlugin
 from .conda_plugin import CondaPlugin
 from .flutter_plugin import FlutterPlugin
 from .kernel_plugin import KernelPlugin
 from .matter_sdk_plugin import MatterSdkPlugin
 from .poetry_plugin import PoetryPlugin
 from .python_plugin import PythonPlugin
-from .register import get_plugins, register
+from .uv_plugin import UvPlugin
 
 __all__ = [
     "ColconPlugin",
@@ -36,4 +38,5 @@
     "PythonPlugin",
     "get_plugins",
     "register",
+    "UvPlugin",
 ]

snapcraft/parts/plugins/register.py

@@ -1,6 +1,6 @@
 # -*- Mode:Python; indent-tabs-mode:nil; tab-width:4 -*-
 #
-# Copyright 2022 Canonical Ltd.
+# Copyright 2022, 2025 Canonical Ltd.
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License version 3 as
@@ -26,6 +26,7 @@
 from .matter_sdk_plugin import MatterSdkPlugin
 from .poetry_plugin import PoetryPlugin
 from .python_plugin import PythonPlugin
+from .uv_plugin import UvPlugin
 
 
 def get_plugins(core22: bool) -> dict[str, PluginType]:
@@ -40,6 +41,7 @@ def get_plugins(core22: bool) -> dict[str, PluginType]:
         "python": PythonPlugin,
         "matter-sdk": MatterSdkPlugin,
         "poetry": PoetryPlugin,
+        "uv": UvPlugin,
     }
 
     if core22:

snapcraft/parts/plugins/uv_plugin.py

@@ -0,0 +1,32 @@
+# -*- Mode:Python; indent-tabs-mode:nil; tab-width:4 -*-
+#
+# Copyright 2025 Canonical Ltd.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""Snapcraft uv plugin"""
+
+from typing import Optional
+
+from craft_parts.plugins import uv_plugin
+from overrides import override
+
+from snapcraft.parts.plugins import python_common
+
+
+class UvPlugin(uv_plugin.UvPlugin):
+    """A uv plugin for Snapcraft."""
+
+    @override
+    def _get_system_python_interpreter(self) -> Optional[str]:
+        return python_common.get_system_interpreter(self._part_info)

tests/spread/core24/python-hello/task.yaml

@@ -9,6 +9,7 @@ environment:
   PARAM/strict: ""
   PARAM/classic: "--classic"
   PARAM/poetry: ""
+  PARAM/uv: ""
 
 restore: |
   cd ./"${SPREAD_VARIANT}"

tests/spread/core24/python-hello/uv/snap/snapcraft.yaml

@@ -0,0 +1,16 @@
+name: python-hello-uv
+version: "1.0"
+summary: simple python application
+description: build a python application using core24
+base: core24
+confinement: strict
+
+apps:
+  python-hello-uv:
+    command: bin/python $SNAP/bin/hello
+parts:
+  hello:
+    plugin: uv
+    source: src
+    build-snaps:
+      - astral-uv

tests/spread/core24/python-hello/uv/src/hello/__init__.py

@@ -0,0 +1,5 @@
+import black
+
+
+def main():
+    print(f"hello world! black version: {black.__version__}")

tests/spread/core24/python-hello/uv/src/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "hello"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "black==24.8.0",
+]
+
+[build-system]
+requires = ["setuptools>61"]
+build-backend = "setuptools.build_meta"
+
+[project.scripts]
+hello = "hello:main"

tests/spread/core24/python-hello/uv/src/setup.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+
+from distutils.core import setup
+
+setup(
+    name="hello",
+    version="0.1",
+    entry_points={"console_scripts": ["hello=hello:main"]},
+    packages=["hello"],
+)