ember-property-upgrade

Ember Property Migration Tool

Simple tool for migrating computed properties (used with .property()) from syntax deprecated in Ember 3.9.

Installation

# With NPM
npm install ember-property-upgrade --save

# With Yarn
yarn add ember-property-upgrade

Usage

After installation a CLI is available in your project.

./node_modules/.bin/ember-property-upgrade [filesGlob] [options] --help

• [filesGlob] - glob expression, which points to files, e.g. 'src/**/*.js'
• [options] - defined in Options section

Alternatively you can install module globally and access it via alias ember-property-upgrade.

How it works

This tool helps with smooth migration to new computed property syntax. Simply run the CLI and you are done!

By default ember-property-upgrade doesn't format transformed code. To run auto-format the code use --format=true when running CLI (see Options for more details).

Before

const Person = EmberObject.extend({
  fullName: computed(function() {
    return `${this.firstName} ${this.lastName}`;
  }).property('firstName', 'lastName'),
 
  isYoung: Ember.computed(function() {
    return this.age < 50;
  }).property('age'),
 
  hasFriends: function() {
    return this.friends.length > 0;
  }.property('friends'),
});

After

const Person = EmberObject.extend({
  fullName: computed('firstName', 'lastName', function() {
    return `${this.firstName} ${this.lastName}`;
  }),
 
  isYoung: Ember.computed('age', function() {
    return this.age < 50;
  }),
  
  hasFriends: Ember.computed('friends', function() {
    return this.friends.length > 0;
  }),
});

Options

Option	Type	Description	Default
--format	Boolean	Enable auto formatting after code parsing	false
--prettier-config-file	String	Path to Prettier config file (accepts JS and JSON files)
--prettier-config	String	Prettier config as JSON string
--framework-pkg	String	Name of Ember's import alias	'Ember'
--computed-fn-name	String	Name of computed property function name	'computed'

Usage without CLI

Migration tool can be used directly in Node.js environment.

const { transform } = require('ember-property-upgrade');
 
// or using ES modules
 
import { transform } from 'ember-property-upgrade';

Usage

// Transforming the code
// input {String} - code input
// options {TransformOptions} - options for parser
 
const parsedCode = transform(input, options);

License

Created by Mirosław Ciastek. Released under the MIT License.