/ember.js

Ember.js - A JavaScript framework for creating ambitious web applications
  1. JavaScript 99.6%
  2. Other 0.4%
JavaScript Other
Find file
Latest commit b0801b7 Oct 18, 2016 @rwjblue rwjblue committed on GitHub Merge pull request #14238 from chadhietala/action-tests 
Add non-interactive {{action}} test
Permalink
Failed to load latest commit information.
bin Run chrome/firefox in Travis (not sauce). Sep 2, 2016
blueprints Remove JSHint directives from Mocha test blueprints Jun 18, 2016
config Bower: Fix "invalid-meta" warning Aug 31, 2016
generators [DOC] Update copyright year Feb 18, 2016
lib Create ember-utils package. Sep 12, 2016
node-tests Change ember.js test blueprints May 31, 2016
packages Merge pull request #14238 from chadhietala/action-tests Oct 18, 2016
scripts Improved File Size script Apr 22, 2012
server Allow `hidepassed` to be toggled. Apr 7, 2015
tests [BUGFIX beta] Only call attr hooks in FastBoot Sep 27, 2016
vendor/ember Add getOwner/setOwner shims Sep 25, 2016
.bowerrc Broccolify. May 13, 2014
.editorconfig Add EditorConfig file Jul 21, 2014
.gitattributes Adds .gitattributes file to remove any concerns about collaborators h… Apr 1, 2016
.gitignore Remove '*.swp' from .gitignore May 13, 2015
.jscsrc Enforce const usage in module scope only. Nov 4, 2015
.jshintrc Cleanup Ember.Test, Ember.testing, Ember.onerror May 4, 2016
.npmignore Add "ember-cli-blueprint-test-helpers" dev dependency Mar 6, 2016
.travis.yml Cache the caches to avoid some npm bizarreness when bumping packages. Sep 28, 2016
.watchmanconfig many build tool upgrades: Jun 7, 2015
CHANGELOG.md Update CHANGELOG for 2.9.0 Oct 18, 2016
CODE_OF_CONDUCT.md Add link to community guidelines as CODE_OF_CONDUCT.md. Jun 20, 2015
CONTRIBUTING.md [DOC] Make public two-week policy for closing issues Sep 28, 2016
FEATURES.md [FEATURE ember-testing-resume-test] Introduce resumeTest helper to co… Oct 7, 2016
LICENSE [DOC] Update copyright year Jan 15, 2016
README.md Center align readme intro section Oct 14, 2016
STYLEGUIDE.md Don't cache length property in for loops Apr 20, 2016
VERSION Post release version bump. Sep 8, 2016
bower.json [BUGFIX release] Bump router.js to v1.2.1. Sep 12, 2016
ember-cli-build.js [BUGFIX beta] Ensure feature flags are stripped Sep 28, 2016
ember-source.gemspec [BUGFIX beta] Remove handlebars from dependencies Dec 28, 2014
features.json [FEATURE ember-testing-resume-test] Introduce resumeTest helper to co… Oct 7, 2016
index.js Update index.js Oct 7, 2016
package.json Correct willDestroyElement hook timing Oct 14, 2016
testem.dist.json Run chrome/firefox in Travis (not sauce). Sep 2, 2016
testem.json create multiple tested files for each variation: Jul 7, 2015
testem.travis-browsers.js Run chrome/firefox in Travis (not sauce). Sep 2, 2016
yuidoc.json Create ember-utils package. Sep 12, 2016

README.md

Build Status Code Climate Build Status

Sauce Test Status

Ember.js is a Javascript framework that greatly reduces the time, effort and resources needed to build any web application. It is focused on making you, the developer, as productive as possible by doing all the common, repetitive, yet essential, tasks involved in most web development projects.

Ember.js also provides access to the most advanced features of Javascript, HTML and the Browser giving you everything you need to create your next killer web app.

Building Ember.js

  1. Ensure that Node.js and bower are installed.
  2. Run git clone https://github.com/emberjs/ember.js.git && cd ember.js.
  3. Run git config core.symlinks true to ensure that symlinks are enabled.
  4. Run git reset --hard HEAD to reset to HEAD with symlinks.
  5. Run npm install to ensure the required dependencies are installed.
  6. Run bower install to ensure required web dependencies are installed.
  7. Run npm run build to build Ember.js. The builds will be placed in the dist/ directory.

npm install troubleshooting

If you encounter a problem with downloading dependencies like:

npm ERR! registry error parsing json

consider upgrading npm with:

npm install -g npm@latest

You can find more information in Upgrading on *nix (OSX, Linux, etc.) npm wiki page.

Contribution

See CONTRIBUTING.md

How to Run Unit Tests

Pull requests should pass the Ember.js unit tests. Do the following to run these tests.

  1. Follow the setup steps listed above under Building Ember.js.

  2. To start the development server, run npm start.

  3. To run all tests, visit http://localhost:4200/.

  4. To test a specific package, visit http://localhost:4200/tests/index.html?package=PACKAGE_NAME. Replace PACKAGE_NAME with the name of the package you want to test. For example:

To test multiple packages, you can separate them with commas.

You can also pass jquery=VERSION in the test URL to test different versions of jQuery.

From the CLI

  1. Install phantomjs from http://phantomjs.org.

  2. Run npm test to run a basic test suite or run TEST_SUITE=all npm test to run a more comprehensive suite.

From ember-cli

  1. ember test --server

  2. Connect the browsers you want.

  3. If phantom didn't connect automatically, you can run ./bin/connect-phantom-to <optional-port>.

To run a specific browser, you can use the --launch flag

  • ember test --server --launch SL_Firefox_Current
  • ember test --launch SL_Firefox_Current
  • ember test --launch SL_Firefox_Current,PhantomJS

To test multiple launchers, you can separate them with commas.