Merge pull request #1 from cloudfoundry-community/master

Sync to upstream

Author: krutten

LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2022    Stark & Wayne
+Copyright (c) 2023-present Cloud Foundry Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,42 +1,56 @@
-# Stark & Wayne's Homebrew Tap & APT Repository
+# CF Community Homebrew Tap & APT Repository
 
 Homebrew Tap & Debian Packages for useful BOSH / Cloud Foundry / Kubernetes
-utilities. Some are software we've written, others are community tools we've
-found valuable in day-to-day operations with CF and Kubernetes.
+utilities. These were initially created by Stark & Wayne and contains some
+software they had written, and other community tools that have been found
+valuable in day-to-day operations with CF and Kubernetes.
 
 ## Homebrew Tap
 
 Tap the formula repository:
 ```plain
-brew tap starkandwayne/cf
+brew tap cloudfoundry-community/cf
 ```
 
 
 Current software offered:
 
 | Package | Description | Author | Source |
 | ------- | ----------- | ------ | ------ |
-eden      | CLI tool to interact with any Open Service Broker API | Stark & Wayne | [starkandwayne/eden](https://github.com/starkandwayne/eden)
-genesis   | BOSH Deployment Paradigm | Stark & Wayne | [starkandwayne/genesis](https://github.com/starkandwayne/genesis)
-gotcha    | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic | Stark & Wayne | [starkandwayne/gotcha](https://github.com/starkandwayne/gotcha)
-govc      | vSphere CLI built on top of govmomi | VMWare | [vmware/govmomi](https://github.com/vmware/govmomi)
-kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB | Stark & Wayne | [starkandwayne/kafka-service-broker](https://github.com/starkandwayne/kafka-service-broker)
-quaa      | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | [quaa](https://github.com/starkandwayne/quaa)
-riff      | CLI tool that helps developers build and run functions using Knative | Pivotal | [projectriff/riff](https://github.com/projectriff/riff)
-safe      | CLI tool to interact with a Vault server | Stark & Wayne | [starkandwayne/safe](https://github.com/starkandwayne/safe)
-shield    | CLI tool to interact with SHIELD, a data protection offering | Stark & Wayne | [starkandwayne/shield](https://github.com/starkandwayne/shield)
-spruce    | General purpose YAML & JSON merging tool | geoffranks et al. | [geoffranks/spruce](https://github.com/geoffranks/spruce)
-uaa-cli   | Experimental CLI for UAA written in Golang | Various | [cloudfoundry-community/uaa-cli](https://github.com/cloudfoundry-community/uaa-cli)
+eden      | CLI tool to interact with any Open Service Broker API                | Stark & Wayne     | [starkandwayne/eden][eden]
+genesis   | BOSH Deployment Paradigm                                             | Stark & Wayne     | [starkandwayne/genesis][genesis]
+gotcha    | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic  | Stark & Wayne     | [starkandwayne/gotcha][gotcha]
+govc      | vSphere CLI built on top of govmomi                                  | VMWare            | [vmware/govmomi][govmomi]
+kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB             | Stark & Wayne     | [starkandwayne/kafka-service-broker][kafka_svc_bkr]
+quaa      | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | [quaa][quaa]
+riff      | CLI tool that helps developers build and run functions using Knative | Pivotal           | [projectriff/riff][riff]
+safe      | CLI tool to interact with a Vault server                             | Stark & Wayne     | [starkandwayne/safe][safe]
+shield    | CLI tool to interact with SHIELD, a data protection offering         | Stark & Wayne     | [starkandwayne/shield][shield]
+spruce    | General purpose YAML & JSON merging tool                             | geoffranks et al. | [geoffranks/spruce][spruce]
+uaa-cli   | Experimental CLI for UAA written in Golang                           | Various           | [cloudfoundry-community/uaa-cli][uaa_cli]
+
+[eden]: https://github.com/starkandwayne/eden
+[genesis]: https://github.com/starkandwayne/genesis
+[gotcha]: https://github.com/starkandwayne/gotcha
+[govmomi]: https://github.com/vmware/govmomi
+[kafka_svc_bkr]: https://github.com/starkandwayne/kafka-service-broker
+[quaa]: https://github.com/starkandwayne/quaa
+[riff]: https://github.com/projectriff/riff
+[safe]: https://github.com/starkandwayne/safe
+[shield]: https://github.com/starkandwayne/shield
+[spruce]: https://github.com/geoffranks/spruce
+[uaa_cli]: https://github.com/cloudfoundry-community/uaa-cli
 
 To install a package from our tap, run:
 
-`brew install starkandwayne/cf/<package>`, e.g. `brew install starkandwayne/cf/safe`
+`brew install cloudfoundry-community/cf/<package>`, e.g. `brew install cloudfoundry-community/cf/safe`
 
 _Please note that while some of the above software is provided by other
 formulas, we only support installations from our tap. Other taps contain
 mismatched dependency versions which outright break some of our software.
-Please make sure you prefix package names with `starkandwayne/cf/<package>`
-to avoid installing an unsupported version._
+Please make sure you prefix package names with
+`cloudfoundry-community/cf/<package>` to avoid installing an unsupported
+version._
 
 ## Debian packages
 
@@ -54,36 +68,53 @@ repository, and update your cache.
 
 The following packages are provided by the APT repository:
 
-| Package | Description | Author | Source |
-| ------- | ----------- | ------ | ------ |
-bosh-cli  | CLI tool to interact with a BOSH director | Cloudfoundry | [cloudfoundry/bosh-cli](https://github.com/cloudfoundry/bosh-cli)
-bosh-bootloader | CLI tool for standing up a BOSH director | Cloudfoundry | [cloudfoundry/bosh-bootloader](https://github.com/cloudfoundry/bosh-bootloader)
-eden      | CLI tool to interact with any Open Service Broker API | Stark & Wayne | [starkandwayne/eden](https://github.com/starkandwayne/eden)
-certstrap | Tools to bootstrap CAs, certificate requests, and signed certificates. | Square | [square/certstrap](https://github.com/square/certstrap)
-cf-cli    | [currently v6] CLI tool to interact with the Cloudfoundry API | Cloudfoundry | [cloudfoundry/cli](https://github.com/cloudfoundry/cli)
-cf6-cli    | v6 CLI tool to interact with the Cloudfoundry API | Cloudfoundry | [cloudfoundry/cli](https://github.com/cloudfoundry/cli)
-cf7-cli    | v7 beta CLI tool to interact with the Cloudfoundry API | Cloudfoundry | [cloudfoundry/cli](https://github.com/cloudfoundry/cli)
-credhub-cli | CLI tool to interact with a CredHub server | Cloudfoundry | [cloudfoundry-community/credhub-cli](https://github.com/cloudfoundry-incubator/credhub-cli)
-direnv    | Environment switcher for the shell | direnv | [direnv/direnv](https://github.com/direnv/direnv)
-genesis   | BOSH Deployment Paradigm | Stark & Wayne | [starkandwayne/genesis](https://github.com/starkandwayne/genesis)
-gotcha    | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic | Stark & Wayne | [starkandwayne/gotcha](https://github.com/starkandwayne/gotcha)
-govc      | vSphere CLI built on top of govmomi | VMWare | [vmware/govmomi](https://github.com/vmware/govmomi)
-hub       | CLI tool that wraps git in order to extend it with extra features | GitHub | [github/hub](https://github.com/github/hub)
-install-debs-in-order | Install Debian packages in order | Stark & Wayne | [starkandwayne/install-debs-in-order](https://github.com/starkandwayne/install-debs-in-order)
-jq        | Command-line JSON processor, like `sed` for JSON. | Stedolan | [stedolan/jq](https://github.com/stedolan/jq)
-kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB | Stark & Wayne | [starkandwayne/kafka-service-broker](https://github.com/starkandwayne/kafka-service-broker)
-om        | CLI tool to deploy products with Ops Manager | Pivotal | [pivotal-cf/om](https://github.com/pivotal-cf/om)
-pivnet-cli | CLI tool to interact with the Pivotal Network | Pivotal | [pivotal-cf/pivnet-cli](https://github.com/pivotal-cf/pivnet-cli)
-quaa      | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | [quaa](https://github.com/starkandwayne/quaa)
-riff      | CLI tool that helps developers build and run functions using Knative | Pivotal | [projectriff/riff](https://github.com/projectriff/riff)
-safe      | CLI tool to interact with a Vault server | Stark & Wayne | [starkandwayne/safe](https://github.com/starkandwayne/safe)
-shield    | CLI tool to interact with SHIELD, a data protection offering | Stark & Wayne | [starkandwayne/shield](https://github.com/starkandwayne/shield)
-spruce    | General purpose YAML & JSON merging tool | geoffranks et al. | [geoffranks/spruce](https://github.com/geoffranks/spruce)
-terraform | Tool for building, changing, and combining infrastructure safely | HashiCorp | [hashicorp/terraform](https://github.com/hashicorp/terraform)
-uaa-cli   | Experimental CLI for UAA written in Golang | Various | [cloudfoundry-community/uaa-cli](https://github.com/cloudfoundry-community/uaa-cli)
-vault     | Secrets management, encryption as a service, and privileged access management | HashiCorp | [hashicorp/vault](https://github.com/hashicorp/vault)
-aliyun-cli | Alibaba Cloud CLI | Alibaba Cloud | [aliyun/aliyun-cli](https://github.com/aliyun/aliyun-cli)
-minica | MiniCA | Jacob Hoffman-Andrews | [jsha/minica](https://github.com/jsha/minica)
+|  Package  | Description | Author | Source |
+| --------- | ----------- | ------ | ------ |
+bosh-cli    | CLI tool to interact with a BOSH director                                   | Cloudfoundry  | [cloudfoundry/bosh-cli][bosh_cli]
+bosh-bootloader | CLI tool for standing up a BOSH director                                | Cloudfoundry  | [cloudfoundry/bosh-bootloader][bbl]
+eden        | CLI tool to interact with any Open Service Broker API                       | Stark & Wayne | [starkandwayne/eden][eden]
+certstrap   | Tools to bootstrap CAs, certificate requests, and signed certificates.      | Square        | [square/certstrap][certstrap]
+cf-cli      | [currently v6, PRs welcome] CLI tool to interact with the Cloudfoundry API  | Cloudfoundry  | [cloudfoundry/cli][cf_cli]
+cf6-cli     | legacy v6 CLI tool to interact with the Cloudfoundry API                    | Cloudfoundry  | [cloudfoundry/cli][cf_cli]
+cf7-cli     | v7 CLI tool to interact with the Cloudfoundry API                           | Cloudfoundry  | [cloudfoundry/cli][cf_cli]
+~~cf8-cli~~ | v8 CLI tool is not yet provided, PRs are welcome                            | Cloudfoundry  | [cloudfoundry/cli][cf_cli]
+credhub-cli | CLI tool to interact with a CredHub server                                  | Cloudfoundry  | [cloudfoundry-community/credhub-cli][credhub_cli]
+direnv      | Environment switcher for the shell                                          | direnv        | [direnv/direnv][direnv]
+genesis     | BOSH Deployment Paradigm                                                    | Stark & Wayne | [starkandwayne/genesis][genesis]
+gotcha      | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic         | Stark & Wayne | [starkandwayne/gotcha][gotcha]
+govc        | vSphere CLI built on top of govmomi                                         | VMWare        | [vmware/govmomi][govmomi]
+hub         | CLI tool that wraps git in order to extend it with extra features           | GitHub        | [github/hub][hub]
+install-debs-in-order | Install Debian packages in order                                  | Stark & Wayne | [starkandwayne/install-debs-in-order][debs_in_order]
+jq          | Command-line JSON processor, like `sed` for JSON.                           | Stedolan      | [stedolan/jq][jq]
+kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB                      | Stark & Wayne | [starkandwayne/kafka-service-broker][kafka_svc_bkr]
+om          | CLI tool to deploy products with Ops Manager                                | Pivotal       | [pivotal-cf/om][om]
+pivnet-cli  | CLI tool to interact with the Pivotal Network                               | Pivotal       | [pivotal-cf/pivnet-cli][pivnet]
+quaa        | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | [quaa][quaa]
+riff        | CLI tool that helps developers build and run functions using Knative          | Pivotal       | [projectriff/riff][riff]
+safe        | CLI tool to interact with a Vault server                                      | Stark & Wayne | [starkandwayne/safe][safe]
+shield      | CLI tool to interact with SHIELD, a data protection offering                  | Stark & Wayne | [starkandwayne/shield][shield]
+spruce      | General purpose YAML & JSON merging tool                                  | geoffranks et al. | [geoffranks/spruce][spruce]
+terraform   | Tool for building, changing, and combining infrastructure safely              | HashiCorp     | [hashicorp/terraform][terraform]
+uaa-cli     | Experimental CLI for UAA written in Golang                                    | Various       | [cloudfoundry-community/uaa-cli][uaa_cli]
+vault       | Secrets management, encryption as a service, and privileged access management | HashiCorp     | [hashicorp/vault][vault]
+aliyun-cli  | Alibaba Cloud CLI                                                   | Alibaba Cloud           | [aliyun/aliyun-cli][alicli]
+minica      | MiniCA                                                              | Jacob Hoffman-Andrews   | [jsha/minica][minica]
+
+[bosh_cli]: https://github.com/cloudfoundry/bosh-cli
+[bbl]: https://github.com/cloudfoundry/bosh-bootloader
+[certstrap]: https://github.com/square/certstrap
+[cf_cli]: https://github.com/cloudfoundry
+[credhub_cli]: https://github.com/cloudfoundry-incubator/credhub-cli
+[direnv]: https://github.com/direnv/direnv
+[hub]: https://github.com/github/hub
+[debs_in_order]: https://github.com/starkandwayne/install-debs-in-order
+[jq]: https://github.com/stedolan/jq
+[om]: https://github.com/pivotal-cf/om
+[pivnet]: https://github.com/pivotal-cf/pivnet-cli
+[terraform]: https://github.com/hashicorp/terraform
+[vault]: https://github.com/hashicorp/vault
+[alicli]: https://github.com/aliyun/aliyun-cli
+[minica]: https://github.com/jsha/minica
 
 To update the static site's index.html, run: