No commit activity in last 3 years
No release in over 3 years
Extends rack-webconsole to allow switching between TorqueBox app runtimes.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

Torquebox::Webconsole

An extension to rack-webconsole that adds the ability to switch between application runtimes within TorqueBox.

Installation

Add this line to your application's Gemfile:

gem 'torquebox-webconsole'

Then follow the instructions for rack-webconsole, replacing any instances of require 'rack/webconsole' with require 'torquebox/webconsole'.

Note: don't add rack-webconsole to your Gemfile - torquebox-webconsole will bring it in for you, and currently uses a fork of rack-webconsole pending a pull request and release of the official gem.

Usage

Use it just like you would rack-console. When in the console, the following TorqueBox specific methods are available to you:

  • list_runtimes - returns an array of the available runtime names
  • current_runtime - returns the name of the runtime that the console is currently attached to
  • switch_runtime(name) - attaches the console to the named runtime
  • help - tells you about the above methods

The console will be attached to the web runtime by default, and you will only be able to list/attach to runtimes for the current application.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request