spec/cordova/prepare.spec.js

/**
    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
*/

var path = require('path');
var rewire = require('rewire');
var util = require('../../src/cordova/util');
var cordova_config = require('../../src/cordova/config');
var prepare = rewire('../../src/cordova/prepare');
var restore = require('../../src/cordova/restore-util');
var platforms = require('../../src/platforms/platforms');
var HooksRunner = require('../../src/hooks/HooksRunner');
var PlatformJson = require('cordova-common').PlatformJson;

var project_dir = '/some/path';

describe('cordova/prepare', function () {
    var platform_api_prepare_mock;
    var platform_api_add_mock;
    var platform_api_remove_mock;
    beforeEach(function () {
        platform_api_prepare_mock = jasmine.createSpy('prepare').and.returnValue(Promise.resolve());
        platform_api_add_mock = jasmine.createSpy('add').and.returnValue(Promise.resolve());
        platform_api_remove_mock = jasmine.createSpy('remove').and.returnValue(Promise.resolve());
        spyOn(platforms, 'getPlatformApi').and.callFake(function (platform, rootDir) {
            return {
                prepare: platform_api_prepare_mock,
                getPlatformInfo: jasmine.createSpy('getPlatformInfo').and.returnValue({
                    locations: {
                        www: path.join(project_dir, 'platforms', platform, 'www')
                    }
                }),
                removePlugin: platform_api_add_mock,
                addPlugin: platform_api_remove_mock
            };
        });
        spyOn(PlatformJson, 'load');
        spyOn(HooksRunner.prototype, 'fire').and.returnValue(Promise.resolve());
        spyOn(util, 'isCordova').and.returnValue(true);
    });

    describe('main method', function () {
        beforeEach(function () {
            spyOn(cordova_config, 'read').and.returnValue({});
            spyOn(restore, 'installPlatformsFromConfigXML').and.returnValue(Promise.resolve());
            spyOn(restore, 'installPluginsFromConfigXML').and.returnValue(Promise.resolve());
            spyOn(util, 'cdProjectRoot').and.returnValue(project_dir);
            spyOn(util, 'preProcessOptions').and.callFake(function (options) {
                var platforms = options.platforms || [];
                return { 'platforms': platforms };
            });
            spyOn(prepare, 'preparePlatforms').and.returnValue(Promise.resolve());
        });
        describe('failure', function () {
            it('should invoke util.preProcessOptions as preflight task checker, which, if fails, should trigger promise rejection and only fire the before_prepare hook', function () {
                util.preProcessOptions.and.callFake(function () {
                    throw new Error('preProcessOption error');
                });
                return prepare({}).then(function () {
                    fail('Expected promise to be rejected');
                }, function (err) {
                    expect(err).toEqual(jasmine.any(Error));
                    expect(err.message).toBe('preProcessOption error');
                    expect(HooksRunner.prototype.fire).toHaveBeenCalledWith('before_prepare', jasmine.any(Object));
                });
            });
            it('should invoke util.cdProjectRoot as a preflight task checker, which, if fails, should trigger a promise rejection and fire no hooks', function () {
                util.cdProjectRoot.and.callFake(function () {
                    throw new Error('cdProjectRoot error');
                });

                return prepare({}).then(function () {
                    fail('Expected promise to be rejected');
                }, function (err) {
                    expect(err).toEqual(jasmine.any(Error));
                    expect(err.message).toBe('cdProjectRoot error');
                    expect(HooksRunner.prototype.fire).not.toHaveBeenCalled();
                });
            });
        });

        describe('success', function () {
            it('should fire the before_prepare hook and provide platform and path information as arguments', function () {
                return prepare({}).then(function () {
                    expect(HooksRunner.prototype.fire).toHaveBeenCalledWith('before_prepare', jasmine.any(Object));
                });
            });
            it('should invoke restore module\'s installPlatformsFromConfigXML method', function () {
                return prepare({}).then(function () {
                    expect(restore.installPlatformsFromConfigXML).toHaveBeenCalled();
                });
            });
            it('should retrieve PlatformApi instances for each platform provided', function () {
                return prepare({ 'platforms': ['android', 'ios'] }).then(function () {
                    expect(platforms.getPlatformApi).toHaveBeenCalledTimes(4);
                    // expect(platforms.getPlatformApi).toHaveBeenCalledWith(['android', path.join('some','path','platforms','android')], ['ios', path.join('some','path','platforms','ios')], ['android'], ['ios']);
                    expect(platforms.getPlatformApi).toHaveBeenCalledWith('android', path.join('/', 'some', 'path', 'platforms', 'android'));
                    expect(platforms.getPlatformApi).toHaveBeenCalledWith('ios', path.join('/', 'some', 'path', 'platforms', 'ios'));
                    expect(platforms.getPlatformApi).toHaveBeenCalledWith('android');
                    expect(platforms.getPlatformApi).toHaveBeenCalledWith('ios');
                });
            });
            it('should invoke restore module\'s installPluginsFromConfigXML method', function () {
                return prepare({ platforms: [] }).then(function () {
                    expect(restore.installPluginsFromConfigXML).toHaveBeenCalled();
                });
            });
            it('should invoke preparePlatforms method, providing the appropriate platforms', function () {
                return prepare({ platforms: ['android'] }).then(function () {
                    expect(prepare.preparePlatforms).toHaveBeenCalledWith(['android'], '/some/path', jasmine.any(Object));
                });

            });
            it('should fire the after_prepare hook and provide platform and path information as arguments', function () {
                return prepare({ platforms: ['android'] }).then(function () {
                    expect(HooksRunner.prototype.fire).toHaveBeenCalledWith('after_prepare', jasmine.any(Object));
                });
            });
        });
    });

    describe('preparePlatforms helper method', function () {
        var cfg_parser_mock = function () {};
        var platform_munger_mock = function () {};
        var platform_munger_save_mock;
        beforeEach(function () {
            prepare.__set__('ConfigParser', cfg_parser_mock);
            platform_munger_save_mock = jasmine.createSpy('platform munger save mock');
            platform_munger_mock.prototype = jasmine.createSpyObj('platform munger prototype mock', ['add_config_changes']);
            platform_munger_mock.prototype.add_config_changes.and.returnValue({
                save_all: platform_munger_save_mock
            });
            prepare.__set__('PlatformMunger', platform_munger_mock);
            spyOn(util, 'projectConfig').and.returnValue(project_dir);
            spyOn(util, 'projectWww').and.returnValue(path.join(project_dir, 'www'));

        });
        it('should retrieve the platform API via getPlatformApi per platform provided, and invoke the prepare method from that API', function () {
            return prepare.preparePlatforms(['android'], project_dir, {}).then(function () {
                expect(platforms.getPlatformApi).toHaveBeenCalledWith('android');
                expect(platform_api_prepare_mock).toHaveBeenCalled();
            });
        });
        it('should handle config changes by invoking add_config_changes and save_all', function () {
            return prepare.preparePlatforms(['android'], project_dir, {}).then(function () {
                expect(platform_munger_mock.prototype.add_config_changes).toHaveBeenCalled();
                expect(platform_munger_save_mock).toHaveBeenCalled();
            });
        });
    });
});