Skip to content

fix(cumulusci): pin docutils to 0.20.1 for rst2ansi compatibility #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
UnstoppableMango merged 2 commits into from
Sep 8, 2026
Merged

fix(cumulusci): pin docutils to 0.20.1 for rst2ansi compatibility #82

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
24544da
fix(cumulusci): pin docutils to 0.20.1 for rst2ansi compatibility
UnstoppableMango Sep 8, 2026
de98169
style: prefix unused `old` parameter with underscore in docutils over…
UnstoppableMango Sep 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 25 additions & 2 deletions pkgs/cumulusci/default.nix
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,31 @@
{
lib,
fetchFromGitHub,
fetchPypi,
nix-update-script,
python313Packages,
}:
let
version = "4.10.1";

# rst2ansi (last released 2018) imports docutils.utils.error_reporting,
# which was removed in docutils 0.21. Pin a standalone docutils to the last
# release that still carries it, scoped to just this package's closure
# (rather than overriding the whole python313Packages set, which forces a
# rebuild-from-source of everything that transitively depends on docutils,
# e.g. sphinx, and its flaky sandboxed test suite).
docutilsOld = python313Packages.docutils.overridePythonAttrs (_old: rec {
version = "0.20.1";
src = fetchPypi {
pname = "docutils";
inherit version;
hash = "sha256-8IpOJ2w6FYOobc4+NKuj/gTQK7ot1R7RYQYkToqSPjs=";
};
# 0.20.1 predates the flit-core packaging used since 0.21.
build-system = [ python313Packages.setuptools ];
Comment thread
UnstoppableMango marked this conversation as resolved.
Resolved
});

rst2ansiOld = python313Packages.rst2ansi.override { docutils = docutilsOld; };
in
# CumulusCI declares requires-python >=3.11,<3.14, so it can't use the default
# interpreter. pkgs/default.nix passes a 3.13 set extended with the libraries
Expand Down Expand Up @@ -39,12 +59,15 @@ python313Packages.buildPythonApplication {
# Includes the `select` extra (annoy, numpy, pandas, scikit-learn), which
# keeps cumulusci.tasks.bulkdata.select_utils on its optimized path; without
# it the task warns and falls back to a slow one.
#
# docutils and rst2ansi come from docutilsOld/rst2ansiOld above, not
# python313Packages, so only one docutils version ends up in the closure.
dependencies = with python313Packages; [
annoy
click
cryptography
defusedxml
docutils
docutilsOld
faker
github3-py
jinja2
Expand All @@ -67,7 +90,7 @@ python313Packages.buildPythonApplication {
robotframework-pabot
robotframework-requests
robotframework-seleniumlibrary
rst2ansi
rst2ansiOld
salesforce-bulk
sarge
scikit-learn
Expand Down