payloadsallthethings: 3.0 -> 4.2 (2025.1), render using mkdocs (#431002)

pkgs/by-name/pa/payloadsallthethings/mkdocs.patch

@@ -0,0 +1,21 @@
+diff --git a/mkdocs.yml b/mkdocs.yml
+index 1c4cd92..9af93f0 100644
+--- a/mkdocs.yml
++++ b/mkdocs.yml
+@@ -59,14 +59,9 @@ markdown_extensions:
+       anchor_linenums: true
+   - pymdownx.tasklist:
+       custom_checkbox: true
+-  - pymdownx.emoji:
+-      emoji_index: !!python/name:material.extensions.emoji.twemoji
+-      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+   # - mdx_truly_sane_lists:
+   #     nested_indent: 2
+   #     truly_sane: True
+- 
++
+ plugins:
+   - search
+-  - git-revision-date-localized
+-  - social
+\ No newline at end of file

pkgs/by-name/pa/payloadsallthethings/package.nix

@@ -2,24 +2,54 @@
   lib,
   fetchFromGitHub,
   stdenvNoCC,
+  python3Packages,
+  yq,
 }:
-
+let
+  inherit (python3Packages) mkdocs mkdocs-material pymdown-extensions;
+in
 stdenvNoCC.mkDerivation {
   pname = "payloadsallthethings";
-  version = "3.0-unstable-2024-01-21";
+  version = "2025.1";
 
   src = fetchFromGitHub {
     owner = "swisskyrepo";
     repo = "PayloadsAllTheThings";
-    rev = "97cfeee270395a838802fa1fcb8a4d5ffc6d6b48";
+    tag = "4.2";
-    hash = "sha256-LRS60v0o5nPSLfGFH6P0Y5roN8Mk5/KyRF4SWTv/7Hw=";
+    hash = "sha256-LBPlGfmIyzgRhUdAJmPxjDB7D8iRHcSA8Tf5teMnFzA=";
   };
 
+  patches = [ ./mkdocs.patch ];
+
+  nativeBuildInputs = [
+    mkdocs
+    mkdocs-material
+    pymdown-extensions
+
+    yq
+  ];
+
+  outputs = [
+    "out"
+    "doc"
+  ];
+
+  buildPhase = ''
+    yq -yi '.docs_dir = "source"' mkdocs.yml
+    mkdir overrides
+    mv mkdocs.yml ..
+    cd ..
+    mkdocs build --theme material
+  '';
+
   installPhase = ''
     runHook preInstall
+    mkdir -p $doc/share/payloadsallthethings
+    cp -r site/* $doc/share/payloadsallthethings
+
     mkdir -p $out/share/payloadsallthethings
-    rm CONTRIBUTING.md mkdocs.yml custom.css
+    rm source/CONTRIBUTING.md source/custom.css
-    cp -a * $out/share/payloadsallthethings
+    cp -r source/* $out/share/payloadsallthethings
     runHook postInstall
   '';
 
@@ -27,7 +57,10 @@ stdenvNoCC.mkDerivation {
     homepage = "https://github.com/swisskyrepo/PayloadsAllTheThings";
     description = "List of useful payloads and bypass for Web Application Security and Pentest/CTF";
     license = with lib.licenses; [ mit ];
-    maintainers = with lib.maintainers; [ shard7 ];
+    maintainers = with lib.maintainers; [
+      shard7
+      felbinger
+    ];
     platforms = lib.platforms.all;
     sourceProvenance = with lib.sourceTypes; [ fromSource ];
   };