renderers: Add mkPythonEditablePackage

nix-community · Sep 4, 2024 · e769fce · e769fce
1 parent 424e960
commit e769fce
Show file tree

Hide file tree

Showing 3 changed files with 88 additions and 2 deletions.
diff --git a/lib/renderers.nix b/lib/renderers.nix
@@ -3,6 +3,7 @@
   pep508,
   pep440,
   pep621,
+  renderers,
   ...
 }:
 let
@@ -19,6 +20,7 @@ let
     mapAttrs
     filterAttrs
     concatMap
+    nameValuePair
     ;
 
   # Group licenses by their SPDX IDs for easy lookup
@@ -103,7 +105,7 @@ in
       project,
       # Python derivation
       python,
-      # Python extras (markers) to enable.
+      # Python extras (optional-dependencies) to enable.
       extras ? [ ],
       # Map a Python extras group name to a Nix attribute set like:
       # { dev = "checkInputs"; }
@@ -201,4 +203,64 @@ in
         }
       )
       (attrNames filteredDeps.extras);
+
+  /*
+    Renders a project as an argument that can be passed to mkPythonEditablePackage.
+
+    Evaluates PEP-508 environment markers to select correct dependencies for the platform but does not validate version constraints.
+    For validation see `lib.validators`.
+
+    Type: mkPythonEditablePackage :: AttrSet -> AttrSet
+
+    Example:
+      # mkPythonEditablePackage { project = lib.project.loadPyproject ...; python = pkgs.python3;  }
+        { pname = "blinker"; version = "1.3.3.7"; dependencies = [ ]; }
+  */
+  mkPythonEditablePackage =
+    {
+      # Project metadata as returned by `lib.project.loadPyproject`
+      project,
+      # Unknown args passed on verbatim to renderers.buildPythonPackage
+      ...
+    }@args:
+    let
+      # Render using buildPythonPackage
+      attrs = renderers.buildPythonPackage args;
+
+      project' = project.pyproject.project;
+    in
+    # Reshape into mkPythonEditablePackage
+    {
+      inherit (attrs)
+        dependencies
+        optional-dependencies
+        build-system
+        meta
+        ;
+    }
+    // optionalAttrs (attrs ? src) {
+      # Note: Has to be --impure with flakes, or overriden
+      root = toString attrs.src;
+    }
+    // optionalAttrs (project' ? scripts) {
+      inherit (project') scripts;
+    }
+    // optionalAttrs (project' ? gui-scripts) {
+      inherit (project') gui-scripts;
+    }
+    // optionalAttrs (project' ? entry-points) {
+      inherit (project') entry-points;
+    }
+    // optionalAttrs (attrs ? pname) {
+      inherit (attrs) pname;
+    }
+    // optionalAttrs (attrs ? version) {
+      inherit (attrs) version;
+    }
+    // optionalAttrs (args ? extrasAttrMappings && args.extrasAttrMappings != { }) {
+      # Inject derivationArgs for additional functionality
+      derivationArgs = lib.listToAttrs (
+        map (attr: nameValuePair attr attrs.${attr}) (attrValues args.extrasAttrMappings)
+      );
+    };
 }
diff --git a/lib/test_project.nix b/lib/test_project.nix
@@ -391,6 +391,7 @@ lib.fix (self: {
       expected = {
         renderers = [
           "buildPythonPackage"
+          "mkPythonEditablePackage"
           "withPackages"
         ];
         requires-python = null;

diff --git a/lib/test_renderers.nix b/lib/test_renderers.nix
@@ -33,7 +33,7 @@ let
     // optionalAttrs (attrs ? checkInputs) { checkInputs = map (drv: drv.pname) attrs.checkInputs; };
 
 in
-{
+rec {
   # withPackages can't be easily tested by mocks, dummy out.
   # Tested by integration tests.
   withPackages = {
@@ -43,6 +43,29 @@ in
     };
   };
 
+  mkPythonEditablePackage = {
+    testPdm = {
+      expr = clearDrvInputs (
+        renderers.mkPythonEditablePackage {
+          project = projects.pdm;
+          python = mocks.cpythonLinux38;
+        }
+      );
+      expected = {
+        inherit (buildPythonPackage.testPdm.expected)
+          dependencies
+          optional-dependencies
+          build-system
+          meta
+          pname
+          ;
+        scripts = {
+          pdm = "pdm.core:main";
+        };
+      };
+    };
+  };
+
   buildPythonPackage = {
     testPdm = {
       expr = clearDrvInputs (