Функции менеджера пакетов

Все функции менеджера пакетов определены в модуле Pkg. Ни одна из функций модуля Pkg не экспортируется; для их использования вам нужно будет префиксровать каждый вызов функции явным Pkg., например Pkg.status() или Pkg.dir().

Функции для разработки пакетов (например, tag, publish, и т.д.) перемещены в пакет PkgDev. Смотрите Документацию README пакета PkgDev для получения информации об этих функциях.

dir() → AbstractString

Возвращает абсолютный путь к каталогу пакета. По умолчанию это joinpath(homedir(),".julia","v$(VERSION.major).$(VERSION.minor)") на всех платформах (т.е. ~/.julia/v0.5 в синтаксисе оболочки UNIX). Если переменная среды JULIA_PKGDIR установлена, то этот путь используется в возвращаемом значении как joinpath(ENV["JULIA_PKGDIR"],"v$(VERSION.major).$(VERSION.minor)"). Если JULIA_PKGDIR является относительным путем, он интерпретируется относительно текущего рабочего каталога.

dir(names...) → AbstractString

Эквивалентно normpath(Pkg.dir(),names...) — т.е. добавляет компоненты пути к каталогу пакета и нормализует полученный путь. В частности, Pkg.dir(pkg) возвращает путь к пакету pkg.

init(meta::AbstractString=DEFAULT_META, branch::AbstractString=META_BRANCH)

Инициализирует Pkg.dir() как каталог пакета. Это будет сделано автоматически, когда JULIA_PKGDIR не установлено и Pkg.dir() использует значение по умолчанию. В рамках этого процесса выполняется клонирование локального репозитория METADATA git со страницы и ветви, указанных в его аргументах, которые обычно не предоставляются. Явные (не по умолчанию) аргументы могут быть использованы для поддержки настраиваемой настройки METADATA.

resolve()

Определяет оптимальный и согласованный набор версий пакетов для установки или обновления. Оптимальный набор версий пакетов основан на содержимом Pkg.dir("REQUIRE") и состоянии установленных пакетов в Pkg.dir(). Пакеты, которые больше не требуются, перемещаются в Pkg.dir(".trash").

edit()

Открывает Pkg.dir("REQUIRE") в редакторе, заданном переменными среды VISUAL или EDITOR; после возврата команды редактора выполняется Pkg.resolve() для определения и установки нового оптимального набора установленных версий пакетов.

add(pkg, vers...)

Добавляет запись требования для pkg в Pkg.dir("REQUIRE") и вызывает Pkg.resolve(). Если даны vers, они должны быть объектами VersionNumber и они задают допустимые интервалы версий для pkg.

rm(pkg)

Удаляет все записи требований для pkg из Pkg.dir("REQUIRE") и вызывает Pkg.resolve().

clone(url[, pkg])

Клонирует пакет напрямую из URL git url. Пакет не нужно регистрировать в Pkg.dir("METADATA"). Репозиторий пакета клонируется под именем pkg если задано; если не задано, pkg определяется автоматически из url.

clone(pkg)

Если у pkg зарегистрирован URL в Pkg.dir("METADATA"), клонирует его с этого URL на основной ветви. Пакет не должен иметь зарегистрированных версий.

setprotocol!(proto)

Устанавливает протокол, используемый для доступа к пакетам, размещенным на GitHub. По умолчанию ‘https’, с пустой proto делегирует выбор разработчику пакета.

available() → Vector{String}

Возвращает имена доступных пакетов.

available(pkg) → Vector{VersionNumber}

Возвращает номера версий, доступные для пакета pkg.

installed() → Dict{String,VersionNumber}

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

installed(pkg) → Void | VersionNumber

Если pkg установлен, возвращает номер установленной версии, в противном случае возвращает nothing.

status()

Выводит сводку установленных пакетов и их версий и состояния.

status(pkg)

Выводит сводку версии и состояния конкретно pkg.

update(pkgs...)

Обновляет репозиторий метаданных — хранящийся в Pkg.dir("METADATA") — затем обновляет любые фиксированные пакеты, которые могут быть безопасно извлечены из их источника; затем вызывает Pkg.resolve() для определения нового оптимального набора версий пакетов.

Без аргументов обновляет все установленные пакеты. При предоставлении одного или нескольких имён пакетов в качестве аргументов обновляются только эти пакеты и их зависимости.

checkout(pkg, [branch="master"]; merge=true, pull=true)

Переключается на ветку branch в репозитории Pkg.dir(pkg). По умолчанию переключается на ветку «master». Для возврата к использованию новейшей совместимой версии выпуска используйте Pkg.free(pkg). Изменения объединяются (только быстрый переход), если задан аргумент merge == true, и новейшая версия извлекается из репозитория upstream если pull == true.

pin(pkg)

Фиксирует pkg на текущей версии. Для возврата к использованию новейшей совместимой версии выпуска используйте Pkg.free(pkg)

pin(pkg, version)

Фиксирует pkg на зарегистрированной версии version.

free(pkg)

Освобождает пакет pkg для повторного управления менеджером пакетов. Вызывает Pkg.resolve() для определения оптимальных версий пакетов после. Это обратное действие для Pkg.checkout и Pkg.pin.

Вы также можете предоставить итерируемый набор имён пакетов, например, Pkg.free(("Pkg1", "Pkg2")) для одновременного освобождения нескольких пакетов.

build()

Выполняет скрипты сборки для всех установленных пакетов в порядке рекурсивного обхода в глубину.

build(pkgs...)

Выполняет скрипт сборки в deps/build.jl для каждого пакета в pkgs и всех их зависимостей в порядке рекурсивного обхода в глубину. Это вызывается автоматически Pkg.resolve() для всех установленных или обновлённых пакетов.

test(; coverage=false)

Выполняет тесты для всех установленных пакетов, гарантируя, что зависимости тестов каждого пакета установлены на время тестирования. Пакет тестируется путём запуска его файла test/runtests.jl, а зависимости тестов указаны в test/REQUIRE. Статистику покрытия для пакетов можно сгенерировать, передав coverage=true. По умолчанию покрытие не запускается.

test(pkgs...; coverage=false)

Выполняет тесты для каждого пакета в pkgs, гарантируя, что зависимости тестов каждого пакета установлены на время тестирования. Пакет тестируется путём запуска его файла test/runtests.jl, а зависимости тестов указаны в test/REQUIRE. Статистику покрытия для пакетов можно сгенерировать, передав coverage=true. По умолчанию покрытие не запускается.

dependents(packagename)

Отображает пакеты, имеющие packagename в качестве зависимости.