Merge branch 'develop'

* develop: (34 commits)
  File: Merge misc/file into modules/file
  Select: create filter function
  DOM: modify getActiveComp function
  Add functions for working with settings
  Do not separate properties
  Select: add getting effects
  Select: add so you can write composition and property
  Select: make hasAllAttributes work with new grammar
  Grammar: Make StringLiterals more robust
  Restructure ui files
  Add smarter way to define container setters
  Define functions for setting container properties
  Add creating with objects demo
  Clean up adding elements
  Add createWindow function
  Fix eventhandlers not being added
  Replace Array.isArray with aeq function
  Change adding UI elements functions
  Demonstrate Treeview better
  Add UI Demo to Gulp
  ...

Author: runegan

lib/misc/file.js

@@ -148,6 +148,18 @@ aeq.file = aeq.extend({}, {
 		return filePathStr.substr(0, filePathStr.lastIndexOf('.'));
 	},
 
+	/**
+	 * Takes a file path or a file object, and returns a file object
+	 * allows functions to be flexible in whether they take a path vs file
+	 * @method
+	 * @memberof aeq
+	 * @param  {File|string} filePath String path to a file, or file object
+	 * @return {File}                 Resolved file object
+	 */
+	getFileObject: function(filePath) {
+		return aeq.isFile(filePath) ? filePath : new File(filePath);
+	},
+
 	/**
 	 * Gets target file by path or file object, or null if doesn't exist
 	 * @method
@@ -185,6 +197,18 @@ aeq.file = aeq.extend({}, {
 		return aeq.arrayEx(files);
 	},
 
+	/**
+	 * Takes a folder path or a folder object, and returns a folder object
+	 * allows functions to be flexible in whether they take a path vs folder
+	 * @method
+	 * @memberof aeq
+	 * @param  {Folder|string} folderPath String path to a folder, or folder object
+	 * @return {Folder}                   Resolved folder object
+	 */
+	getFolderObject: function(folderPath) {
+		return aeq.isFolder(folderPath) ? folderPath : new Folder(folderPath);
+	},
+
 	/**
 	 * Returns a folder, or null if it doesn't exist
 	 * @method
@@ -216,13 +240,81 @@ aeq.file = aeq.extend({}, {
 
 		return folder;
 	},
+
+	/**
+	 * Returns the contents of a specified file
+	 * @method
+	 * @memberof aeq
+	 * @param  {File|string} filePath    Path or file to read
+	 * @param  {string} [encoding=UTF-8] Encoding method
+	 * @return {string|null}             Contents of the file, or null if file doesn't exist
+	 */
+	readFile: function(filePath, encoding) {
+		var file = aeq.getFileObject(filePath),
+			contents;
+
+		encoding = setDefault(encoding, "UTF-8");
+
+		if (file.exists) {
+			if (File.isEncodingAvailable(encoding))
+				file.encoding = encoding;
+
+			file.open();
+			contents = file.read();
+			file.close();
+			return contents;
+		}
+		return null;
+	},
+
+	/**
+	 * Writes data to a file, returns file
+	 * @method
+	 * @memberof aeq
+	 * @param  {File|string} filePath              Path or file to write to
+	 * @param  {string}  contents                  Data to write to the file
+	 * @param  {object} [options]                  Options for writing file.
+	 * @param  {boolean} [options.overwrite=false] `true` if file should be overwritten if exists.
+	 * @param  {string} [options.encoding="UTF-8"] Encoding method.
+	 * @return {File|null}                         New file, or null if file was not written
+	 *                                             correctly or file exits and overwrite = false
+	 */
+	writeFile: function(filePath, contents, options) {
+		var file = aeq.getFileObject(filePath);
+		options = aeq.setDefault(options, {});
+
+		if (file.exists && options.overwrite === false) {
+			return null
+		}
+
+		if (!file.exists) {
+			aeq.file.ensureFolderExists(file.path);
+		}
+
+		if (!aeq.isNullOrUndefined(options.encoding) && File.isEncodingAvailable(options.encoding)) {
+			file.encoding = options.encoding;
+		}
+
+		file.open("w");
+		var success = file.write(contents);
+		file.close();
+
+		if (success)
+			return file;
+
+		return null;
+	}
 });
 
 // Function aliases
 aeq.pathSeparatorSymbol = aeq.file.pathSeparatorSymbol;
+aeq.getFileObject = aeq.file.getFileObject;
+aeq.getFolderObject = aeq.file.getFolderObject;
 aeq.getFile = aeq.file.get = aeq.file.getFile;
 aeq.getFiles = aeq.file.getFiles;
 aeq.getFolder = aeq.file.getFolder;
+aeq.readFile = aeq.file.readFile;
+aeq.writeFile = aeq.file.writeFile;
 
 return aeq;
 }(aeq || {}));