Community.PowerToys.Run.Plugin.Lint 0.3.0

.NET 9.0

dotnet tool install --global Community.PowerToys.Run.Plugin.Lint --version 0.3.0

This package contains a .NET tool you can call from the shell/command line.

dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local Community.PowerToys.Run.Plugin.Lint --version 0.3.0

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=Community.PowerToys.Run.Plugin.Lint&version=0.3.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package Community.PowerToys.Run.Plugin.Lint --version 0.3.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Community.PowerToys.Run.Plugin.Lint

Linter for PowerToys Run community plugins

Installation

Install:

dotnet tool install -g Community.PowerToys.Run.Plugin.Lint

The tool is installed as ptrun-lint.exe in %UserProfile%\.dotnet\tools.

Update:

dotnet tool update -g Community.PowerToys.Run.Plugin.Lint

Uninstall:

dotnet tool uninstall -g Community.PowerToys.Run.Plugin.Lint

Usage

ptrun-lint <url>

Arguments:

<url> - An URL to a GitHub repo

Example:

ptrun-lint https://github.com/hlaueriksson/Community.PowerToys.Run.Plugin.Install

During linting, GitHub release assets are downloaded to %LocalAppData%\Temp. After linting is completed, downloaded files are deleted.

Logs are written to a file, ptrun-lint.log, in the same directory as the tool was executed.

Rules

Code	Description
`PTRUN0001`	Args should be valid
	Args missing
	GitHub repo URL missing
`PTRUN1001`	Repo should be valid
	Repository missing
`PTRUN1002`	Repo details should be valid
	Repository missing
	Topic "`powertoys-run-plugin`" missing
	License missing
`PTRUN1101`	Readme should be valid
	Readme missing
	Installation instructions missing
	Usage instructions missing
`PTRUN1201`	Release should be valid
	Release missing
	Asset missing
	Asset "`.zip`" missing
	Asset "`arm64`" platform missing
	Asset "`x64`" platform missing
`PTRUN1202`	Release notes should be valid (`<package>`)
	Release notes missing
	Package missing
`PTRUN1301`	Package should be valid (`<package>`)
	Package missing
	Filename does not match "`<name>-<version>-<platform>.zip`" convention
`PTRUN1302`	Package content should be valid (`<package>`)
	Package missing
	Plugin folder missing
	Metadata "`plugin.json`" missing
	Assembly "`.dll`" missing
`PTRUN1303`	Package checksum should be valid (`<package>`)
	Release notes missing
	Package missing
	Hash "`<hash>`" missing
`PTRUN1401`	Plugin metadata should be valid (`<package>`)
	Package missing
	Repository missing
	User missing
	ID is invalid
	ActionKeyword is not unique
	Name does not match plugin folder
	Author does not match GitHub user
	Version is invalid
	Version does not match filename version
	Website does not match repo URL
	ExecuteFileName missing in package
	ExecuteFileName does not match "`Community.PowerToys.Run.Plugin.<Name>.dll`" convention
	IcoPathDark missing in package
	IcoPathLight missing in package
	DynamicLoading is unnecessary
`PTRUN1402`	Package dependencies should be valid (`<package>`)
	Package missing
	Unnecessary dependency: `PowerToys.Common.UI.dll`
	Unnecessary dependency: `PowerToys.ManagedCommon.dll`
	Unnecessary dependency: `PowerToys.Settings.UI.Lib.dll`
	Unnecessary dependency: `Wox.Infrastructure.dll`
	Unnecessary dependency: `Wox.Plugin.dll`
	Unnecessary dependency: `Newtonsoft.Json`, consider using `System.Text.Json`
	Unnecessary dependency: `<dependency>`, already defined in Central Package Management (`Directory.Packages.props`)
`PTRUN1501`	Plugin assembly should be valid (`<package>`)
	Assembly could not be validated
	Target framework should be "`net9.0`"
	Target platform should be "`windows`"
	Main.PluginID does not match metadata (`plugin.json`) ID

Package Checksum

The rule PTRUN1303 can fail with:

Hash "<hash>" missing

This can be fixed by including:

Installer hashes in the release notes
A checksums file in the release assets

Generate markup snippets with installer hashes:

Run the releasenotes.ps1 script from Community.PowerToys.Run.Plugin.Templates

Example:

Filename	SHA256 Hash
`Install-0.1.0-arm64.zip`	`CB03EF645F24248F9618AF18E82D7BA7127F209AB1BE77701FC6183FDC952037`
`Install-0.1.0-x64.zip`	`E0DB7B8A98D0891B97AAF85A68D340EDDCDF09389537BA64401CF8D786746EC5`

Generate a checksums file and attach it to the release as an asset:

Use the GitHub action from wangzuo/action-release-checksums

The checksums file must:

Have filename: checksums.txt
Use method: SHA256

Example:

CB03EF645F24248F9618AF18E82D7BA7127F209AB1BE77701FC6183FDC952037 Install-0.1.0-arm64.zip
E0DB7B8A98D0891B97AAF85A68D340EDDCDF09389537BA64401CF8D786746EC5 Install-0.1.0-x64.zip

Disclaimer

This is not an official Microsoft PowerToys tool.

Product	Compatible and additional computed target framework versions.
.NET	net9.0 is compatible.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version	Downloads	Last updated
0.3.0	82	12/18/2024
0.2.0	174	10/5/2024
0.1.0	136	9/15/2024

- Bump target framework to net9.0
- Support for GitHub name as author
- Support for checksums file