Spec-Zone.ru › Julia 1.2

Пак

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

Примечание

Следующее — очень краткое введение в Pkg. Настоятельно рекомендуется прочитать полное руководство, которое доступно здесь: https://julialang.github.io/Pkg.jl/v1/.

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

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

Примечание

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

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

(v1.1) pkg>

Чтобы добавить пакет, используйте add:

(v1.1) pkg> add Example
Примечание

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

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

(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

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

julia> import Example
Предупреждение

Пакет может быть загружен только один раз за сеанс Julia. Если вы выполнили import Example в текущем сеансе Julia, вам нужно будет перезапустить Julia и повторно выполнить activate tutorial в REPL Pkg. Revise.jl может сделать этот процесс значительно приятнее, но его настройка выходит за рамки данного руководства.

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 предлагает гораздо больше возможностей в отношении мощного управления пакетами, прочитайте полное руководство, чтобы узнать больше!

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API