Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lingrino/vaku

vaku extends the vault api & cli
https://github.com/lingrino/vaku

cli go golang vault vault-api vault-client

Last synced: 3 months ago
JSON representation

vaku extends the vault api & cli

Host: GitHub
URL: https://github.com/lingrino/vaku
Owner: lingrino
License: mit
Created: 2018-04-24T04:52:10.000Z (over 6 years ago)
Default Branch: main
Last Pushed: 2024-08-01T17:32:16.000Z (3 months ago)
Last Synced: 2024-08-01T19:56:27.555Z (3 months ago)
Topics: cli, go, golang, vault, vault-api, vault-client
Language: Go
Homepage: https://lingrino.com
Size: 8.68 MB
Stars: 152
Watchers: 6
Forks: 17
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-go-extra - vaku - 04-24T04:52:10Z|2022-08-05T01:10:17Z| (Go Tools / Other Software)

README

# Vaku

[![Vaku](www/assets/images/logo-vaku-sm.png?raw=true)](www/assets/logo-vaku-sm.png "Vaku")

[![PkgGoDev](https://pkg.go.dev/badge/github.com/lingrino/vaku/v2/api)](https://pkg.go.dev/github.com/lingrino/vaku/v2/api)
[![goreportcard](https://goreportcard.com/badge/github.com/lingrino/vaku)](https://goreportcard.com/report/github.com/lingrino/vaku)

Vaku is a CLI and API for running path- and folder-based operations on the Vault Key/Value secrets engine. Vaku extends the existing Vault CLI and API by allowing you to run the same path-based list/read/write/delete functions on folders as well. Vaku also lets you search, copy, and move both secrets and folders.

## Installation

### Homebrew

```shell
brew install lingrino/tap/vaku
```

### Scoop

```shell
scoop bucket add vaku https://github.com/lingrino/scoop-vaku.git
scoop install vaku
```

### Docker

```shell
docker run ghcr.io/lingrino/vaku --help
```

### Binary

Download the latest binary or deb/rpm for your os/arch from the [releases page](https://github.com/lingrino/vaku/releases).

## Usage

Vaku CLI documentation can be found on the command line using either `vaku help [cmd]` or `vaku [cmd] --help`. The same documentation is also available in markdown form in the [docs/cli](docs/cli/vaku.md) folder.

## API

Documentation for the Vaku API is on [pkg.go.dev](https://pkg.go.dev/github.com/lingrino/vaku/v2/api).

## Contributing

Suggestions and contributions of all kinds are welcome! If there is functionality you would like to see in Vaku please open an Issue or Pull Request and I will be sure to address it.

## Tests

Vaku is well tested and uses only the standard go testing tools.

```shell
$ go test -cover -race ./...
ok github.com/lingrino/vaku/v2 0.095s coverage: 100.0% of statements
ok github.com/lingrino/vaku/v2/api 12.065s coverage: 100.0% of statements
ok github.com/lingrino/vaku/v2/cmd 0.168s coverage: 100.0% of statements
```