release.sh

release.sh generates an addon zipfile from a Git or SVN checkout.

release.sh works by creating a new project directory, checking out external repositories within the project directory, then copying files from the checkout into the project directory. The project directory is then zipped to create a distributable addon zipfile.

release.sh can also upload your zipfile to CurseForge, WoWInterface, and GitHub (as a release), but requires jq. See Usage for more info.

release.sh reads .pkgmeta and supports the following directives. See the CurseForge Knowledge Base page for more info.

• externals (Git and SVN) Caveats: An external's .pkgmeta is only parsed for ignore and will not have localization keywords replaced.
• ignore
• license-output (creates an All Rights Reserved license)
• manual-changelog
• move-folders
• package-as
• enable-nolib-creation (defaults to no) Unlike using the Curse packager, manually uploading nolib packages has no affect for client users that choose to download libraries separately.

You can also use a few directives for WoWInterface uploading.

• wowi-archive-previous : yes|no (defaults to yes) Archive the previous release.
• wowi-create-changelog : yes|no (defaults to yes) Generate a Git changelog using BBCode that will be set when uploading. A manual changelog will always be used if set in the .pkgmeta. If you have pandoc installed, manual changelogs in Markdown format will be converted to BBCode; otherwise, the manual changelog will be used as-is.

release.sh supports the following repository substitution keywords when copying the files from the checkout into the project directory. See the CurseForge Knowledge Base page for more info.

• @alpha@...@end-alpha@
• @debug@...@end-debug@
• @do-not-package@...@end-do-not-package@
• @localization(locale="locale", format="format", ...)@
  • escape-non-ascii
  • handle-unlocalized
  • handle-subnamespaces="concat"
  • key
  • namespace
  • same-key-is-true
  • table-name
• @no-lib-strip@...@end-no-lib-strip@
• @non-alpha@...@end-non-alpha@
• @non-debug@...@end-non-debug@
• @file-revision@
• @project-revision@
• @file-hash@
• @project-hash@
• @file-abbreviated-hash@
• @project-abbreviated-hash@
• @file-author@
• @project-author@
• @file-date-iso@
• @project-date-iso@
• @file-date-integer@
• @project-date-integer@
• @file-timestamp@
• @project-timestamp@
• @project-version@

release.sh reads the TOC file, if present, to determine the name of the project.

release.sh assumes that tags (Git annotated tags and SVN tags) are named for the version numbers for the project. It will identify if the HEAD is tagged and use that as the current version number. It will search back through parent commits for the previous tag that is a release version number and generate a changelog containing the commits since that previous release tag.

By default, release.sh creates releases in the .release subdirectory of the top-level directory of the checkout.

Using release.sh

The recommended way to include release.sh in a project is to:

1. Create a .release subdirectory in your top-level checkout.
2. Copy release.sh into the .release directory.
3. Ignore the .release subdirectory in .gitignore.
4. Run release.sh.

Usage

Usage: release.sh [-cdelosuz] [-t topdir] [-r releasedir] [-p curse-id] [-w wowi-id]
  -c               Skip copying files into the package directory.
  -d               Skip uploading.
  -e               Skip checkout of external repositories.
  -l               Skip @localization@ keyword replacement.
  -o               Keep existing package directory, overwriting its contents.
  -s               Create a stripped-down "nolib" package.
  -u               Use Unix line-endings.
  -z               Skip zipfile creation.
  -t topdir        Set top-level directory of checkout.
  -r releasedir    Set directory containing the package directory. Defaults to "$topdir/.release".
  -p curse-id      Set the project id used on CurseForge for localization and uploading.
  -w wowi-id       Set the addon id used on WoWInterface for uploading.
  -g game-version  Set the game version to use for CurseForge and WoWInterface uploading.

The following environment variables are necessary for uploading:

• CF_API_KEY - your CurseForge API token, required for the CurseForge API to fetch localization and upload files.
• GITHUB_OAUTH - a GitHub personal access token, required for uploading to Github.
• WOWI_API_TOKEN - your WoWInterface API token, required for uploading to WoWInterface.