brev-cli

Brev.dev

Brev.dev connects your local computer to a cloud mesh so you can code locally on remote machines, without needing any new tools, and never in a browser.

Install

if brew is not already installed on your computer install it with

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

then add Brev's tap and install brev with

brew install brevdev/homebrew-brev/brev

Usage

create a workspace in your current org

brev start https://github.com/brevdev/brev-cli

list all workspaces in an org

brev ls

stop a workspace

brev stop brevdev/brev-cli

delete a workspace from and org

brev delete brevdev/brev-cli

Completion

zsh

mkdir -p ~/.zsh/completions && brev completion zsh > ~/.zsh/completions/_brev && echo fpath=~/.zsh/completions $fpath >> ~/.zshrc && fpath=(~/.zsh/completions $fpath) && autoload -U compinit && compinit

bash

sudo mkdir -p /usr/local/share/bash-completion/completions
brev completion bash | sudo tee /usr/local/share/bash-completion/completions/brev
source /usr/local/share/bash-completion/completions/brev

fish

mkdir -p ~/.config/fish/completions && brev completion fish > ~/.config/fish/completions/brev.fish && autoload -U compinit && compinit

Development

Build

make build runs a full release build make fast-build builds a binary for your current machine only

example .env file

VERSION=unknown
BREV_API_URL=http://localhost:8080
# BREV_API_URL=https://ade5dtvtaa.execute-api.us-east-1.amazonaws.com

adding new commands

pkg/cmd/logout/logout.go is a minimal command to go off of for adding new commands.

commands for the cli should follow <VERB> <NOUN> pattern.

Don't forget to add a debug command to .vscode/launch.json

Terminal

• make - execute the build pipeline.
• make help - print help for the Make targets.

Visual Studio Code

F1 → Tasks: Run Build Task (Ctrl+Shift+B or ⇧⌘B) to execute the build pipeline.

Release

The release workflow is triggered each time a tag with v prefix is pushed.

get the latest tag git

git describe --tags --abbrev=0

when releasing make sure to

1. run make smoketest before cutting release to run through some common commands and make sure that they work

2. release new version of workspace-images

CAUTION: Make sure to understand the consequences before you bump the major version. More info: Go Wiki, Go Blog.

Homebrew

if brew is not already installed on your workspace install it with

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

or if you need to uninstall brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

head to the releases page, which should look something similar to

https://github.com/brevdev/brev-cli/releases/tag/v0.6.13

and copy the link to the source code archive tar.gz

https://github.com/brevdev/brev-cli/archive/refs/tags/v0.6.13.tar.gz

update the url for the formula located in Formula/brev.rb and then run brew fetch Formula/brev.rb --build-from-source or

λ curl https://codeload.github.com/brevdev/brev-cli/tar.gz/refs/tags/v0.6.13 | openssl sha256

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  173k    0  173k    0     0  17017      0 --:--:--  0:00:10 --:--:-- 43493
(stdin)= 8cd6d5ec12a6f2adcf8b45dff5fbe2b2964700cf7dc03cbe323bf5204900f31e

--- before	2022-01-28 18:27:25.200840905 -0800
+++ after	2022-01-28 18:27:25.200840905 -0800
@@ -1,8 +1,8 @@
 class Brev < Formula
   desc "CLI tool for managing workspaces provided by brev.dev"
   homepage "https://docs.brev.dev"
-  url "https://github.com/brevdev/brev-cli/archive/refs/tags/v0.6.12.tar.gz"
-  sha256 "5237a3706e88f76e9a4d97109272f491539ad45ff50fc3fdb12fd478c55c0774"
+  url "https://github.com/brevdev/brev-cli/archive/refs/tags/v0.6.13.tar.gz"
+  sha256 "8cd6d5ec12a6f2adcf8b45dff5fbe2b2964700cf7dc03cbe323bf5204900f31e"
   license "MIT"
   depends_on "go" => :build

test the formula with

brew install --verbose --debug Formula/brev.rb

audit the formula with

brew audit --strict --online Formula/brev.rb

brew update # required in more ways than you think (initialises the brew git repository if you don't already have it)
cd "$(brew --repository homebrew/core)"
# Create a new git branch for your formula so your pull request is easy to
# modify if any changes come up during review.
git checkout -b <some-descriptive-name> origin/master
git add Formula/brev-cli.rb
git commit

Maintainance

Remember to update Go version in .github/workflows, Makefile and devcontainer.json.

Notable files:

• devcontainer.json - Visual Studio Code Remote Container configuration,
• .github/workflows - GitHub Actions workflows,
• .github/dependabot.yml - Dependabot configuration,
• .vscode - Visual Studio Code configuration files,
• .golangci.yml - golangci-lint configuration,
• .goreleaser.yml - GoReleaser configuration,
• Dockerfile - Dockerfile used by GoReleaser to create a container image,
• Makefile - Make targets used for development, CI build and .vscode/tasks.json,
• go.mod - Go module definition,
• tools.go - build tools.

Contributing

Simply create an issue or a pull request.