This used to be the official METADATA repo for the Julia package manager, upto and including Julia v0.6
. From Julia v0.7
(July 2018) onwards, the package registry has moved to the https://github.com/JuliaRegistries/General. This repo is therefore frozen and no longer maintained. All users are urged to migrate to Julia 1.0 or later. There is no support for earlier versions.
See manual section on packages for how to use the package manager to install and develop packages.
Please note our current policies for accepting entries into METADATA.jl:
-
Registered packages must have an Open Source Initiative approved license, clearly marked via a
LICENSE.md
,LICENSE
,COPYING
or similarly named file in the package repository. Packages that wrap proprietary libraries are acceptable if the licenses of those libraries permit open source distribution of the Julia wrapper code. -
New packages submitted for registration must have at least one tagged version.
-
The lowest package version that will be accepted is v0.0.1. v0.0.0 is no longer permitted.
-
All new tagged versions of packages must have a
REQUIRE
file, which must at a minimum contain a single line likejulia 0.6
specifying a minimum version of Julia the package is expected to run on. Running
Pkg.tag
copies the contents of a package'sREQUIRE
file intoMETADATA.jl/PkgName/versions/1.2.3/requires
.A common mistake is to have an entry of the form
julia 0.6-
with the intention of specifying "version 0.4 and up." On the contrary, this line means "at least a 0.4 pre-release julia."
-
New package version tags must have a minimum Julia version of
0.5
or newer.0.5-
(0.5 pre-releases) is no longer allowed. Exceptions may be granted forjulia 0.4
if package authors are willing to vouch that they still test that their packages work on 0.4. -
If your package works with Julia 0.6 but not 0.5, then specify
julia 0.6
in yourREQUIRE
file. If the package has had any previous tags which supportedjulia 0.5
, then be sure to change the minor or major version number of the package viaPkg.tag("PkgName", :minor)
for the first tag that no longer supportsjulia 0.5
. This makes it possible to create a separate branch for any future bugfix releases that may be needed for the package on Julia 0.5. -
We strongly encourage everyone to update METADATA.jl through pull requests, which can be generated for you automatically when you tag a package using Github's UI, provided you have attobot enabled on your repository. Alternatively, you can use the PkgDev package, and its
PkgDev.publish()
function to create PRs. GitHub's pull requests allow us to run basic checks on the metadata entries. METADATA.jl should not be edited directly unless absolutely necessary in an emergency. -
Do not modify the
sha1
files of existing tags after they have been published by merging to theJuliaLang/metadata-v2
branch. Bounds can be modified in therequires
files after the fact, but the code content should remain unchanged for reproducibility of past results.
These policies have been the result of many months of discussion to improve the quality of registered packages and the overall user experience with Julia packages.