README
¶
Next Gen Heroku CLI
The Heroku CLI is used to manage Heroku apps from the command line.
For more about Heroku see https://www.heroku.com/home
To get started see https://devcenter.heroku.com/start
Overview
heroku-cli (also known as Toolbelt v4) is the next generation Heroku CLI. Currently, it is not feature complete with the existing CLI and not intended to be used standalone. It is used internally inside the existing Toolbelt v3 Ruby CLI for some commands.
The goals of this project were to make plugins more flexible, remove Ruby as a runtime dependency, and make the CLI faster.
We are in the process of migrating commands over, some you can try out include: heroku status
, heroku fork
, and heroku git:remote
.
Architecture
The v4 CLI is written both in Go and node. The core part of the CLI is this Go project and manages a node installation in ~/.heroku
. It handles taking in arguments, updating itself and node plugins, as well as some core commands like heroku login
.
Most commands are plugins. An example of one would be heroku-git. You can install it with heroku plugins:install
and use it with heroku git:remote
. When you install it, it uses npm to install the plugin into ~/.heroku/node_plugins/heroku-git
. Then, the commands become available to the v4 CLI.
We have shims in place for some commands inside the current v3 Toolbelt which will setup v4, install the plugin, and exec the command. Here is the shim for heroku-git.
Once we have plugins to replicate every command in the v3 Toolbelt, we will then ship this CLI standalone.
For more on developing plugins, read the blog announcement
Issues
For problems directly related to the CLI, add an issue on GitHub.
For other issues, submit a support ticket.
Documentation
¶
There is no documentation for this package.
Source Files
¶
Directories
¶
Path | Synopsis |
---|---|
Godeps
|
|
_workspace/src/github.com/jtolds/gls
Package gls implements goroutine-local storage.
|
Package gls implements goroutine-local storage. |
_workspace/src/github.com/smartystreets/assertions
Package assertions contains the implementations for all assertions which are referenced in goconvey's `convey` package (github.com/smartystreets/goconvey/convey) for use with the So(...) method.
|
Package assertions contains the implementations for all assertions which are referenced in goconvey's `convey` package (github.com/smartystreets/goconvey/convey) for use with the So(...) method. |
_workspace/src/github.com/smartystreets/assertions/should
package should is simply a rewording of the assertion functions in the assertions package.
|
package should is simply a rewording of the assertion functions in the assertions package. |
_workspace/src/github.com/smartystreets/goconvey/convey
Package convey contains all of the public-facing entry points to this project.
|
Package convey contains all of the public-facing entry points to this project. |
_workspace/src/github.com/smartystreets/goconvey/convey/gotest
Package gotest contains internal functionality.
|
Package gotest contains internal functionality. |
_workspace/src/github.com/smartystreets/goconvey/convey/reporting
Package reporting contains internal functionality related to console reporting and output.
|
Package reporting contains internal functionality related to console reporting and output. |
_workspace/src/golang.org/x/crypto/ssh/terminal
Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.
|
Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems. |
Package gode runs a sandboxed node installation to run node code and install npm packages.
|
Package gode runs a sandboxed node installation to run node code and install npm packages. |