Julia Package Release & Registry Update

Tag a version, compute artifact hashes, and register in loulouJL.

Registry Location

/Users/loulou/Dropbox/projects_code/julia_packages/loulouJL/

Each package has: Versions.toml, Deps.toml, Compat.toml, Package.toml

Quick Reference

Release Checklist

1. Version bump (PR required if main is protected)

# Project.toml
version = "X.Y.Z"

2. Tag AFTER all changes are merged

NEVER re-tag a release that has artifacts. Re-tagging causes GitHub to regenerate tarballs with different SHA256 checksums, breaking all artifact downloads.

git tag -a vX.Y.Z -m "vX.Y.Z: description"
git push origin vX.Y.Z

3. Wait for CI + artifact builds

gh run list --limit 5                    # check status
gh run watch <run-id> --exit-status      # wait for completion

4. Compute artifact hashes (if package has Artifacts.toml)

# Download each artifact from the release
curl -sL -o artifact.tar.gz "https://github.com/ORG/REPO/releases/download/vX.Y.Z/artifact-PLATFORM.tar.gz"

# SHA256 (goes in Artifacts.toml [[name.download]] sha256)
shasum -a 256 artifact.tar.gz

# Tree hash (goes in Artifacts.toml [[name]] git-tree-sha1)
mkdir extracted && cd extracted
tar -xzf ../artifact.tar.gz
julia -e 'using Pkg; println(bytes2hex(Pkg.GitTools.tree_hash(".")))'

Update Artifacts.toml with computed hashes, commit, push. Do this BEFORE tagging if possible to avoid the re-tag problem.

5. Update loulouJL registry

TREE=$(git rev-parse vX.Y.Z^{tree})

Versions.toml — always update:

["X.Y.Z"]
git-tree-sha1 = "TREE_SHA"

Deps.toml — update only if dependencies changed. Use version ranges:

["X.Y-0"]
SomeDep = "uuid-here"

Ranges must not overlap. "0.6-0" means 0.6 to end of 0.x.

Compat.toml — update only if compat bounds changed:

["0"]
julia = "1.6-*"

Commit and push the registry:

cd /Users/loulou/Dropbox/projects_code/julia_packages/loulouJL
git add LETTER/PackageName/
git commit -m "Register PackageName vX.Y.Z"
git push

6. Verify

using Pkg
Pkg.Registry.update()
Pkg.add("PackageName")  # or Pkg.update("PackageName")

Artifacts.toml Format

[[artifact_name]]
arch = "aarch64"          # or "x86_64"
git-tree-sha1 = "HASH"
os = "macos"              # or "linux"
lazy = true

    [[artifact_name.download]]
    url = "https://github.com/ORG/REPO/releases/download/vX.Y.Z/file.tar.gz"
    sha256 = "HASH"

Common Mistakes