Управление пакетами Pkg

Pkg — это встроенный менеджер пакетов Julia, который отвечает за такие операции, как установка, обновление и удаление пакетов.

Следующее — очень краткое введение в Pkg. Для получения дополнительной информации о файлах Project.toml, файлах Manifest.toml, совместимости версий пакетов ([compat]), средах, реестрах и т. д., настоятельно рекомендуется прочитать полное руководство, доступное по адресу: https://pkgdocs.julialang.org.

Ниже приведён краткий обзор основных функций Pkg. Это должно помочь новым пользователям ознакомиться с основными функциями Pkg, такими как добавление и удаление пакетов и работа со средами.

Некоторая информация об выводе Pkg опущена в этом разделе, чтобы сохранить фокус данного руководства на основных моментах. Это поможет сохранить хороший темп и не углубляться в детали. Если вам потребуются дополнительные сведения, обратитесь к соответствующим разделам руководства Pkg.

В этом руководстве для выполнения команд Pkg используется Pkg REPL. Для использования без интерактивного режима рекомендуется использовать API Pkg. API Pkg полностью документирован в разделе «Справочник по API» документации Pkg по адресу Ссылка на API.

Pkg поставляется с REPL. Для перехода в Pkg REPL нажмите ] из Julia REPL. Чтобы вернуться в Julia REPL, нажмите Ctrl+C или клавишу Backspace (когда курсор REPL находится в начале ввода).

После перехода в Pkg REPL вы должны увидеть следующий приглашающий символ:

(@v1.9) pkg>

Для добавления пакета используйте add:

(@v1.9) pkg> add Example
   Resolving package versions...
   Installed Example ─ v0.5.3
    Updating `~/.julia/environments/v1.9/Project.toml`
  [7876af07] + Example v0.5.3
    Updating `~/.julia/environments/v1.9/Manifest.toml`
  [7876af07] + Example v0.5.3

После установки пакета его можно загрузить в сеанс Julia:

julia> import Example

julia> Example.hello("friend")
"Hello, friend"

Мы также можем указать несколько пакетов для установки одновременно:

(@v1.9) pkg> add JSON StaticArrays

Команда status (или сокращённая команда st) используется для просмотра установленных пакетов.

(@v1.9) pkg> st
Status `~/.julia/environments/v1.6/Project.toml`
  [7876af07] Example v0.5.3
  [682c06a0] JSON v0.21.3
  [90137ffa] StaticArrays v1.5.9

Некоторые команды Pkg REPL имеют краткую и полную версии, например status и st.

Для удаления пакетов используйте rm (или remove):

(@v1.9) pkg> rm JSON StaticArrays

Для обновления установленных пакетов используйте up (или update):

(@v1.9) pkg> up

Если вы следовали этому руководству, то установленные пакеты, вероятно, находятся в последней версии, поэтому up не выполнит никаких действий. Ниже показан выходной статус в случае, когда мы намеренно установили старую версию пакета Example, а затем обновили её:

(@v1.9) pkg> st
Status `~/.julia/environments/v1.9/Project.toml`
⌃ [7876af07] Example v0.5.1
Info Packages marked with ⌃ have new versions available and may be upgradable.

(@v1.9) pkg> up
    Updating `~/.julia/environments/v1.9/Project.toml`
  [7876af07] ↑ Example v0.5.1 ⇒ v0.5.3

Из выходного статуса мы видим, что доступна более новая версия, и что up обновляет пакет.

Для получения дополнительной информации об управлении пакетами обратитесь к разделу Управление пакетами документации.

До этого момента мы рассмотрели основные операции управления пакетами: добавление, обновление и удаление пакетов.

Вы, возможно, заметили (@v1.9) в приглашении REPL. Это позволяет узнать, что v1.9 является активной средой. Различные среды могут иметь совершенно разные пакеты и версии, установленные в другой среде. Активная среда — это среда, которая будет изменена командами Pkg, такими как add, rm и update.

Давайте настроим новую среду для экспериментов. Для установки активной среды используйте activate:

(@v1.9) pkg> activate tutorial
[ Info: activating new environment at `~/tutorial/Project.toml`.

Pkg сообщает нам о создании новой среды и о том, что эта среда будет храниться в каталоге ~/tutorial. Путь к среде создаётся относительно текущей рабочей директории REPL.

Pkg также обновил приглашение REPL для отражения новой активной среды:

(tutorial) pkg>

Мы можем запросить информацию об активной среде, используя status:

(tutorial) pkg> status
    Status `~/tutorial/Project.toml`
   (empty environment)

~/tutorial/Project.toml — это расположение файла проекта активной среды. Файл проекта — это файл TOML, где Pkg хранит пакеты, которые были явно установлены. Обратите внимание, что эта новая среда пуста. Давайте добавим некоторые пакеты и посмотрим:

(tutorial) pkg> add Example JSON
...

(tutorial) pkg> status
    Status `~/tutorial/Project.toml`
  [7876af07] Example v0.5.3
  [682c06a0] JSON v0.21.3

Мы видим, что среда tutorial теперь содержит пакеты Example и JSON.

Если один и тот же пакет (с той же версией) установлен в нескольких средах, пакет будет загружен и сохранён на диске только один раз. Это делает среды очень лёгкими и позволяет их свободно создавать. Использование только среды по умолчанию с большим количеством пакетов — распространённая ошибка начинающих пользователей Julia. Освоение эффективного использования сред улучшит ваш опыт работы с пакетами Julia.

Для получения дополнительной информации об средах обратитесь к разделу Работа со средами документации.

Если вы застряли, вы можете запросить помощь у Pkg:

(@v1.9) pkg> ?

Вы должны увидеть список доступных команд вместе с краткими описаниями. Вы можете запросить более подробную помощь, указав команду:

(@v1.9) pkg> ?develop

Это руководство должно помочь вам начать работу с Pkg. Pkg предлагает гораздо больше возможностей для мощного управления пакетами. Прочитайте полное руководство, чтобы узнать больше!

© 2009–2024 Jeff Bezanson, Stefan Karpinski, Viral B. Shah, and other contributors
Licensed under the MIT License.
https://docs.julialang.org/en/v1.11/stdlib/Pkg/