https://github.com/stefanpenner/ember-console

experimental node console for your ember app (fastboot capable ember apps only)
https://github.com/stefanpenner/ember-console

Last synced: 17 days ago
JSON representation

experimental node console for your ember app (fastboot capable ember apps only)

• Host: GitHub
• URL: https://github.com/stefanpenner/ember-console
• Owner: stefanpenner
• License: mit
• Created: 2017-05-31T06:25:50.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-08-18T05:04:40.000Z (about 7 years ago)
• Last Synced: 2024-10-17T18:12:35.387Z (19 days ago)
• Language: JavaScript
• Homepage:
• Size: 85.9 KB
• Stars: 38
• Watchers: 5
• Forks: 3
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# ember-console

[![Build Status](https://travis-ci.org/stefanpenner/ember-console.svg?branch=master)](https://travis-ci.org/stefanpenner/ember-console)

[![Build status](https://ci.appveyor.com/api/projects/status/y315p6t4siiyicu6?svg=true)](https://ci.appveyor.com/project/embercli/ember-console)

get a console (REPL) to you fastboot capable ember-app

*WARNING: still experimental, but ideas/help is wanted!*

[![asciicast](https://asciinema.org/a/dec9qcufpk88w5ylamd4dy53x.png)](https://asciinema.org/a/dec9qcufpk88w5ylamd4dy53x) 

# Installation

```

yarn add ember-console

```

or

```

npm install ember-console

```

# Usage

1. ensure your app has `ember-cli-fastboot` >= `1.0.0-rc.1` installed and working

2. build your app `ember build`

3. run `ember console` and your app in `dist/` is started in fastboot, and a repl to it is opened.

Available repl commands:

* `.help` for repl specific commands

* `app`

  * `currentURL`

  * `routes`

  * `rootElement`

  * `lookup(fullName)`: enables looking up singletons, for example `lookup('router:mian')`

  * `reload()` reloads the app, if a new bulid has occured this can be used to reload new code.

  * `visit(path)` the fastboot `visit` helper, allowing you to manually navigate your app

  * `instance` the fastboot instance

  * `sandbox` the sandboxed global: for example `Object.keys(app.sandbox.require.entries)` will give you all the modules your app uses

** Bonus **

It is also possible to connect the console to a pre-built application (as long as it was built with fastboot)

```sh

ember build --output-path my-other-dist`

ember console --output-path my-pther-dist

```

[![asciicast](https://asciinema.org/a/874kex0jwo7xvuy62vqbzav13.png)](https://asciinema.org/a/874kex0jwo7xvuy62vqbzav13)

# Development

## Installation

* `git clone ` this repository

* `cd ember-console`

* `npm install`

## Running

* `ember serve`

* Visit your app at [http://localhost:4200](http://localhost:4200).

## Running Tests

* `npm test` (Runs `ember try:each` to test your addon against multiple Ember versions)

* `ember test`

* `ember test --server`

## Building

* `ember build`

For more information on using ember-cli, visit [https://ember-cli.com/](https://ember-cli.com/).