DIR : /home/kozerus/public_html/pn/uize/site-source/js/Uize/Build/UpdateCopyrightNotices.js

/home/kozerus/public_html/pn/uize/site-source/js/Uize/Build

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Build.UpdateCopyrightNotices Package
|   /    / /    |
|  /    / /  /| |    ONLINE : http://www.uize.com
| /____/ /__/_| | COPYRIGHT : (c)2011-2016 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://www.uize.com/license.html
*/

/* Module Meta Data
	type: Package
	importance: 1
	codeCompleteness: 100
	docCompleteness: 4
*/

/*?
	Introduction
		The =Uize.Build.UpdateCopyrightNotices= package provides a way to recurse folder structures and update the copyright notices for all JavaScript (.js) files to cover the current year.

		*DEVELOPERS:* `Chris van Rensburg`
*/

Uize.module ({
	name:'Uize.Build.UpdateCopyrightNotices',
	required:'Uize.Build.Util',
	builder:function () {
		'use strict';

		/*** General Variables ***/
			var
				_copyrightNoticeRegExp = /\(c\)\s*\d{4}(?:\s*-\s*(\d{4}))?/i,
				_copyrightNoticeEndYearRegExp = /(-\s*)(\d{4})/
			;

		return Uize.package ({
			perform:function (_params) {
				var _thisYear = (new Date).getFullYear ();
				Uize.Build.Util.buildFiles ({
					targetFolderPathCreator:function (_folderPath) {
						return _folderPath;
					},
					targetFilenameCreator:function (_sourceFileName) {
						return /\.(js|jst)$/.test (_sourceFileName) ? _sourceFileName : null;
					},
					fileBuilder:function (_sourceFileName,_sourceFileText) {
						var _copyrightNoticeMatch = _sourceFileText.match (_copyrightNoticeRegExp);
						if (_copyrightNoticeMatch) {
							var _oldCopyrightNotice = _copyrightNoticeMatch [0];
							if (_oldCopyrightNotice == '(c)' + _thisYear) {
								_copyrightNoticeMatch = null;
							} else {
								var
									_endYearMatch = _oldCopyrightNotice.match (_copyrightNoticeEndYearRegExp),
									_newCopyrightNotice = _endYearMatch
										? _oldCopyrightNotice.replace (_copyrightNoticeEndYearRegExp,'$1' + _thisYear)
										: _oldCopyrightNotice + '-' + _thisYear,
									_updatedaSourceFileText =
										_sourceFileText.replace (_oldCopyrightNotice,_newCopyrightNotice)
								;
							}
						}
						return (
							_copyrightNoticeMatch &&
							_updatedaSourceFileText != _sourceFileText
								? {
									outputText:_updatedaSourceFileText,
									logDetails:
										'\t\tCopyright Notice Updated:\n' +
										'\t\t\tWAS: ' + _oldCopyrightNotice + '\n' +
										'\t\t\tNOW: ' + _newCopyrightNotice + '\n'
								}
								: {logDetails:'\t\tFILE ALREADY OK\n'}
						);
					},
					alwaysBuild:true,
					rootFolderPath:_params.sourcePath,
					logFilePath:_params.logFilePath
				});
			}
		});
	}
});