APAC

What is APAC?

APAC is the Aussom Package Manager - a registry and CLI for publishing and installing reusable Aussom modules. Think npm or cargo, but for the Aussom ecosystem. APAC ships with the Aussom CLI installer. Once installed you can verify it's working from the terminal using apac -h.

This site is the registry side. It holds every package that has been published, with each version's source, generated API docs, and README. Anyone can browse it; you don't need an account to read or download.

Finding and installing packages

The everyday workflow happens at the command line with the apac CLI:

apac -s <keyword>            # search the registry for packages matching the query
apac -l <name>               # list a package's published versions
apac -l <name>@<version>     # print one version's manifest details
apac -i <name>               # install the latest version into ./apac_modules
apac -i <name>@<version>     # install a specific version

-s is the way most users discover a package, -l is how you inspect what's available and read the metadata for a specific version, and -i is how you pull it into your project. Once installed, Aussom can include the module just like the standard library.

Creating a package

A package is just a directory with a manifest, source files, and (optionally) a README and license file. The CLI can scaffold the layout and bundle a directory into a versioned zip the registry will accept:

apac -ag <group> <name>      # generate a package source skeleton (Java/Maven layout)
apac -ag -sm <name>          # generate the simple Aussom-only flat layout
apac -p <path>               # package the source directory into a zip

The packaging step also generates API docs from your source comments, so the registry can display them on the package view without you uploading anything extra.

Publishing

Publishing requires a publish key, issued out-of-band by the registry administrator. The CLI's -pub command sends the package zip and your bearer key to the registry. The registry runs a validation gauntlet (manifest fields, license file, zip safety, dependency resolvability) before accepting the upload; once accepted, the version is immutable.

apac -pub <zip-path>         # publish a packaged zip to the registry