From cbbefed99a1a003a32555dcf124080ca0454a40d Mon Sep 17 00:00:00 2001 From: Chris Lenz Date: Mon, 14 Sep 2026 11:32:16 +0200 Subject: [PATCH 1/9] feat: implement rtb-buddy --- README.adoc | 96 +++++++++++++++++++ cmd/rtb-buddy/README.adoc | 131 ++++++++++++++++++++++++++ cmd/rtb-buddy/cmd/apigw.go | 16 ++++ cmd/rtb-buddy/cmd/apigw/flags.go | 22 +++++ cmd/rtb-buddy/cmd/apigw/generate.go | 84 +++++++++++++++++ cmd/rtb-buddy/cmd/apigw/inspect.go | 95 +++++++++++++++++++ cmd/rtb-buddy/cmd/root.go | 17 ++++ cmd/rtb-buddy/cmd/utils/jwks.go | 66 +++++++++++++ cmd/rtb-buddy/cmd/utils/token.go | 139 ++++++++++++++++++++++++++++ cmd/rtb-buddy/cmd/version.go | 43 +++++++++ cmd/rtb-buddy/config/version.go | 4 + cmd/rtb-buddy/main.go | 18 ++++ 12 files changed, 731 insertions(+) create mode 100644 README.adoc create mode 100644 cmd/rtb-buddy/README.adoc create mode 100644 cmd/rtb-buddy/cmd/apigw.go create mode 100644 cmd/rtb-buddy/cmd/apigw/flags.go create mode 100644 cmd/rtb-buddy/cmd/apigw/generate.go create mode 100644 cmd/rtb-buddy/cmd/apigw/inspect.go create mode 100644 cmd/rtb-buddy/cmd/root.go create mode 100644 cmd/rtb-buddy/cmd/utils/jwks.go create mode 100644 cmd/rtb-buddy/cmd/utils/token.go create mode 100644 cmd/rtb-buddy/cmd/version.go create mode 100644 cmd/rtb-buddy/config/version.go create mode 100644 cmd/rtb-buddy/main.go diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..4b8cc23 --- /dev/null +++ b/README.adoc @@ -0,0 +1,96 @@ += rtbrick/tools +:toc: left +:toclevels: 3 +:sectnums: +:source-highlighter: rouge +:icons: font +:experimental: + +// Badges +image:https://img.shields.io/badge/license-BSD_3--Clause-blue.svg[License] +image:https://img.shields.io/badge/go-1.27+-00ADD8.svg[Go Version] +image:https://img.shields.io/badge/module-github.com%2Frtbrick%2Ftools-green.svg[Module] + +== Overview + +`rtbrick/tools` is a **collection of CLI tools** for the RtBrick platform. + +== Tools + +| Tool | Description | +|------|-------------| +| `rtb-buddy` | Multipurpose helper tool for the RtBrick fullstack. See link:cmd/rtb-buddy/README.adoc[documentation]. | + +== Development + +=== Prerequisites + +* Go 1.27+ +* Git +* https://golangci-lint.run/[golangci-lint] (optional, for `make lint`) + +=== Make Targets + +[source,sh] +---- +make build # Build the rtb-buddy binary +make test # Run all tests +make fmt # Format source code +make lint # Run golangci-lint +make vet # Run go vet +make clean # Remove built binaries +---- + +== Contributing + +We welcome contributions! Please follow these guidelines: + +=== Reporting Issues + +* Search existing issues first to avoid duplicates +* Use the issue template if available +* Include: steps to reproduce, expected vs actual behavior, environment + +=== Pull Requests + +1. Fork the repository +2. Create a feature branch: `git checkout -b feature/my-change` +3. Make your changes with clear, focused commits +4. Run `make fmt` and `make lint` before committing +5. Add tests for new functionality +6. Open a PR with a descriptive title and description + +=== Code Style + +* Follow standard Go conventions (`gofmt`, `golint`) +* Keep functions small and focused +* Document exported types and functions with Go doc comments +* Update documentation when behavior changes + +=== Commit Messages + +Use conventional commits format: + +[source,sh] +---- +(): + + + +