prune-github-notifications
TypeScript icon, indicating that this package has built-in type declarations

0.6.1Β β€’Β PublicΒ β€’Β Published

prune-github-notifications

Prunes GitHub notifications you don't care about, such as automated dependency bumps. 🧹

πŸ‘ͺ All Contributors: 1 🀝 Code of Conduct: Kept πŸ§ͺ Coverage πŸ“ License: MIT πŸ“¦ npm version πŸ’ͺ TypeScript: Strict

Usage

CLI

prune-github-notifications can be run on the CLI with an auth token for notifications access:

npx prune-github-notifications

CLI Options

Option Type Default Description
--auth string process.env.GH_TOKEN or executing gh auth token Auth token for GitHub from octokit-from-auth.
--bandwidth number 6 Maximum parallel requests to start at once.
--reason string[] ["subscribed"] Notification reason(s) to filter to.
--title string[] ["^chore\(deps\): update .+ to", /^build\(deps-dev\): bump .+ to"] Notification title regular expressions to filter to.
--watch number 0 A seconds interval to continuously re-run this on, if truthy.

For example, providing all functional options on the CLI:

npx prune-github-notifications --bandwidth 10 --reason subscribed --title "^chore.+ update .+ to"

Running in watch mode to clear notifications every ten seconds:

npx prune-github-notifications --watch 10

Node.js API

npm i prune-github-notifications
import { pruneGitHubNotifications } from "prune-github-notifications";

await pruneGitHubNotifications({ auth: "gho_..." });

If a process.env.GH_TOKEN is set, then the auth parameter will default to it:

await pruneGitHubNotifications();

Node.js Options

Only auth is required, and only if a GH_TOKEN isn't available.

Option Type Default Description
auth string process.env.GH_TOKEN GitHub authentication token with notifications access.
bandwidth number 6 Maximum parallel requests to start at once.
reason Set<string> Set {"subscribed"} Notification reason(s) to filter to.
title RegExp[] [/^chore\(deps\): update .+ to/, /^build\(deps-dev\): bump .+ to/] Notification title regular expressions to filter to.

For example, providing all options to the Node.js API:

await pruneGitHubNotifications({
	auth: "gho_...",
	bandwidth: 10,
	reason: subscribed,
	title: ["^chore.+ update .+ to"],
});

Development

See .github/CONTRIBUTING.md, then .github/DEVELOPMENT.md. Thanks! 🧹

Contributors

Josh Goldberg
Josh Goldberg

πŸ”§ 🚧 πŸ€” πŸ’» πŸ› πŸ–‹ πŸ“– πŸš‡ πŸ“†

πŸ’ This package was templated with create-typescript-app using the Bingo engine.

Readme

Keywords

none

Package Sidebar

Install

npm i prune-github-notifications

Weekly Downloads

73

Version

0.6.1

License

MIT

Unpacked Size

16.4 kB

Total Files

18

Last publish

Collaborators

  • joshuakgoldberg