Пакетный менеджер Pkg

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

В этом разделе кратко описан пакетный менеджер Julia — Pkg. Он должен помочь новым пользователям ознакомиться с основными функциями Pkg.

Pkg поставляется с REPL. Введите Pkg REPL, нажав ] в Julia REPL. Чтобы вернуться в Julia REPL, нажмите Backspace или ^C.

При входе в Pkg REPL вы должны увидеть похожий пригласительный знак:

(v1.1) pkg>

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

(v1.1) pkg> add Example

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

(v1.1) pkg> add JSON StaticArrays

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

(v1.1) pkg> rm JSON StaticArrays

До сих пор мы ссылались только на зарегистрированные пакеты. Pkg также поддерживает работу с незарегистрированными пакетами. Чтобы добавить незарегистрированный пакет, укажите URL:

(v1.1) pkg> add https://github.com/JuliaLang/Example.jl

Используйте rm, чтобы удалить этот пакет по имени:

(v1.1) pkg> rm Example

Используйте update для обновления установленного пакета:

(v1.1) pkg> update Example

Чтобы обновить все установленные пакеты, используйте update без каких-либо аргументов:

(v1.1) pkg> update

До этого момента мы рассмотрели базовые операции управления пакетами: добавление, обновление и удаление пакетов. Это должно быть знакомо, если вы использовали другие пакетные менеджеры. Pkg предлагает значительные преимущества перед традиционными пакетными менеджерами, организуя зависимости в средах.

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

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

(v1.1) pkg> activate tutorial
[ Info: activating new environment at `/tmp/tutorial/Project.toml`.

Pkg сообщает, что создается новая среда и что эта среда будет сохранена в каталоге /tmp/tutorial.

Pkg также обновил приглашение REPL, чтобы отразить новую активную среду:

(tutorial) pkg>

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

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

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

(tutorial) pkg> add Example
...

(tutorial) pkg> status
    Status `/tmp/tutorial/Project.toml`
  [7876af07] Example v0.5.1

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

Допустим, мы работаем над Example и считаем, что ей нужна новая функциональность. Как мы можем изменить исходный код? Мы можем использовать develop для настройки git-клона пакета Example.

(tutorial) pkg> develop --local Example
...

(tutorial) pkg> status
    Status `/tmp/tutorial/Project.toml`
  [7876af07] Example v0.5.1+ [`dev/Example`]

Обратите внимание, что обратная связь изменилась. dev/Example относится к расположению недавно созданного клона. Если мы посмотрим внутрь каталога /tmp/tutorial, мы заметим следующие файлы:

tutorial
├── dev
│   └── Example
├── Manifest.toml
└── Project.toml

Вместо загрузки зарегистрированной версии Example, Julia загрузит исходный код, содержащийся в tutorial/dev/Example.

Давайте попробуем. Сначала изменим файл по адресу tutorial/dev/Example/src/Example.jl и добавим простую функцию:

plusone(x::Int) = x + 1

Теперь мы можем вернуться в Julia REPL и загрузить пакет:

julia> import Example

Julia должна загрузить наш новый код. Давайте протестируем его:

julia> Example.plusone(1)
2

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

(tutorial) pkg> free Example

Когда вы закончите эксперименты с tutorial, вы можете вернуться к стандартной среде, выполнив activate без аргументов:

(tutorial) pkg> activate

(v1.1) pkg>

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

(v1.1) pkg> ?

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

(v1.1) pkg> ?develop

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