Packaging
What is still planned and open for packages: the editor, projects, offline builds, mirroring and ownership
Packages, their dependencies, versions and publishing are described for users in
Packages and projects and under Packages on The nanyx
command. How the package index, the lockfile and the cache work, and why they are built that way, is on
The package index, and how the package commands are built on
The nanyx command. This page keeps what is still planned or undecided. Work is
tracked under the packaging label.
Plan
- The official linter as a shipped package, once its contract exists (#1343, Built-ins as packages).
- Ownership in the index. Recording a namespace owner’s GitHub account ID, so that a claim survives a rename, and the publishers an organisation grants (Package ownership and locking). The owner check compares a namespace with the repository owner’s current login.
- Mirroring artifacts, so that a deleted release can’t break builds (Open questions).
- A service behind the index. When pull requests become the bottleneck, a small service can take over registration and syncing behind an upload API with tokens, and keep writing the same static index. The client, the lockfile and every existing package are unaffected.
- Projects (
.nyxproj, project references) when a workspace of several packages needs them (#1386). - Editor support (#866). The language server resolves imports
exactly as the CLI does, from the manifest, lockfile and cache. When the manifest changes, the extension offers to
run
nanyx pull. Go-to-definition into a dependency opens the cached source read-only. - The manifest’s and the archive’s remaining parts. The manifest’s
packagegainsnanyx = "0.14", the oldest compiler the package builds with, which the index already reads and the resolver already honours (#2263), andlicenseanddescription; the.nyxpkggains the package’s readme and licence (#2264). - The CLI’s remaining parts.
nanyx update, which upgrades a locked version on purpose (#2265);nanyx build --offline, which stops a build that would update the lockfile from reaching the index (#2266);nanyx pullchecking what it downloads, so that the first build after it is fast too; andnanyx manifestin forms other than--json.
Open problems
- A package’s tests can’t be scripts beside it. A script in a package’s directory is one of the package’s files,
and a package has one
@entry. nanyx-lang/json’s test runner copies the package and its test scripts to a directory of their own and compares what each prints with an.expectedfile.nanyx test(Testing) is to replace it, andnanyx publishis to run a package’s tests with it.
Open questions
- A custom domain and mirroring. The index is at
https://nanyx-lang.github.io/packages/and points at release assets on packages’ own repositories. When should it move topackages.nanyx.dev, and who holds the domain? Should artifacts be mirrored (to object storage or a project-owned repository) so a deleted release can’t break builds? - Hosts and capabilities. Should a package declare the contexts it requires in its manifest, so the index can
show “this package needs
FileSystem” before anyone installs it? - Private packages. Should the client support more than one index (a company’s own) from the start? The static protocol makes it cheap: a list of index URLs in user configuration.