https://github.com/cloudfoundry/uaa-cli
CLI for UAA written in Go
https://github.com/cloudfoundry/uaa-cli
cloudfoundry experimental uaa
Last synced: 7 months ago
JSON representation
CLI for UAA written in Go
- Host: GitHub
- URL: https://github.com/cloudfoundry/uaa-cli
- Owner: cloudfoundry
- License: apache-2.0
- Created: 2017-08-29T21:04:45.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-06-06T11:57:19.000Z (8 months ago)
- Last Synced: 2025-06-14T00:03:20.271Z (8 months ago)
- Topics: cloudfoundry, experimental, uaa
- Language: Go
- Homepage:
- Size: 9.16 MB
- Stars: 21
- Watchers: 20
- Forks: 14
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UAA Command Line Interface
CLI for [UAA](https://github.com/cloudfoundry/uaa) written in golang. This is an alterntive to using uaac which is wirtten in Ruby. At this time it performs a limited subset of the features provided by the [uaac](https://github.com/cloudfoundry/cf-uaac) gem. The team plans to continue development on the golang CLI going forward, and once it's considered fully GA, intends to place it alongside uaac with a long-term intention of one day deprecating uaac.
### Goals
- To provide a CLI which can be easily installed in environments without a functioning Ruby setup
- To more closely conform to the style of other widely used CLIs in the CF ecosystem, e.g. the cf CLI. Commands should be of the form VERB-NOUN, similar to `cf delete-app`.
- To provide outputs that are machine-parseable whenever possible.
- To improve the quality of help strings and error messages so that users can self-diagnose problems and unblock themselves.
- To provide only the essential, highly used and/or required command options.
### Trying out the latest code
```
go get code.cloudfoundry.org/uaa-cli
cd $GOPATH/src/code.cloudfoundry.org/uaa-cli
make && make install
uaa -h
```
Or, install it using brew. It's been made available as part of the [cloudfoundry tap](https://github.com/cloudfoundry/homebrew-tap)
```
brew install cloudfoundry/tap/uaa-cli
```
## Development notes
### Setting up Go
If you don't have a working Go setup
```
brew update
brew install go
echo 'export GOPATH="$HOME/go"' >> ~/.bash_profile
echo 'export PATH="$GOPATH/bin:$PATH"' >> ~/.bash_profile
```
### Running the tests
```
cd $GOPATH/src/code.cloudfoundry.org/uaa-cli
ginkgo -r -randomizeAllSpecs -randomizeSuites
```