fix(julia-version): обновлена версия Julia до 1.10

modified: Dockerfile Установка с juliaup. modified: book/**/*.md Обновлены версии ядра для исполнения кода. new file: book/change-kernel.py Скрипт для обновления ядер исполнения кода. new file: julia-requirements-exact-for-reference.txt new file: python-requirements-exact-for-reference.txt Снэпшоты точных версий пакетов Python и Julia для сборки книги. Closes #78
stepanzh · Aug 4, 2024 · f20822c · f20822c
1 parent 2552837
commit f20822c
Show file tree

Hide file tree

Showing 30 changed files with 289 additions and 98 deletions.
diff --git a/Dockerfile b/Dockerfile
@@ -17,31 +17,30 @@ RUN <<EOF
 apt update
 
 # python 3 and wget
-apt install -y python3 wget
+apt install -y python3 curl
 
 # pip
-wget https://bootstrap.pypa.io/get-pip.py
-python3 get-pip.py
-rm get-pip.py
+curl -fsSL https://bootstrap.pypa.io/get-pip.py | python3
 
 # Python packages
 pip install -r python-requirements.txt
 
-# Julia 1.9.4
-wget https://julialang-s3.julialang.org/bin/linux/x64/1.9/julia-1.9.4-linux-x86_64.tar.gz
-tar zxvf julia-1.9.4-linux-x86_64.tar.gz
-rm julia-1.9.4-linux-x86_64.tar.gz
-mv julia-1.9.4 /usr/local/bin/
-## доступ к julia внутри контейнера по `julia`
-ln -s /usr/local/bin/julia-1.9.4/bin/julia /usr/local/bin/julia
 
+# Julia 1.10+
+## Juliaup
+curl -fsSL https://install.julialang.org | sh -s -- --yes --default-channel 1.10
+## Экспорт команд julia и juliaup
+. ~/.bashrc
 # Julia пакеты из Project.toml
 
 ## Инициализация глобального окружения julia (/root/.julia директория).
 julia -e "using Pkg; Pkg.instantiate()"
 ## Проставляем глобальное окружение Julia в контейнере.
-## Не оставляйте `/root/Project.toml`!!! Иначе jupyter-book будет ссылаться на него, а не глобальное окружение.
-cp julia-requirements.toml /root/.julia/environments/v1.9/Project.toml
+## Не оставляйте `/root/Project.toml`!!! Иначе jupyter-book будет (неявно) ссылаться на него, а не на глобальное окружение.
+##  Именно с этой целью файл с зависимостями Julia назван julia-requirements.toml, а не Project.toml.
+
+cp julia-requirements.toml ~/.julia/environments/v1.10/Project.toml
+
 ## Грузим и устанавливаем пакеты, перечисленные в Project.toml.
 julia -e "using Pkg; Pkg.resolve(); Pkg.instantiate(); Pkg.precompile()"
 

diff --git a/book/autodiff/compgraph.md b/book/autodiff/compgraph.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/autodiff/complexstep.md b/book/autodiff/complexstep.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/autodiff/dualnumbers.md b/book/autodiff/dualnumbers.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}
@@ -237,6 +237,7 @@ f'(x) = \log{x^2} + 2, \quad x \neq 0,
 
 ```{code-cell}
 :tags: [remove-output]
+
 f(x) = 3 + x * log(x^2)
 df(x) = log(x^2) + 2
 ```

diff --git a/book/change-kernel.py b/book/change-kernel.py
@@ -0,0 +1,94 @@
+# Обновление julia kernel для MyST файлов.
+# Скрипт итерируется по файлам книге, отыскивая Markdown файлы с заголовком от MyST.
+# 
+# ПРЕДУПРЕЖДЕНИЕ
+# ПЕРЕД ЗАПУСКОМ ПРОВЕРЬТЕ ПЕРЕМЕННЫЕ JUPYTER_KERNELSPEC_FOR_JULIA и BOOK_LOCATION_INSIDE_CONTAINER.
+#
+# Подразумевается, что должен менять эту часть файла
+# ---
+# jupytext:
+#   formats: md:myst
+#   text_representation:
+#     extension: .md
+#     format_name: myst
+#     format_version: 0.13      --> (автоматически)
+#     jupytext_version: 1.16.4  --> (автоматически)
+# kernelspec:
+#   display_name: Julia 1.10.4  --> (автоматически)
+#   language: julia
+#   name: julia-1.10            --> JUPYTER_KERNELSPEC_FOR_JULIA
+# ---
+#
+# Степан Захаров [email protected]
+# 2024
+
+
+import os
+import subprocess
+
+# Название ядра jupyter, созданного IJulia
+JUPYTER_KERNELSPEC_FOR_JULIA = 'julia-1.10'
+BOOK_LOCATION_INSIDE_CONTAINER = '/root/book/'
+
+
+def show_container_warning():
+    print('Обнаружен запуск из-под пользовательской машины')
+    print('Запустите этот скрипт из docker-контейнера')
+
+
+
+
+# Проверка на то, что скрипт исполняется в контейнере
+
+# Пытаемся прочесть содержание /run/systemd/container
+# На моём компе в контейнере прописано 'docker'
+_container_file = '/run/systemd/container'
+if not os.path.exists(_container_file):
+    show_container_warning()
+    exit(1)
+
+_container_file_content = ''
+with open(_container_file) as io:
+    _container_file_content = io.read()
+
+if not _container_file_content.startswith('docker'):
+    show_container_warning()
+    exit(1)
+
+
+
+
+root = BOOK_LOCATION_INSIDE_CONTAINER
+files_for_update = []
+
+# Фильтруем файлы с расширением .md и содержащие jupytext
+# настройки для исполнения кода
+for (dirpath, dirnames, filenames) in os.walk(root):
+    for filename in filenames:
+        filepath = os.path.join(dirpath, filename)
+        _, suffix = os.path.splitext(filepath)
+
+        if suffix != '.md':
+            continue
+
+        with open(filepath) as io:
+            content = io.read()
+            if content.startswith('---\njupytext'):
+                files_for_update.append(filepath)
+
+
+print('Следующие файлы будут обновлены')
+for x in files_for_update:
+    print('', x)
+
+# Здесь полагаемся на встроенную утилиту jupyter-book myst init.
+
+for x in files_for_update:
+    subprocess.run([
+        'jupyter-book',
+        'myst',
+        'init',
+        '--kernel',
+        JUPYTER_KERNELSPEC_FOR_JULIA,
+        x,
+    ])
diff --git a/book/integration/adaptive.md b/book/integration/adaptive.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/integration/newton_cotes.md b/book/integration/newton_cotes.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/interpolation/cubic_spline.md b/book/interpolation/cubic_spline.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/interpolation/ex.md b/book/interpolation/ex.md
@@ -5,15 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
-myst:
-  substitutions:
-    url_omega22_table: "<a href=\"https://raw.githubusercontent.com/stepanzh/computational_thermodynamics/main/book/static/golubev1971_omega22.pdf\" target=\"_blank\">pdf</a>"
-    url_feta_table: "<a href=\"https://raw.githubusercontent.com/stepanzh/computational_thermodynamics/main/book/static/golubev1971_feta.pdf\" target=\"_blank\">pdf</a>"
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/interpolation/polynomial.md b/book/interpolation/polynomial.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/interpolation/pwlinear.md b/book/interpolation/pwlinear.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/intro/cond.md b/book/intro/cond.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/intro/float.md b/book/intro/float.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/julia/index.md b/book/julia/index.md
@@ -5,14 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
-myst:
-  substitutions:
-    julia_logo: "<img src=\"https://raw.githubusercontent.com/JuliaLang/julia-logo-graphics/master/images/julia-dots.svg\" style=\"height: 1em;\">"
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/nlroot/bisection_regula_falsi.md b/book/nlroot/bisection_regula_falsi.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{code-cell}

diff --git a/book/nlroot/ex.md b/book/nlroot/ex.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/nlroot/itp.md b/book/nlroot/itp.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}

diff --git a/book/nlroot/newton_secant.md b/book/nlroot/newton_secant.md
@@ -5,11 +5,11 @@ jupytext:
     extension: .md
     format_name: myst
     format_version: 0.13
-    jupytext_version: 1.16.0
+    jupytext_version: 1.16.4
 kernelspec:
-  display_name: Julia 1.9.4
+  display_name: Julia 1.10.4
   language: julia
-  name: julia-1.9
+  name: julia-1.10
 ---
 
 ```{eval-rst}