From df0754249418f71fb97d7a9abe839587067cda08 Mon Sep 17 00:00:00 2001
From: nicoco <nicoco@nicoco.fr>
Date: Mon, 20 Mar 2023 15:09:11 +0100
Subject: [PATCH] ci: use old poetry installer

because this breaks installation of our docs theme
https://github.com/python-poetry/poetry/pull/7358
https://github.com/pradyunsg/sphinx-theme-builder/pull/39
---
 dev/Containerfile-ci        |  7 ++++++-
 docs/source/dev/general.rst | 13 +++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/dev/Containerfile-ci b/dev/Containerfile-ci
index ea6521e6..5b4560bb 100644
--- a/dev/Containerfile-ci
+++ b/dev/Containerfile-ci
@@ -8,6 +8,12 @@ RUN apt-get install -y --no-install-recommends curl rustc cargo gcc libssl-dev m
 RUN python3 -m pip install wheel pybindgen
 RUN curl -fL https://install.python-poetry.org | python3 - || cat /poetry-installer-error-*
 
+ENV PATH=/root/.local/bin:$PATH
+# furo (sphinx theme) cannot install without that,
+# cf https://github.com/python-poetry/poetry/pull/7358
+RUN poetry config installer.modern-installation false
+RUN poetry config experimental.new-installer true
+
 ENV GOBIN="/usr/local/bin"
 RUN go install github.com/go-python/gopy@latest && \
     go install golang.org/x/tools/cmd/goimports@latest
@@ -22,7 +28,6 @@ COPY tests/ /build/tests
 COPY dev/ /build/dev
 COPY docs/ /build/docs
 
-ENV PATH=/root/.local/bin:$PATH
 ARG TARGETARCH
 RUN poetry build
 RUN if [ "$TARGETARCH" = "amd64" ]; then \
diff --git a/docs/source/dev/general.rst b/docs/source/dev/general.rst
index 3c6bb293..b8522f4b 100644
--- a/docs/source/dev/general.rst
+++ b/docs/source/dev/general.rst
@@ -25,6 +25,19 @@ of XEPs, especially when it comes to components.
 You can launch it with the ``-p`` option to use a clean profile and not mess up
 your normal user settings and such.
 
+Poetry
+------
+
+To install outside of a container, use `poetry <https://python-poetry.org/>`_.
+
+Starting from poetry >= 1.4.0, these extra configuration steps are required, cf
+https://github.com/python-poetry/poetry/pull/7358
+
+.. code-block::
+
+   poetry config installer.modern-installation false
+   poetry config experimental.new-installer true
+
 Contributing
 ------------