From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id CDA33158064 for ; Mon, 6 May 2024 17:13:43 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id D738FE2AE1; Mon, 6 May 2024 17:13:38 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 707E4E2AB5 for ; Mon, 6 May 2024 17:13:38 +0000 (UTC) From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Cc: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Subject: [gentoo-dev] [REVIEW news] 2024-05-09-python3-12: Add Date: Mon, 6 May 2024 19:13:30 +0200 Message-ID: <20240506171330.12628-1-mgorny@gentoo.org> X-Mailer: git-send-email 2.45.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: 6df4c4d9-76eb-4fa7-b4ad-9119d068d084 X-Archives-Hash: 80400cc116e09b22de62b0cdb3bb5f46 Signed-off-by: Michał Górny --- .../2024-05-09-python3-12.en.txt | 120 ++++++++++++++++ .../2024-05-09-python3-12.pl.txt | 133 ++++++++++++++++++ 2 files changed, 253 insertions(+) create mode 100644 2024-05-09-python3-12/2024-05-09-python3-12.en.txt create mode 100644 2024-05-09-python3-12/2024-05-09-python3-12.pl.txt diff --git a/2024-05-09-python3-12/2024-05-09-python3-12.en.txt b/2024-05-09-python3-12/2024-05-09-python3-12.en.txt new file mode 100644 index 0000000..cedb196 --- /dev/null +++ b/2024-05-09-python3-12/2024-05-09-python3-12.en.txt @@ -0,0 +1,120 @@ +Title: Python 3.12 to become the default on 2024-06-01 +Author: Michał Górny +Posted: 2024-05-09 +Revision: 1 +News-Item-Format: 2.0 +Display-If-Installed: dev-lang/python:3.10 +Display-If-Installed: dev-lang/python:3.11 + +We are planning to switch the default Python target of Gentoo systems +on 2024-06-01, from Python 3.11 to Python 3.12. If you have not changed +the values of PYTHON_TARGETS or PYTHON_SINGLE_TARGET, the change will +have immediate effect on your system and the package manager will try +to switch automatically on the next upgrade following the change. + +If you did change the values, prefer a safer approach or have problems +with the update, read on. + +Please note that the default upgrade method switches packages to the new +Python versions as they are rebuilt. This means that all interdependent +packages have to support the new version for the upgrade to proceed, +and that some programs may temporarily fail to find their dependencies +throughout the upgrade (although programs that are already started +are unlikely to be affected). + + +If you have PYTHON_TARGETS or PYTHON_SINGLE_TARGET declared +in make.conf, please remove these declarations as they will interfere +with the package.use samples provided below. Using make.conf for Python +targets is discouraged as it prevents package defaults from applying +when necessary. This news item assumes using /etc/portage/package.use +or your package manager's equivalent file for configuration. + + +At this point, you have a few configuration options to choose from: + +1. If you wish Python upgrades to apply automatically, you can remove + PYTHON_TARGETS and PYTHON_SINGLE_TARGET declarations. When + the defaults change, your package manager should handle the upgrade + automatically. However, you may still need to run the update + commands if any problems arise. + +2. If you wish to defer the upgrade for the time being, you can + explicitly set the old values in package.use. + +3. If you wish to force the upgrade earlier, you can explicitly set + the new values and run the upgrade commands. + +4. If you wish to use a safer approach (i.e. less likely to temporarily + break packages during the upgrade), you can perform a multi-step + upgrade as outlined below. + +5. Finally, you can use an arbitrary combination of PYTHON_TARGETS + and PYTHON_SINGLE_TARGET. + + +Deferring the upgrade +===================== +To defer the upgrade, explicitly set the old targets: + + */* PYTHON_TARGETS: -* python3_11 + */* PYTHON_SINGLE_TARGET: -* python3_11 + +This will enforce Python 3.11 and block any future updates. However, +please note that this is only a temporary solution and you will +eventually need to perform the migration. + + +Forcing the upgrade +=================== +To force the upgrade earlier, explicitly select the Python 3.12 targets: + + */* PYTHON_TARGETS: -* python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +However, it is important to remember to remove this after the defaults +change, as it will interfere with the automatic switch to the next +Python version in the future. + + +Safer upgrade procedure +======================= +A safer approach is to add Python 3.12 support to your system first, +and only then remove Python 3.11. However, note that this involves two +rebuilds of all the affected packages, so it will take noticeably +longer. + +First, enable both Python 3.11 and Python 3.12, and then run the upgrade +commands: + + */* PYTHON_TARGETS: -* python3_11 python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_11 + +Then switch PYTHON_SINGLE_TARGET and run the second batch of upgrades: + + */* PYTHON_TARGETS: -* python3_11 python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +Finally, switch to the final version and upgrade: + + */* PYTHON_TARGETS: -* python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +You may wish to remove the target overrides after the defaults switch. +Alternatively, you can keep them to block the next automatic upgrade +to Python 3.13, and upgrade manually then. + + +Upgrade commands +================ +The Python 3.11 cleanup requires that Python 3.11 is removed from +the complete dependency trees in batch. If some of the +installed packages using an older Python version are not triaged +for the upgrade, the package manager will throw dependency conflicts. +This makes it important that the upgrade is carried via a --deep +--changed-use @world upgrade, as well as that any stray packages +are removed prior to it, e.g.: + + emerge --depclean + emerge -1vUD @world + emerge --depclean diff --git a/2024-05-09-python3-12/2024-05-09-python3-12.pl.txt b/2024-05-09-python3-12/2024-05-09-python3-12.pl.txt new file mode 100644 index 0000000..0870e41 --- /dev/null +++ b/2024-05-09-python3-12/2024-05-09-python3-12.pl.txt @@ -0,0 +1,133 @@ +Title: Python 3.12 stanie się domyślną wersją począwszy od 2024-06-01 +Author: Michał Górny +Translator: Michał Górny +Posted: 2024-05-09 +Revision: 1 +News-Item-Format: 2.0 +Display-If-Installed: dev-lang/python:3.10 +Display-If-Installed: dev-lang/python:3.11 + +Gentoo planuje zmienić domyślną wersję Pythona z 3.11 na 3.12 w dniu +1. czerwca 2024 r. Użytkownicy, którzy nie zmieniali wartości flag +PYTHON_TARGETS oraz PYTHON_SINGLE_TARGET nie muszą nic robić. Menadżer +pakietów automatycznie zaktualizuje wsparcie Pythona do nowej wersji +przy kolejnej aktualizacji systemu po tej zmianie. + +Informacje zawarte w tej wiadomości przeznaczone są dla użytkowników, +którzy zmieniali preferowaną wersję Pythona bądź chcą przeprowadzić +aktualizację w bezpieczniejszy sposób. + +Uwaga: standardowa metoda aktualizacji podmienia obsługiwaną wersję +Pythona w poszczególnych pakietach w miarę ich aktualizacji. +Oznacza to, że aktualizacja systemu możliwa będzie wyłącznie, jeżeli +wszystkie zainstalowane pakiety obsługują nową wersję. W trakcie +aktualizacji zależności poszczególnych zainstalowanych programów mogą +stać się tymczasowo niedostępne, nie powinno to jednak mieć wpływu +na działanie już uruchomionych aplikacji. + + +Użytkownicy, którzy wykorzystują plik make.conf do ustawienia wartości +zmiennych PYTHON_TARGETS lub PYTHON_SINGLE_TARGET powinni usunąć +te wartości, gdyż będą one kolidowały z przykładami package.use +przedstawionymi w tej wiadomości. Wykorzystywanie pliku make.conf +do konfiguracji tych zmiennych jest niewskazane, gdyż ustawienia te +nadpisują domyślne wartości flag zawarte w poszczególnych pakietach. +Dalszy ciąg tej wiadomości zakłada wykorzystywanie package.use +lub równoważnego pliku konfiguracyjnego. + + +Dostępne są następujące możliwości aktualizacji: + +1. Automatyczna aktualizacja wersji Pythona. Aby skorzystać z tej + opcji, należy usunąć zmienne PYTHON_TARGETS + oraz PYTHON_SINGLE_TARGET. Wówczas menadżer pakietów automatycznie + przeprowadzi aktualizację ilekroć zmieni się domyślna wersja Pythona + w Gentoo. Niemniej, może zaistnieć konieczność ręcznej aktualizacji + w przypadku wystąpienia problemów. + +2. Odroczenie aktualizacji poprzez wymuszenie poprzedniej wersji + w pliku package.use. + +3. Wymuszenie wcześniejszej aktualizacji poprzez podanie nowej wersji + i dokonanie aktualizacji systemu. + +4. Zastosowanie bezpiecznego podejścia (tj. zmniejszającego ryzyko + niesprawnych programów w trakcie aktualizacji) poprzez wykonanie + aktualizacji w kilku krokach. Proces ten jest szczegółowo opisany + w dalszej części wiadomości. + +5. Zastosowanie dowolnej kombinacji zmiennych PYTHON_TARGETS + oraz PYTHON_SINGLE_TARGET. + + +Odroczenie aktualizacji +======================= +Aby odroczyć aktualizację do późniejszego terminu, należy wymusić +poprzednią wersję Pythona: + + */* PYTHON_TARGETS: -* python3_11 + */* PYTHON_SINGLE_TARGET: -* python3_11 + +W ten sposób Python 3.11 zostanie wymuszony na stałe i przyszłe +aktualizacje zostaną zablokowane. Należy jednak pamiętać, że jest +to rozwiązanie tymczasowe i w przyszłości aktualizacja stanie się +konieczna. + + +Wymuszenie aktualizacji +======================= +Aby wymusić aktualizację wcześniej, należy wybrać Pythona 3.12: + + */* PYTHON_TARGETS: -* python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +Zalecane jest jednak usunięcie tych ustawień po podanym wyżej terminie, +aby nie kolidowały w przyszłości z kolejną zmianą domyślnej wersji +Pythona. + + +Bezpieczna procedura aktualizacji +================================= +Bezpieczniejszą alternatywą do standardowego procesu jest wprowadzenie +wsparcia Pythona 3.12 w pierwszym kroku, a następnie usunięcie Pythona +3.11. Należy jednak pamiętać, że będzie wymagało to dwukrotnego +przebudowania wszystkich pakietów używających Pythona, tak więc łączny +czas aktualizacji zostanie wydłużony. + +Najpierw załączyć należy obydwie wersje Pythona i przeprowadzić +aktualizację systemu: + + */* PYTHON_TARGETS: -* python3_11 python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_11 + +Następnie przełączyć należy wartość PYTHON_SINGLE_TARGET i przebudować +pakiety używające tych flag: + + */* PYTHON_TARGETS: -* python3_11 python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +W ostatnim kroku należy wyłączyć poprzednią wersję i przeprowadzić +kolejną aktualizację: + + */* PYTHON_TARGETS: -* python3_12 + */* PYTHON_SINGLE_TARGET: -* python3_12 + +Po terminie zmiany domyślnych wartości, konfigurację tę można usunąć. +Alternatywnie, pozostawienie jej zablokuje przyszłą aktualizację +do Pythona 3.13 i pozwoli na ręczne przeprowadzenie bezpieczniej +aktualizacji. + + +Proces aktualizacji +=================== +Usunięcie Pythona 3.11 wymaga, by odpowiednie flagi zostały jednocześnie +wyłączone w całym drzewie zależności. Jeżeli niektóre z zainstalowanych +pakietów nie zostaną uwzględnione w planowanej aktualizacji, mogą one +zablokować ten proces. Dlatego też istotne jest przeprowadzenie +aktualizacji przy pomocy parametrów `--deep --changed-use @world` bądź +równoważnych, jak również wcześniejsze usunięcie niepotrzebnych +pakietów. Można tego dokonać używając poleceń: + + emerge --depclean + emerge -1vUD @world + emerge --depclean -- 2.45.0