vim-ale

mirror of https://github.com/webinstall/webi-installers.git synced 2026-05-16 21:56:33 +00:00

Files

AJ ONeal 9f28505af7 ref: delete unreachable upstream-fetcher modules

Stacked on the modifications PR. Now that no live code path references
the per-package fetchers, the shared HTTP/parsing helpers, the
in-process normalizer, or the example template, delete them. Pure
deletion — no behavior change.

- ~93 per-package <pkg>/releases.js fetcher modules.
- _common/{brew,fetcher,git-tag,gitea,github,github-source,
  githubish,githubish-source}.js shared HTTP/parsing helpers.
- _webi/normalize.js in-process normalization layer (cache files
  arrive normalized from webicached).
- _example/releases.js fetcher template for new packages.

The Go cache daemon (webicached) is now the sole producer of release
metadata; the Node process never makes an upstream request.

2026-05-08 16:31:59 -06:00

install.ps1

chore(pwsh): lint+fix

2023-10-18 02:10:55 -06:00

install.sh

ref(webi_download): always use 2-3 args on as many lines

2023-10-30 18:03:41 -06:00

README.md

doc: replace ``txt blocks with ``text blocks

2023-02-26 05:57:14 +00:00

README.md

title, homepage, tagline

title	homepage	tagline
Gnu Privacy Guard	https://gnupg.org/	GnuPG: a complete implementation of OpenPGP (RFC4880), also known as Pretty Good Privacy.

Before you start

If ~/.gitconfig exists and has both name and email fields, then a new gpg key will be created after the install. Otherwise, you'll have to create one yourself.

Cheat Sheet

Among other things, gpg is particularly useful for signing and verifying git commits (and emails too).

Here we'll cover:

Important GPG Files & Directories
Creating New Keys
Listing Keys
Signing Git Commits
Exporting GPG Keys for GitHub
Publishing GPG Keys to "the Blockchain"
Running GPG Agent with launchd

Files

These are the files / directories that are created and/or modified with this install:

~/.config/envman/PATH.env
~/.local/opt/gnupg/bin/gpg
~/.local/opt/gnupg/bin/gpg-agent
~/.local/opt/gnupg/bin/pinentry-mac.app/Contents/MacOS/pinentry-mac
~/.gnupg/gpg-agent.conf
~/Library/LaunchAgent/gpg-agent.plist

How to create a new GPG key

See the Cheat Sheet at gpg-pubkey.

How to List GPG Key(s)

gpg --list-secret-keys --keyid-format LONG

How to configure git to sign commits

See the Cheat Sheet at gpg-pubkey.

How to Export GPG Key for GitHub

See the Cheat Sheet at gpg-pubkey.

How to Publish GPG Keys

GPG is the OG "blockchain", as it were.

If you'd like to publish your (public) key(s) to the public Key Servers for time and all eternity, you can:

gpg --send-keys "${MY_KEY_ID}"

(no IPFS needed 😉)

How to start gpg-agent with launchd

(Note: this is done for you on install, but provided here for reference)

It's a trick question: You can't.

You need to use gpg-connect-agent instead.

~/Library/LaunchAgents/gpg-agent.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>Label</key>
	<string>gpg-agent</string>
	<key>ProgramArguments</key>
	<array>
		<string>MY_HOME/.local/opt/gnupg/bin/gpg-connect-agent</string>
		<string>--agent-program</string>
		<string>MY_HOME/.local/opt/gnupg/bin/gpg-agent</string>
		<string>--homedir</string>
		<string>MY_HOME/.gnupg/</string>
		<string>/bye</string>
	</array>

	<key>RunAtLoad</key>
	<true/>

	<key>WorkingDirectory</key>
	<string>MY_HOME</string>

	<key>StandardErrorPath</key>
	<string>MY_HOME/.local/share/gpg-agent/var/log/gpg-agent.log</string>
	<key>StandardOutPath</key>
	<string>MY_HOME/.local/share/gpg-agent/var/log/gpg-agent.log</string>
</dict>
</plist>

And then start it with launchctl:

launchctl load -w ~/Library/LaunchAgents/gpg-agent.plist

Troubleshooting 'gpg failed to sign the data'

gpg is generally expected to be used with a Desktop client. On Linux servers you may get this error:

error: gpg failed to sign the data
fatal: failed to write commit object

Try to load the gpg-agent, set GPG_TTY, and then run a clearsign test.

gpg-connect-agent /bye
export GPG_TTY=$(tty)
echo "test" | gpg --clearsign

If that works, update your ~/.bashrc, ~/.zshrc, and/or ~/.config/fish/config.fish to include the following:

gpg-connect-agent /bye
export GPG_TTY=$(tty)

If this is failing on Mac or Windows, then gpg-agent is not starting as expected on login (for Mac the above may work), and/or the pinentry command is not in the PATH.

If you just installed gpg, try closing and reopening your Terminal, or possibly rebooting.