bower/lib/core/Package.js

var util = require('util');
var fs = require('fs');
var path = require('path');
var events = require('events');
var mout = require('mout');
var Q = require('q');
var tmp = require('tmp');
var UnitOfWork = require('./UnitOfWork');
var config = require('./config');
var createPackage;
var createError = require('../util/createError');

var Package = function (endpoint, options) {
    options = options || {};

    this._endpoint = endpoint;
    this._name = options.name;
    this._guessedName = !this.name;
    this._range = options.range || '*';
    this._unitOfWork = options.unitOfWork || new UnitOfWork();
    this._config = options.config || config;
};

util.inherits(Package, events.EventEmitter);

// -----------------

Package.prototype.getName = function () {
    return this._name;
};

Package.prototype.getEndpoint = function () {
    return this._endpoint;
};

Package.prototype.getRange = function () {
    return this._range;
};

Package.prototype.getTempDir = function () {
    return this._tempDir;
};

Package.prototype.resolve = function () {
    // Throw if already resolved
    if (this._resolved) {
        throw createError('Package is already resolved', 'EALREADYRES');
    }

    // 1st - Enqueue the package in the unit of work
    return this._unitOfWork.enqueue(this)
    .then(function (done) {
        // 2nd - Create temporary dir
        return this._createTempDir()
        // 3nd - Resolve self
        .then(this._resolveSelf.bind(this))
        // 4th - Read json
        .then(this._readJson.bind(this))
        // 5th - Parse json
        .then(this._parseJson.bind(this))
        // 6th - Mark as resolved & call done
        //       to inform the unit of work
        .then(function (dependencies) {
            this._resolved = true;
            done();
            return dependencies;
        }.bind(this), function (err) {
            this._resolveError = err;
            done();
            throw err;
        }.bind(this))
        // 7th - Resolve dependencies
        .then(this._resolveDependencies.bind(this));
    }.bind(this), function (err) {
        // If error is of a duplicate package,
        // copy everything from the resolved package (duplicate) to itself
        if (err.code === 'EDUPL') {
            mout.object.mixIn(this, err.pkg);
        } else {
            this._resolveError = err;
            throw err;
        }
    });
};

Package.prototype.getResolveError = function () {
    return this._resolveError;
};

Package.prototype.getJson = function () {
    this._assertResolved();
    return this._json;
};

Package.prototype.getDependencies = function () {
    this._assertResolved();
    return this._dependencies;
};

Package.prototype.install = function () {
    this._assertResolved();

    // TODO
};

// -----------------

Package.prototype._resolveSelf = function () {};

// -----------------


Package.prototype._createTempDir = function () {
    console.log('_createTempDir');

    // Resolved if cached
    if (this._tempDir) {
        return Q.fcall(this._tempDir);
    }

    return Q.nfcall(tmp.dir, {
        prefix: 'bower-' + this.name + '-',
        mode: parseInt('0777', 8) & (~process.umask())
    })
    .then(function (dir) {
        this._tempDir = dir;
        return dir;
    }.bind(this));
};

Package.prototype._readJson = function () {
    console.log('_readJson');

    // Resolve if cached
    if (this._json) {
        return Q.fcall(this._json);
    }

    var jsonFile;

    // Try bower.json
    jsonFile = path.join(this.getTempDir(), 'bower.json');
    return Q.nfcall(fs.readFile, jsonFile)
    // Try component.json
    .then(null, function (err) {
        if (err.code !== 'ENOENT') {
            throw err;
        }

        jsonFile = path.join(this.getTempDir(), 'component.json');
        return Q.nfcall(fs.readFile, jsonFile)
        // Issue a deprecation message if it exists
        .then(function (contents) {
            this.emit('warn', 'Package "' + this.name + '" is using the deprecated component.json file');
            return contents;
        }.bind(this));
    }.bind(this))
    // If we got the file contents, validate them
    .then(function (contents) {
        // TODO: change the validation to a separate module in the bower organization
        try {
            this._json = JSON.parse(contents);
            return this._json;
        } catch (e) {
            throw createError('Unable to parse "' + jsonFile + '" file', e.code, {
                details: e.message
            });
        }
    // Otherwise there was an error
    }.bind(this), function (err) {
        // If no json file was found, return one just with the name
        if (err.code === 'ENOENT') {
            this._json = { name: this.name };
            return this._json;
        }

        // If we got here, the error code is something else so we re-throw it
        throw err;
    }.bind(this));
};

Package.prototype._parseJson = function (json) {
    console.log('_parseJson');

    // Resolve if cached
    if (this._dependencies) {
        return Q.fcall(this._dependencies);
    }

    // Check if name defined in the json is different
    // If so and if the name was "guessed", assume the json name
    if (this._guessedName && json.name !== this.name) {
        this.name = json.name;
        this.emit('name_change', this.name);
    }

    // Handle ignore property, deleting all files from the temporary directory
    return Q.fcall(function () {
        // Delete all the files specified in the ignore from the temporary directory
        // TODO:
    }.bind(this))
    // Handle the dependencies property
    .then(function () {
        var key,
            promises = [];

        // Read the dependencies, creating a package for each one
        createPackage = createPackage || require('./createPackage');
        if (json.dependencies) {
            for (key in json.dependencies) {
                promises.push(createPackage(json.dependencies[key], { name: key, unitOfWork: this._unitOfWork }));
            }
        }

        // Resolve all the create packages promises
        return Q.all(promises).then(function (packages) {
            this._dependencies = packages;
            return packages;
        }.bind(this));
    });
};


Package.prototype._resolveDependencies = function (dependencies) {
    console.log('_resolveDependencies');

    var promises = dependencies.map(function (dep) {
        return dep.resolve();
    });

    return Q.all(promises);
};

Package.prototype._assertResolved = function () {
    if (!this._resolved) {
        throw createError('Package is not yet resolved', 'ENOTRES');
    }
};

module.exports = Package;