myst-parser: bump docutils version requirements

Author: smunix

docs/requirements.txt

@@ -1,4 +1,4 @@
 Sphinx==4.0.2
 sphinx-rtd-theme==0.5.2
 myst-parser==0.15.1
-docutils<0.17
+docutils<0.19

docutils.nix

@@ -0,0 +1,32 @@
+{ stdenv, lib, fetchPypi, buildPythonPackage, isPy3k, python }:
+
+buildPythonPackage rec {
+  pname = "docutils";
+  version = "0.17.1";
+
+  src = fetchPypi {
+    inherit pname version;
+    sha256 = "686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125";
+  };
+
+  # Only Darwin needs LANG, but we could set it in general.
+  # It's done here conditionally to prevent mass-rebuilds.
+  checkPhase = lib.optionalString (isPy3k && stdenv.isDarwin)
+    ''LANG="en_US.UTF-8" LC_ALL="en_US.UTF-8" '' + ''
+      ${python.interpreter} test/alltests.py
+    '';
+
+  # Create symlinks lacking a ".py" suffix, many programs depend on these names
+  postFixup = ''
+    for f in $out/bin/*.py; do
+      ln -s $(basename $f) $out/bin/$(basename $f .py)
+    done
+  '';
+
+  meta = with lib; {
+    description = "Python Documentation Utilities";
+    homepage = "http://docutils.sourceforge.net/";
+    license = with licenses; [ publicDomain bsd2 psfl gpl3Plus ];
+    maintainers = with maintainers; [ AndersonTorres ];
+  };
+}

flake.lock

@@ -63,6 +63,15 @@
       url = "https://hackage.haskell.org/package/hie-bios-0.9.1/hie-bios-0.9.1.tar.gz";
       flake = false;
     };
+    myst-parser = {
+      url = "github:smunix/MyST-Parser?ref=fix.hls-docutils"; 
+      flake = false;
+    };
+    sphinx_rtd_theme = {
+      url = "github:readthedocs/sphinx_rtd_theme?rev=34f81daaf52466366c80003db293d50075c1b896";
+      flake = false;
+    };
+    poetry2nix.url = "github:nix-community/poetry2nix/master";
   };
   outputs =
     inputs@{ self, nixpkgs, flake-compat, flake-utils, pre-commit-hooks, gitignore, ... }:
@@ -169,7 +178,7 @@
       let
         pkgs = import nixpkgs {
           inherit system;
-          overlays = [ self.overlay ];
+          overlays = [ self.overlay inputs.poetry2nix.overlay ];
           config = { allowBroken = true; };
         };
 
@@ -217,16 +226,27 @@
         ghc922 = ghc922Config.tweakHpkgs (pkgs.hlsHpkgs "ghc922");
 
         # For markdown support
-        myst-parser = pkgs.python3Packages.callPackage ./myst-parser.nix {};
-        sphinx_rtd_theme = pkgs.python3Packages.sphinx_rtd_theme.overrideAttrs (oldAttrs: {
-          # For https://github.com/readthedocs/sphinx_rtd_theme/pull/1185, otherwise lists are broken locally
-          src = pkgs.fetchFromGitHub {
-            owner = "readthedocs";
-            repo = "sphinx_rtd_theme";
-            rev = "34f81daaf52466366c80003db293d50075c1b896";
-            sha256 = "0rkrsvvqr6g2p3v5vq88jhfp5sd0r1jqjh3vc5y26jn30z8s4fkz";
-          };
-        });
+        # myst-parser = (pkgs.python3Packages.callPackage ./myst-parser.nix {}).overrideAttrs (oldAttrs: { src = inputs.myst-parser; });
+        myst-parser = pkgs.poetry2nix.mkPoetryEnv {
+          projectDir = inputs.myst-parser;
+          python = pkgs.python39;
+          overrides = [ 
+            pkgs.poetry2nix.defaultPoetryOverrides
+            (self: super: {
+              docutils = pkgs.python3Packages.callPackage ./docutils.nix {};
+            })
+          ];
+        };
+        sphinx_rtd_theme = pkgs.poetry2nix.mkPoetryEnv {
+          projectDir = inputs.sphinx_rtd_theme;
+          python = pkgs.python39;
+          overrides = [ 
+            pkgs.poetry2nix.defaultPoetryOverrides
+            (self: super: {
+              docutils = pkgs.python3Packages.callPackage ./docutils.nix {};
+            })
+          ];
+        };
         pythonWithPackages = pkgs.python3.withPackages (ps: [ps.sphinx myst-parser sphinx_rtd_theme ps.pip]);
 
         docs = pkgs.stdenv.mkDerivation {