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

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

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

Base.Pkg.dirФункция

dir() -> AbstractString

Возвращает абсолютный путь к каталогу пакета. По умолчанию он равен joinpath(homedir(),".julia","v$(VERSION.major).$(VERSION.minor)") на всех платформах (т. е. ~/.julia/v0.6 в синтаксисе оболочки 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.

Base.Pkg.initФункция

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

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

Base.Pkg.resolveФункция

resolve()

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

Base.Pkg.editФункция

edit()

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

Base.Pkg.addФункция

add(pkg, vers...)

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

Base.Pkg.rmФункция

rm(pkg)

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

Base.Pkg.cloneФункция

clone(pkg)

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

clone(url, [pkg])

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

Base.Pkg.setprotocol!Функция

setprotocol!(proto)

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

Base.Pkg.availableФункция

available() -> Vector{String}

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

available(pkg) -> Vector{VersionNumber}

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

Base.Pkg.installedФункция

installed() -> Dict{String,VersionNumber}

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

installed(pkg) -> Void | VersionNumber

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

Base.Pkg.statusФункция

status()

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

status(pkg)

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

Base.Pkg.updateФункция

update(pkgs...)

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

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

Base.Pkg.checkoutФункция

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

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

Base.Pkg.pinФункция

pin(pkg)

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

pin(pkg, version)

Зафиксировать pkg на зарегистрированной версии version.

Base.Pkg.freeФункция

free(pkg)

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

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

Base.Pkg.buildФункция

build()

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

build(pkgs...)

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

Base.Pkg.testФункция

test(; coverage=false)

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

test(pkgs...; coverage=false)

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

Base.Pkg.dependentsФункция

dependents(pkg)

Вывести список пакетов, у которых pkg является зависимостью.