npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@govuk-pay/cli

v0.0.41

Published

GOV.UK Pay Command Line Interface

Downloads

1,164

Readme

pay-cli

GOV.UK Pay Command Line Interface

Installation and migration guide

If you have used the Ruby CLI in the past, there are some additional steps required:

  • Remove references to pay from your .bashrc (or other autostart shell script, .bash_profile, .zshrc, .zprofile, etc).
  • Check which pay, if it points to ~/.rbenv/shims/pay or similar, remove that script. Ideally, it should return pay not found.
  • Restart your shell to clear functions and environment variables leftover.

To install the Node.js CLI:

  • Run npm install -g @govuk-pay/cli. If npm was installed through Homebrew, you shouldn't need to use sudo to install packages.
  • Run pay to see if you are running the new version (new features such as pay tunnel should be available), if not check which pay in case you are using an older version.

There is nothing more to do, you're done! To update, simply run pay update or run npm install -g @govuk-pay/cli again, there are version check notifications if you are behind a version.

Usage

This is published to NPM, you can install it globally using npm install -g @govuk-pay/cli, once it's installed you can run it using pay [arguments] or payx [arguments]. If you'd rather not install it globally you can run it using npx @govuk-pay/cli.

We're in the process of porting the existing Ruby CLI into typescript, we've tried to make that process transparent to the users of the CLI. Most of the commands rely on the existing ruby implementation therefore you'll need rbenv installed with bundler installed into it. When handing over to ruby we use zsh by default, if you want a different shell or rbenv you can set the following environment variables:

  • PAY_CLI_RBENV_COMMAND - defaults to rbenv
  • PAY_CLI_SHELL_COMMAND - defaults to zsh

To see the commands run pay without any arguments.

If you find that the ported typescript version isn't behaving as expected and you want to use the ruby version you can use the command legacy, for example:

  • pay browse manual - uses the typescript port to open the team manual
  • pay legacy browse manual - uses the original ruby version to open the team manual

Please add an issue any time you need to fall back on legacy behaviour so we can improve the typescript implementation.

Config files

Config files needed by the pay cli will go in `$HOME/.pay-cli"

Pay Local Config Files

You can override environment variables set in the the .env files in [the pay local services local config directory](https://github.com/alphagov/pay-cli/tree/main/resources/legacy-ruby-cli/lib/pay_cli/commands/local/files/servicesfor specific containers by placing files in$HOME/.pay-cli/local/environment-overrides/<app_name>.env`.

For example to override an environment variable for connector which was set in connector.env you could create the file $HOME/.pay-cli/local/environment-overrides/connector.env

Note: This will only override variables set in the .env files, it will not override any variables which get declared in an environment configuration option in the generated docker-compose files. These are generated from the docker-compose.erb template.

Vulnerability Disclosure

GOV.UK Pay aims to stay secure for everyone. If you are a security researcher and have discovered a security vulnerability in this code, we appreciate your help in disclosing it to us in a responsible manner. Please refer to our vulnerability disclosure policy and our security.txt file for details.