chocolatey/claus

This repository contains manual and automatic packages for Chocolatey .

Prerequisites

To run locally you will need:

• Powershell 5+.
• Chocolatey Automatic Package Updater Module: Install-Module au or cinst au.

Create a package

To create a new package see Creating the package updater script.

Testing the package

In a package directory run: Test-Package. This function can be used to start testing in chocolatey-test-environment via Vagrant parameter or it can test packages locally.

Manual package update

1. Download the latest version of the package from the official site.
2. Update the package version in the chocolateyinstall.ps1 file.
3. Calculate the checksum and update it in the chocolateyinstall.ps1 file.
4. Update the chocolateyinstall.ps1 file if needed.
5. Update the version, copyright year and release notes in the .nuspec file.

Automatic package update

Single package

Run from within the directory of the package to update that package:

cd <package_dir>
./update.ps1

If this script is missing, the package is not automatic. Set $au_Force = $true prior to script call to update the package even if no new version is found.

Multiple packages

To update all packages run ./update_all.ps1 from the repo root. It accepts a few options:

./update_all.ps1 -Name a*                         # Update all packages which name start with letter 'a'
./update_all.ps1 -ForcedPackages 'cpu-z copyq'    # Update all packages and force cpu-z and copyq
./update_all.ps1 -ForcedPackages 'copyq:1.2.3'    # Update all packages but force copyq with explicit version
./update_all.ps1 -ForcedPackages 'libreoffice-streams\fresh:6.1.0]'    # Update all packages but force libreoffice-streams package to update stream `fresh` with explicit version `6.1.0`.
./update_all.ps1 -Root 'c:\packages'              # Update all packages in the c:\packages folder

The following global variables influence the execution of update_all.ps1 script if set prior to the call:

$au_NoPlugins = $true        #Do not execute plugins
$au_Push      = $false       #Do not push to chocolatey

You can also call AU method Update-AUPackages (alias updateall) on its own in the repository root. This will just run the updater for the each package without any other option from update_all.ps1 script. For example to force update of all packages with a single command execute:

updateall -Options ([ordered]@{ Force = $true })

Pushing updates to Chocolatey

Authentication

In order to save your API key for https://push.chocolatey.org/, log in (or register, confirm and then log in) to https://push.chocolatey.org/, go to https://push.chocolatey.org/account, copy the API Key, and then use it in the following command:

choco apikey -k <your key here> -s https://push.chocolatey.org/

Pushing updates

choco push [<path to nupkg>] --source https://push.chocolatey.org/