JSPM – ember-cli@2.2.0-beta.1

Package Exports

ember-cli
ember-cli/blueprints/controller
ember-cli/blueprints/model
ember-cli/blueprints/route-addon
ember-cli/blueprints/route-test
ember-cli/blueprints/serializer-test
ember-cli/blueprints/service
ember-cli/blueprints/service-test
ember-cli/blueprints/template
ember-cli/blueprints/test-helper
ember-cli/blueprints/transform
ember-cli/blueprints/transform-test
ember-cli/blueprints/util
ember-cli/blueprints/util-test
ember-cli/blueprints/view
ember-cli/blueprints/view-test
ember-cli/lib/broccoli/ember-addon
ember-cli/lib/broccoli/ember-app
ember-cli/lib/cli
ember-cli/lib/cli/cli
ember-cli/lib/cli/cli.js
ember-cli/lib/cli/index
ember-cli/lib/cli/lookup-command
ember-cli/lib/commands/build
ember-cli/lib/commands/generate
ember-cli/lib/commands/init
ember-cli/lib/commands/new
ember-cli/lib/commands/serve
ember-cli/lib/commands/test
ember-cli/lib/errors/silent
ember-cli/lib/ext/promise
ember-cli/lib/models/addon
ember-cli/lib/models/blueprint
ember-cli/lib/models/builder
ember-cli/lib/models/command
ember-cli/lib/models/command.js
ember-cli/lib/models/file-info
ember-cli/lib/models/project
ember-cli/lib/models/project.js
ember-cli/lib/models/server-watcher
ember-cli/lib/models/task
ember-cli/lib/models/task.js
ember-cli/lib/models/watcher
ember-cli/lib/tasks/build
ember-cli/lib/tasks/build-watch
ember-cli/lib/tasks/create-and-step-into-directory
ember-cli/lib/tasks/git-init
ember-cli/lib/tasks/install-blueprint
ember-cli/lib/tasks/npm-install
ember-cli/lib/tasks/npm-task
ember-cli/lib/tasks/server/express-server
ember-cli/lib/tasks/server/livereload-server
ember-cli/lib/ui
ember-cli/lib/utilities/normalize-blueprint-option
ember-cli/lib/utilities/require-as-hash
ember-cli/lib/utilities/string
ember-cli/lib/utilities/string.js
ember-cli/lib/utilities/valid-project-name
ember-cli/lib/utilities/windows-admin
ember-cli/tests/helpers/conf
ember-cli/tests/helpers/ember
ember-cli/tests/helpers/mock-analytics
ember-cli/tests/helpers/mock-project
ember-cli/tests/helpers/mock-ui

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ember-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ember-cli

The Ember.js command line utility.

Supports node 0.12.x and npm 2.7.x and 3.x.

Community

irc: #ember-cli on freenode
issues: ember-cli/issues
website: ember-cli.com

Project Elements

Additional components of this project that are used at runtime in your application:

Development Hints

Working with master

git clone https://github.com/ember-cli/ember-cli.git
cd ember-cli
npm link

npm link is very similar to npm install -g except that instead of downloading the package from the repo the just cloned ember-cli/ folder becomes the global package. Any changes to the files in the ember-cli/ folder will immediately affect the global ember-cli package.

Now you can use ember-cli via the command line:

ember new foo
cd foo
npm link ember-cli
ember server

npm link ember-cli is needed because by default the globally installed ember-cli just loads the local ember-cli from the project. npm link ember-cli symlinks the global ember-cli package to the local ember-cli package. Now the ember-cli you cloned before is in three places: The folder you cloned it into, npm's folder where it stores global packages and the ember-cli project you just created.

If you upgrade an app running against Ember CLI master you will need to re-link to your checkout of Ember CLI by running npm link ember-cli in your project again.

Please read the official npm-link documentation and the npm-link cheatsheet for more information.

Working with the tests

Use npm test to run the tests (Runs only fast tests).

For a full test run which includes some very slow acceptance tests, please run: npm run test-all. Please note, this is what travis runs.

To exclude a test or test suite append a .skip to it() or describe() respectively (e.g. it.skip(...)). To focus on a certain test or test suite append .only.

The default test suite includes JSHint or it can be run on it's own with npm test jshint.

Please read the official mocha documentation for more information.

Problems

When running ember cli it could happen that a lack of file watches can occur. You will get an error message like:

Serving on http://localhost:4200
watch ENOSPC
Error: watch ENOSPC
    at errnoException (fs.js:1019:11)
    at FSWatcher.start (fs.js:1051:11)
  ...

This problem will be corrected in future releases. The following line is a workaround to get the server up and running until this problem is fixed. See Issue 1054.

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

For Arch Linux or Manjaro Linux, in order for the parameters to be loaded at boot, the kernel sysctl parameters have to be saved in a drop-in directory instead of sysctl.conf.

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.d/99-sysctl.conf && sudo sysctl --system

Why is CI broken?

If all pull requests are breaking on the same issue, we likely have a dependency that updated and broke our CI. This app can tell you which packages updated.

Inline Documentation

Use npm run docs to build HTML and JSON documentation with YUIDoc and place it in docs/build/. Please help by improving this documentation.

Contribution

See CONTRIBUTING.md

Upgrading

Programmatic Access

You can programmatically access the CLI from your node application.

Create a new node app npm init
Install the cli npm install ember-cli -save
Create index.js
Use the cli

var cli = require("ember-cli/lib/cli");
cli({
    inputStream: process.stdin,
    outputStream: process.stdout,
    cliArgs: ['help']
}).then(function(exitCode) {

});

Run your app with node . and it should execute the ember help command

License

ember-cli is MIT Licensed.